{"info":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","description":"

Servicio de validación de datos de personas naturales y empresas de Ecuador. Las consultas son realizadas en tiempo real en el instante en el que usted la solicita, obteniendo información completa y verificada. www.webservices.ec

🔐 Autenticación

Todos los endpoints requieren un Bearer Token en el header Authorization.

Authorization: Bearer TU_TOKEN_AQUI\n\n

Puedes obtener tu token desde webservices.ec → API Tokens.

⚙️ Configuración

Importa esta colección en Postman
\n
Configura las variables:
\n
- base_url: https://webservices.ec
  \n
- token: Tu token de API personal
  \n
\n

💰 Precios por Consulta

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Endpoint	Costo
Cédula	$0.05
RUC	$0.04
RUC Lite	$0.05
SENESCYT	$0.10
Bachiller	$0.10
Placas	$0.08
WhatsApp Check	$0.02
SRI Comprobantes	$0.004/doc

📋 Permisos por Endpoint

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Endpoint	Permiso
`/api/cedula/{cedula}`	`api:cedula`
`/api/ruc/{ruc}`	`api:ruc`
`/api/ruclite/{ruc}`	`api:ruc_lite`
`/api/senescyt/{cedula}`	`api:senescyt`
`/api/bachiller/{cedula}`	`api:bachiller`
`/api/placas/{placa}`	`api:placas`
`/api/checkwhatsapp/{phone}`	`api:whatsapp_check_phone`
`/api/sri/comprobantes`	`api:sri_comprobantes`
`/api/tokens`	`api:create_tokens`

❌ Códigos de Error Comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Error	Descripción
401	Unauthenticated	Token inválido, expirado o no proporcionado
402	Insufficient Balance	Saldo insuficiente. Recargue en webservices.ec
403	Invalid ability provided	El token no tiene el permiso necesario para este endpoint
403	Forbidden	Acceso denegado por restricción de IP o permisos
404	Not Found	Identificación no encontrada en registros públicos
422	Validation Error	Parámetros inválidos o formato incorrecto
429	Query Limit Reached	El token alcanzó su límite de consultas
500	Server Error	Error interno del servicio público consultado

Ejemplo Error 401 - Token Inválido

{ \"message\": \"Unauthenticated.\" }\n\n

Ejemplo Error 402 - Saldo Insuficiente

{ \"data\": { \"error\": \"Saldo del paquete agotado para este token. Adquiera más saldo en webservices.ec\" } }\n\n

Ejemplo Error 402 - Sin Saldo Global

{ \"data\": { \"error\": \"No dispone de saldo suficiente para realizar esta consulta. Por favor recargue su saldo en la página de webservices.ec\" } }\n\n

Ejemplo Error 403 - Sin Permiso

HTTP 403 Forbidden - Invalid ability provided.\n\n

Ejemplo Error 429 - Límite de Consultas

{ \"data\": { \"error\": \"Este token ha alcanzado su límite de consultas (1100). Adquiera más consultas en la página de paquetes.\" } }\n\n

📞 Soporte

soporte@webservices.ec

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"12557860","collectionId":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","publishedId":"2sBXqGr2Jc","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"871eff"},"publishDate":"2026-04-26T00:32:40.000Z"},"item":[{"name":"Consultas Vehiculares","item":[{"name":"PLACAS - Consultar Vehículo","id":"94fba680-ebf0-4d0b-9f52-7f7bc0788371","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://webservices.ec/api/placas/ABC1234","description":"

Consulta de Placas

Información de un vehículo por su placa.

Parámetros URL

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`placa`	string	Placa del vehículo (ej: ABC1234)

Permiso: `api:placas` — Costo: $0.08

✅ Respuesta Exitosa (200)

{\n  \"data\": {\n    \"Placa:\": \"ABC1234\",\n    \"Marca:\": \"CHEVROLET\",\n    \"Modelo:\": \"AVEO FAMILY\",\n    \"Año:\": \"2018\",\n    \"Cilindraje:\": \"1500\",\n    \"Tipo:\": \"AUTOMOVIL\",\n    \"Color:\": \"BLANCO\",\n    \"País_de_Origen:\": \"COREA DEL SUR\",\n    \"Clase:\": \"AUTOMOVIL\",\n    \"Servicio:\": \"PARTICULAR\",\n    \"Estado:\": \"ACTIVO\"\n  }\n}\n

❌ Códigos de Error Comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Error	Descripción
401	Unauthenticated	Token inválido, expirado o no proporcionado
402	Insufficient Balance	Saldo insuficiente. Recargue en webservices.ec
403	Invalid ability provided	El token no tiene el permiso necesario para este endpoint
403	Forbidden	Acceso denegado por restricción de IP o permisos
404	Not Found	Identificación no encontrada en registros públicos
422	Validation Error	Parámetros inválidos o formato incorrecto
429	Query Limit Reached	El token alcanzó su límite de consultas
500	Server Error	Error interno del servicio público consultado

Ejemplo Error 401 - Token Inválido

{ \"message\": \"Unauthenticated.\" }\n

Ejemplo Error 402 - Saldo Insuficiente

{ \"data\": { \"error\": \"Saldo del paquete agotado para este token. Adquiera más saldo en webservices.ec\" } }\n

Ejemplo Error 402 - Sin Saldo Global

{ \"data\": { \"error\": \"No dispone de saldo suficiente para realizar esta consulta. Por favor recargue su saldo en la página de webservices.ec\" } }\n

Ejemplo Error 403 - Sin Permiso

HTTP 403 Forbidden - Invalid ability provided.\n

Ejemplo Error 429 - Límite de Consultas

{ \"data\": { \"error\": \"Este token ha alcanzado su límite de consultas (1100). Adquiera más consultas en la página de paquetes.\" } }\n

Endpoints de consulta vehicular.

\n","_postman_id":"c8e7c7b0-4f64-4d01-902a-e59f6329d314","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]},"isInherited":true,"source":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","type":"collection"}}},{"name":"Consultas Académicas","item":[{"name":"SENESCYT - Consultar Títulos Universitarios","id":"68721b84-f8d9-4726-be73-04c0318be4c1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://webservices.ec/api/senescyt/0901234567","description":"

Consulta SENESCYT

Consulta títulos universitarios registrados en la SENESCYT.

Parámetros URL

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`cedula`	string (10 dígitos)	Número de cédula

Permiso: `api:senescyt` — Costo: $0.10

✅ Respuesta Exitosa (200)

{\n  \"data\": {\n    \"cedula\": \"0901234567\",\n    \"titulos\": [\n      {\n        \"institucion\": \"UNIVERSIDAD DE GUAYAQUIL\",\n        \"titulo\": \"INGENIERO EN SISTEMAS COMPUTACIONALES\",\n        \"tipo\": \"TERCER NIVEL\",\n        \"registro\": \"1234-2015-567890\",\n        \"fecha_registro\": \"2015-03-20\"\n      }\n    ]\n  }\n}\n

❌ Códigos de Error Comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Error	Descripción
401	Unauthenticated	Token inválido, expirado o no proporcionado
402	Insufficient Balance	Saldo insuficiente. Recargue en webservices.ec
403	Invalid ability provided	El token no tiene el permiso necesario para este endpoint
403	Forbidden	Acceso denegado por restricción de IP o permisos
404	Not Found	Identificación no encontrada en registros públicos
422	Validation Error	Parámetros inválidos o formato incorrecto
429	Query Limit Reached	El token alcanzó su límite de consultas
500	Server Error	Error interno del servicio público consultado

Ejemplo Error 401 - Token Inválido

{ \"message\": \"Unauthenticated.\" }\n

Ejemplo Error 402 - Saldo Insuficiente

{ \"data\": { \"error\": \"Saldo del paquete agotado para este token. Adquiera más saldo en webservices.ec\" } }\n

Ejemplo Error 402 - Sin Saldo Global

{ \"data\": { \"error\": \"No dispone de saldo suficiente para realizar esta consulta. Por favor recargue su saldo en la página de webservices.ec\" } }\n

Ejemplo Error 403 - Sin Permiso

HTTP 403 Forbidden - Invalid ability provided.\n

Ejemplo Error 429 - Límite de Consultas

{ \"data\": { \"error\": \"Este token ha alcanzado su límite de consultas (1100). Adquiera más consultas en la página de paquetes.\" } }\n

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]},"isInherited":true,"source":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","type":"collection"}},"urlObject":{"path":["api","senescyt","0901234567"],"host":["https://webservices.ec"],"query":[],"variable":[]}},"response":[],"_postman_id":"68721b84-f8d9-4726-be73-04c0318be4c1"},{"name":"BACHILLER - Consultar Título Bachiller","id":"b8ece4f7-e6ef-4e10-bfa2-fc034401edb7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://webservices.ec/api/bachiller/0901234567","description":"

Consulta de Título de Bachiller

Consulta si una persona posee título de bachiller registrado en el sistema educativo ecuatoriano.

Parámetros URL

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`cedula`	string (10 dígitos)	Número de cédula

Permiso: `api:bachiller` — Costo: $0.10

✅ Respuesta Exitosa (200)

{\n  \"data\": {\n    \"Cedula\": \"0901234567\",\n    \"Titulado\": \"GARCIA LOPEZ JUAN CARLOS\",\n    \"Institucion\": \"UNIDAD EDUCATIVA FISCAL VICENTE ROCAFUERTE\",\n    \"Titulo\": \"BACHILLER EN CIENCIAS\",\n    \"Especialidad\": \"CIENCIAS GENERALES\",\n    \"Fecha_Grado\": \"2010-07-15\",\n    \"Refrendacion\": \"REF-2010-GYE-001234\"\n  }\n}\n

❌ Sin Título Registrado

{\n  \"data\": {\n    \"error\": \"No se encontraron resultados\",\n    \"codigo\": 404\n  }\n}\n

❌ Códigos de Error Comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Error	Descripción
401	Unauthenticated	Token inválido, expirado o no proporcionado
402	Insufficient Balance	Saldo insuficiente. Recargue en webservices.ec
403	Invalid ability provided	El token no tiene el permiso necesario para este endpoint
403	Forbidden	Acceso denegado por restricción de IP o permisos
404	Not Found	Identificación no encontrada en registros públicos
422	Validation Error	Parámetros inválidos o formato incorrecto
429	Query Limit Reached	El token alcanzó su límite de consultas
500	Server Error	Error interno del servicio público consultado

Ejemplo Error 401 - Token Inválido

{ \"message\": \"Unauthenticated.\" }\n

Ejemplo Error 402 - Saldo Insuficiente

{ \"data\": { \"error\": \"Saldo del paquete agotado para este token. Adquiera más saldo en webservices.ec\" } }\n

Ejemplo Error 402 - Sin Saldo Global

{ \"data\": { \"error\": \"No dispone de saldo suficiente para realizar esta consulta. Por favor recargue su saldo en la página de webservices.ec\" } }\n

Ejemplo Error 403 - Sin Permiso

HTTP 403 Forbidden - Invalid ability provided.\n

Ejemplo Error 429 - Límite de Consultas

{ \"data\": { \"error\": \"Este token ha alcanzado su límite de consultas (1100). Adquiera más consultas en la página de paquetes.\" } }\n

Endpoints de consulta de títulos académicos.

\n","_postman_id":"7c43b568-3652-4aa9-bd62-5bc3070bb52c","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]},"isInherited":true,"source":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","type":"collection"}}},{"name":"Consultas Tributarias","item":[{"name":"RUC - Consulta Completa","id":"698aa1b5-ddaa-45bc-abb7-2eb525ddeb7b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://webservices.ec/api/ruc/0901234567001","description":"

Consulta Completa de RUC

Información completa de un contribuyente por su RUC, incluyendo datos tributarios, establecimientos, fechas y representantes legales.

Parámetros URL

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`ruc`	string (13 dígitos)	Número de RUC

Permiso: `api:ruc` — Costo: $0.04

Estructura de Respuesta

La respuesta contiene dos arrays principales:

main: Datos del contribuyente (razón social, estado, régimen, fechas, representante legal)
addit: Lista de establecimientos (dirección, nombre comercial, estado, matriz)

✅ Persona Natural (200)

{\n  \"data\": {\n    \"main\": [\n      {\n        \"numeroRuc\": \"0901234567001\",\n        \"razonSocial\": \"GARCIA LOPEZ JUAN CARLOS\",\n        \"estadoContribuyenteRuc\": \"ACTIVO\",\n        \"actividadEconomicaPrincipal\": \"VENTA AL POR MENOR DE ALIMENTOS EN ESTABLECIMIENTOS ESPECIALIZADOS.\",\n        \"tipoContribuyente\": \"PERSONA NATURAL\",\n        \"regimen\": \"RIMPE\",\n        \"categoria\": \"NEGOCIO POPULAR\",\n        \"obligadoLlevarContabilidad\": \"NO\",\n        \"agenteRetencion\": \"NO\",\n        \"contribuyenteEspecial\": \"NO\",\n        \"informacionFechasContribuyente\": {\n          \"fechaInicioActividades\": \"2010-03-15 00:00:00.0\",\n          \"fechaCese\": \"\",\n          \"fechaReinicioActividades\": \"\",\n          \"fechaActualizacion\": \"2024-01-10 14:30:00.0\"\n        },\n        \"representantesLegales\": null,\n        \"motivoCancelacionSuspension\": null,\n        \"contribuyenteFantasma\": \"NO\",\n        \"transaccionesInexistente\": \"NO\"\n      }\n    ],\n    \"addit\": [\n      {\n        \"nombreFantasiaComercial\": \"TIENDA DON CARLOS\",\n        \"tipoEstablecimiento\": \"MAT\",\n        \"direccionCompleta\": \"GUAYAS / GUAYAQUIL / TARQUI / AV. FRANCISCO DE ORELLANA 234 Y AV. PLAZA DAÑIN\",\n        \"estado\": \"ABIERTO\",\n        \"numeroEstablecimiento\": \"001\",\n        \"matriz\": \"SI\"\n      }\n    ]\n  }\n}\n

✅ Persona Jurídica (200)

{\n  \"data\": {\n    \"main\": [\n      {\n        \"numeroRuc\": \"0990123456001\",\n        \"razonSocial\": \"COMERCIALIZADORA ANDINA DEL PACIFICO S.A.\",\n        \"estadoContribuyenteRuc\": \"ACTIVO\",\n        \"actividadEconomicaPrincipal\": \"ACTIVIDADES DE COMERCIO EXTERIOR Y LOGÍSTICA.\",\n        \"tipoContribuyente\": \"SOCIEDAD\",\n        \"regimen\": \"GENERAL\",\n        \"categoria\": \"\",\n        \"obligadoLlevarContabilidad\": \"SI\",\n        \"agenteRetencion\": \"SI\",\n        \"contribuyenteEspecial\": \"NO\",\n        \"informacionFechasContribuyente\": {\n          \"fechaInicioActividades\": \"2005-08-22 00:00:00.0\",\n          \"fechaCese\": \"\",\n          \"fechaReinicioActividades\": \"\",\n          \"fechaActualizacion\": \"2023-12-05 11:20:00.0\"\n        },\n        \"representantesLegales\": \"MARTINEZ SUAREZ PEDRO ANTONIO\",\n        \"motivoCancelacionSuspension\": null,\n        \"contribuyenteFantasma\": \"NO\",\n        \"transaccionesInexistente\": \"NO\"\n      }\n    ],\n    \"addit\": [\n      {\n        \"nombreFantasiaComercial\": \"ANDIPAC\",\n        \"tipoEstablecimiento\": \"MAT\",\n        \"direccionCompleta\": \"GUAYAS / GUAYAQUIL / XIMENA / KM 4.5 VIA A DAULE PARQUE INDUSTRIAL\",\n        \"estado\": \"ABIERTO\",\n        \"numeroEstablecimiento\": \"001\",\n        \"matriz\": \"SI\"\n      },\n      {\n        \"nombreFantasiaComercial\": \"ANDIPAC NORTE\",\n        \"tipoEstablecimiento\": \"OFI\",\n        \"direccionCompleta\": \"PICHINCHA / QUITO / IÑAQUITO / AV. AMAZONAS N36-152 Y NACIONES UNIDAS\",\n        \"estado\": \"ABIERTO\",\n        \"numeroEstablecimiento\": \"002\",\n        \"matriz\": \"NO\"\n      }\n    ]\n  }\n}\n

📋 Campos Principales (`main`)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
`numeroRuc`	string	RUC del contribuyente
`razonSocial`	string	Nombre o razón social
`estadoContribuyenteRuc`	string	ACTIVO, PASIVO, SUSPENDIDO
`actividadEconomicaPrincipal`	string	Descripción de actividad CIIU
`tipoContribuyente`	string	PERSONA NATURAL, SOCIEDAD
`regimen`	string	RIMPE, GENERAL, etc.
`categoria`	string	NEGOCIO POPULAR, EMPRENDEDOR, etc.
`obligadoLlevarContabilidad`	string	SI / NO
`agenteRetencion`	string	SI / NO
`contribuyenteEspecial`	string	SI / NO
`representantesLegales`	string/null	Nombre del representante legal
`contribuyenteFantasma`	string	SI / NO
`transaccionesInexistente`	string	SI / NO

📋 Campos Fechas (`informacionFechasContribuyente`)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
`fechaInicioActividades`	string	Fecha de inicio de actividades
`fechaCese`	string	Fecha de cese (vacío si activo)
`fechaReinicioActividades`	string	Fecha de reinicio (si aplica)
`fechaActualizacion`	string	Última actualización del registro

📋 Campos Establecimientos (`addit`)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Campo	Tipo	Descripción
`nombreFantasiaComercial`	string	Nombre comercial del establecimiento
`tipoEstablecimiento`	string	MAT (Matriz), OFI (Oficina), SUC (Sucursal)
`direccionCompleta`	string	Provincia / Ciudad / Parroquia / Dirección
`estado`	string	ABIERTO / CERRADO
`numeroEstablecimiento`	string	Número secuencial del establecimiento
`matriz`	string	SI / NO

❌ Códigos de Error Comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Error	Descripción
401	Unauthenticated	Token inválido, expirado o no proporcionado
402	Insufficient Balance	Saldo insuficiente. Recargue en webservices.ec
403	Invalid ability provided	El token no tiene el permiso necesario para este endpoint
403	Forbidden	Acceso denegado por restricción de IP o permisos
404	Not Found	Identificación no encontrada en registros públicos
422	Validation Error	Parámetros inválidos o formato incorrecto
429	Query Limit Reached	El token alcanzó su límite de consultas
500	Server Error	Error interno del servicio público consultado

Ejemplo Error 401 - Token Inválido

{ \"message\": \"Unauthenticated.\" }\n

Ejemplo Error 402 - Saldo Insuficiente

{ \"data\": { \"error\": \"Saldo del paquete agotado para este token. Adquiera más saldo en webservices.ec\" } }\n

Ejemplo Error 402 - Sin Saldo Global

{ \"data\": { \"error\": \"No dispone de saldo suficiente para realizar esta consulta. Por favor recargue su saldo en la página de webservices.ec\" } }\n

Ejemplo Error 403 - Sin Permiso

HTTP 403 Forbidden - Invalid ability provided.\n

Ejemplo Error 429 - Límite de Consultas

{ \"data\": { \"error\": \"Este token ha alcanzado su límite de consultas (1100). Adquiera más consultas en la página de paquetes.\" } }\n

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]},"isInherited":true,"source":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","type":"collection"}},"urlObject":{"path":["api","ruc","0901234567001"],"host":["https://webservices.ec"],"query":[],"variable":[]}},"response":[],"_postman_id":"698aa1b5-ddaa-45bc-abb7-2eb525ddeb7b"},{"name":"RUC LITE - Consulta Rápida","id":"62e14826-1f1e-4ab9-a925-5f15ba0172ad","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://webservices.ec/api/ruclite/0901234567001","description":"

Consulta Rápida de RUC (Lite)

Versión económica. Retorna datos básicos del contribuyente.

Parámetros URL

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`ruc`	string (13 dígitos)	Número de RUC

Permiso: `api:ruc_lite` — Costo: $0.05

✅ Respuesta Exitosa (200)

{\n  \"data\": {\n    \"identificacion\": \"0901234567001\",\n    \"nombreCompleto\": \"GARCIA LOPEZ JUAN CARLOS\",\n    \"tipoPersona\": \"NAT\"\n  }\n}\n

❌ Códigos de Error Comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Error	Descripción
401	Unauthenticated	Token inválido, expirado o no proporcionado
402	Insufficient Balance	Saldo insuficiente. Recargue en webservices.ec
403	Invalid ability provided	El token no tiene el permiso necesario para este endpoint
403	Forbidden	Acceso denegado por restricción de IP o permisos
404	Not Found	Identificación no encontrada en registros públicos
422	Validation Error	Parámetros inválidos o formato incorrecto
429	Query Limit Reached	El token alcanzó su límite de consultas
500	Server Error	Error interno del servicio público consultado

Ejemplo Error 401 - Token Inválido

{ \"message\": \"Unauthenticated.\" }\n

Ejemplo Error 402 - Saldo Insuficiente

{ \"data\": { \"error\": \"Saldo del paquete agotado para este token. Adquiera más saldo en webservices.ec\" } }\n

Ejemplo Error 402 - Sin Saldo Global

{ \"data\": { \"error\": \"No dispone de saldo suficiente para realizar esta consulta. Por favor recargue su saldo en la página de webservices.ec\" } }\n

Ejemplo Error 403 - Sin Permiso

HTTP 403 Forbidden - Invalid ability provided.\n

Ejemplo Error 429 - Límite de Consultas

{ \"data\": { \"error\": \"Este token ha alcanzado su límite de consultas (1100). Adquiera más consultas en la página de paquetes.\" } }\n

Endpoints de consulta de datos tributarios (SRI).

\n","_postman_id":"7b69c20b-f605-4b09-b8dc-1e5ec9552109","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]},"isInherited":true,"source":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","type":"collection"}}},{"name":"Consultas de Identidad","item":[{"name":"CÉDULA - Consultar por Cédula","id":"f8d78c39-9aa2-4183-b29b-0ec97b7c27fe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://webservices.ec/api/cedula/0901234567","description":"

Consulta de Cédula

Consulta información de una persona natural por su cédula ecuatoriana.

Parámetros URL

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`cedula`	string (10 dígitos)	Número de cédula

Permiso: `api:cedula` — Costo: $0.05

✅ Respuesta Exitosa (200)

{\n  \"data\": {\n    \"response\": {\n      \"identificacion\": \"0901234567\",\n      \"nombreCompleto\": \"GARCIA LOPEZ JUAN CARLOS\",\n      \"nombres\": \"JUAN CARLOS\",\n      \"apellidos\": \"GARCIA LOPEZ\",\n      \"estado\": \"CIUDADANO\"\n    }\n  }\n}\n

💀 Persona Fallecida

{\n  \"data\": {\n    \"response\": {\n      \"identificacion\": \"0901234567\",\n      \"nombreCompleto\": \"GARCIA LOPEZ JUAN CARLOS\",\n      \"nombres\": \"JUAN CARLOS\",\n      \"apellidos\": \"GARCIA LOPEZ\",\n      \"estado\": \"FALLECIDO\"\n    }\n  }\n}\n

❌ Cédula No Encontrada (200 con Info)

{\n  \"data\": {\n    \"Info\": \"No se encontraron resultados para la cédula proporcionada\",\n    \"codigo\": 200\n  }\n}\n

❌ Códigos de Error Comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Error	Descripción
401	Unauthenticated	Token inválido, expirado o no proporcionado
402	Insufficient Balance	Saldo insuficiente. Recargue en webservices.ec
403	Invalid ability provided	El token no tiene el permiso necesario para este endpoint
403	Forbidden	Acceso denegado por restricción de IP o permisos
404	Not Found	Identificación no encontrada en registros públicos
422	Validation Error	Parámetros inválidos o formato incorrecto
429	Query Limit Reached	El token alcanzó su límite de consultas
500	Server Error	Error interno del servicio público consultado

Ejemplo Error 401 - Token Inválido

{ \"message\": \"Unauthenticated.\" }\n

Ejemplo Error 402 - Saldo Insuficiente

{ \"data\": { \"error\": \"Saldo del paquete agotado para este token. Adquiera más saldo en webservices.ec\" } }\n

Ejemplo Error 402 - Sin Saldo Global

{ \"data\": { \"error\": \"No dispone de saldo suficiente para realizar esta consulta. Por favor recargue su saldo en la página de webservices.ec\" } }\n

Ejemplo Error 403 - Sin Permiso

HTTP 403 Forbidden - Invalid ability provided.\n

Ejemplo Error 429 - Límite de Consultas

{ \"data\": { \"error\": \"Este token ha alcanzado su límite de consultas (1100). Adquiera más consultas en la página de paquetes.\" } }\n

Endpoints de consulta de datos de identidad del Ecuador.

\n","_postman_id":"153e8203-841a-4f2b-a653-0f73cd20485a","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]},"isInherited":true,"source":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","type":"collection"}}},{"name":"Gestión de Tokens","item":[{"name":"Crear Token","id":"ce1de116-4422-4165-9818-f3f53c3521a6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Mi Token Producción\",\n \"permissions\": [\n \"api:cedula\",\n \"api:ruc\"\n ],\n \"whitelist\": []\n}","options":{"raw":{"language":"json"}}},"url":"https://webservices.ec/api/tokens","description":"

Crear Token

Parámetros JSON

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Tipo	Req	Descripción
name	string	✅	Nombre del token
permissions	array	✅	Permisos a asignar
ruc	string	❌	RUC para sri_comprobantes
whitelist	array	❌	IPs permitidas (vacío=todas)

✅ Respuesta (201)

{\n  \"status\": \"success\",\n  \"message\": \"Token creado exitosamente.\",\n  \"data\": {\n    \"token_id\": 42,\n    \"name\": \"Mi Token Producción\",\n    \"plain_text_token\": \"1|abc123def456ghi789...\",\n    \"permissions\": [\"api:cedula\", \"api:ruc\"],\n    \"ruc_registered\": null,\n    \"whitelist\": null\n  },\n  \"warning\": \"⚠️ Guarda este token en un lugar seguro. No podrás verlo de nuevo.\"\n}\n

❌ Error 409 - RUC duplicado

{ \"status\": \"error\", \"message\": \"Ya existe un token activo con este RUC.\" }\n

❌ Códigos de Error Comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Error	Descripción
401	Unauthenticated	Token inválido, expirado o no proporcionado
402	Insufficient Balance	Saldo insuficiente. Recargue en webservices.ec
403	Invalid ability provided	El token no tiene el permiso necesario para este endpoint
403	Forbidden	Acceso denegado por restricción de IP o permisos
404	Not Found	Identificación no encontrada en registros públicos
422	Validation Error	Parámetros inválidos o formato incorrecto
429	Query Limit Reached	El token alcanzó su límite de consultas
500	Server Error	Error interno del servicio público consultado

Ejemplo Error 401 - Token Inválido

{ \"message\": \"Unauthenticated.\" }\n

Ejemplo Error 402 - Saldo Insuficiente

{ \"data\": { \"error\": \"Saldo del paquete agotado para este token. Adquiera más saldo en webservices.ec\" } }\n

Ejemplo Error 402 - Sin Saldo Global

{ \"data\": { \"error\": \"No dispone de saldo suficiente para realizar esta consulta. Por favor recargue su saldo en la página de webservices.ec\" } }\n

Ejemplo Error 403 - Sin Permiso

HTTP 403 Forbidden - Invalid ability provided.\n

Ejemplo Error 429 - Límite de Consultas

{ \"data\": { \"error\": \"Este token ha alcanzado su límite de consultas (1100). Adquiera más consultas en la página de paquetes.\" } }\n

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]},"isInherited":true,"source":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","type":"collection"}},"urlObject":{"path":["api","tokens"],"host":["https://webservices.ec"],"query":[],"variable":[]}},"response":[],"_postman_id":"ce1de116-4422-4165-9818-f3f53c3521a6"},{"name":"Listar Tokens","id":"3d22f303-6a31-4a89-bedc-d1a96b941503","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://webservices.ec/api/tokens","description":"

Listar Tokens

✅ Respuesta (200)

{\n  \"status\": \"success\",\n  \"data\": {\n    \"total\": 2,\n    \"tokens\": [\n      {\n        \"id\": 1,\n        \"name\": \"Token Principal\",\n        \"abilities\": [\"api:cedula\", \"api:ruc\"],\n        \"last_used_at\": \"2026-04-25 10:30:00\",\n        \"created_at\": \"2026-01-15 08:00:00\"\n      },\n      {\n        \"id\": 2,\n        \"name\": \"Token SRI\",\n        \"abilities\": [\"api:sri_comprobantes\"],\n        \"last_used_at\": null,\n        \"created_at\": \"2026-04-20 14:00:00\"\n      }\n    ]\n  }\n}\n

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]},"isInherited":true,"source":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","type":"collection"}},"urlObject":{"path":["api","tokens"],"host":["https://webservices.ec"],"query":[],"variable":[]}},"response":[],"_postman_id":"3d22f303-6a31-4a89-bedc-d1a96b941503"},{"name":"Eliminar Token","id":"cd08ab6e-e138-4102-8512-7da7b503a426","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://webservices.ec/api/tokens/1","description":"

Eliminar Token

No puedes eliminar el token con el que haces la solicitud.

✅ Respuesta (200)

{ \"status\": \"success\", \"message\": \"Token eliminado correctamente.\" }\n

❌ Error 403

{ \"status\": \"error\", \"message\": \"No puedes eliminar el token que estás usando actualmente.\" }\n

Administrar tokens de API programáticamente.

Permiso: `api:create_tokens`

Permisos Disponibles

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Permiso	Descripción
`api:cedula`	Consulta cédulas
`api:ruc`	Consulta RUC completo
`api:ruc_lite`	Consulta RUC rápido
`api:senescyt`	Títulos SENESCYT
`api:bachiller`	Títulos bachiller
`api:placas`	Consulta placas
`api:whatsapp_check_phone`	Verificación WhatsApp
`api:sri_comprobantes`	Comprobantes SRI
`api:create_tokens`	Gestión de tokens

","_postman_id":"6b764789-ac94-41d6-abaa-d111b6d8f1a6","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]},"isInherited":true,"source":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","type":"collection"}}},{"name":"WhatsApp","item":[{"name":"CHECK WHATSAPP - Verificar Número","id":"3afa995d-b312-4e7e-a73b-4c78278d942a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://webservices.ec/api/checkwhatsapp/593901234567","description":"

Verificar Número WhatsApp

Verifica si un número tiene cuenta WhatsApp activa.

Parámetros URL

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parámetro	Tipo	Descripción
`phone`	string	Número con código de país (ej: 593901234567)

Permiso: `api:whatsapp_check_phone` — Costo: $0.02

✅ Número Válido (200)

{\n  \"data\": {\n    \"status\": \"valid\",\n    \"is_valid\": true\n  }\n}\n

❌ Número Sin WhatsApp (200)

{\n  \"data\": {\n    \"status\": \"invalid\",\n    \"is_valid\": false\n  }\n}\n

❌ Códigos de Error Comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Error	Descripción
401	Unauthenticated	Token inválido, expirado o no proporcionado
402	Insufficient Balance	Saldo insuficiente. Recargue en webservices.ec
403	Invalid ability provided	El token no tiene el permiso necesario para este endpoint
403	Forbidden	Acceso denegado por restricción de IP o permisos
404	Not Found	Identificación no encontrada en registros públicos
422	Validation Error	Parámetros inválidos o formato incorrecto
429	Query Limit Reached	El token alcanzó su límite de consultas
500	Server Error	Error interno del servicio público consultado

Ejemplo Error 401 - Token Inválido

{ \"message\": \"Unauthenticated.\" }\n

Ejemplo Error 402 - Saldo Insuficiente

{ \"data\": { \"error\": \"Saldo del paquete agotado para este token. Adquiera más saldo en webservices.ec\" } }\n

Ejemplo Error 402 - Sin Saldo Global

{ \"data\": { \"error\": \"No dispone de saldo suficiente para realizar esta consulta. Por favor recargue su saldo en la página de webservices.ec\" } }\n

Ejemplo Error 403 - Sin Permiso

HTTP 403 Forbidden - Invalid ability provided.\n

Ejemplo Error 429 - Límite de Consultas

{ \"data\": { \"error\": \"Este token ha alcanzado su límite de consultas (1100). Adquiera más consultas en la página de paquetes.\" } }\n

Validación de números WhatsApp.

\n","_postman_id":"75364784-7b61-4f26-82e7-576ef357edda","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]},"isInherited":true,"source":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","type":"collection"}}},{"name":"SRI Comprobantes","item":[{"name":"Descargar Comprobantes del SRI","id":"ff63c8da-deda-4e74-a880-6e990b2bb3b4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"ruc","value":"0901234567001","description":"

(Requerido) RUC del contribuyente (13 dígitos)

\n","type":"text"},{"key":"password","value":"mi_clave_sri","description":"

(Requerido) Contraseña SRI en línea. NO se almacena.

\n","type":"text"},{"key":"year","value":"2026","description":"

(Requerido) Año de consulta

\n","type":"text"},{"key":"month","value":"4","description":"

(Requerido) Mes (1-12)

\n","type":"text"},{"key":"type","value":"1","description":"

(Requerido) 1=Factura, 2=Liquidación, 3=NC, 4=ND, 5=Retención

\n","type":"text"},{"key":"day","value":"0","description":"

(Requerido) Día (1-31) o 0=todos

\n","type":"text"}]},"url":"https://webservices.ec/api/sri/comprobantes","description":"

Descargar Comprobantes

Costo: $0.004 por documento descargado.

✅ Respuesta Exitosa (200)

{\n  \"status\": \"success\",\n  \"data\": {\n    \"total_comprobantes\": 2,\n    \"comprobantes\": [\n      {\n        \"clave_acceso\": \"2504202601099012345600110010010000012341234567817\",\n        \"fecha_emision\": \"25/04/2026\",\n        \"ruc_emisor\": \"0991234567001\",\n        \"razon_social_emisor\": \"DISTRIBUIDORA EJEMPLO S.A.\",\n        \"tipo_comprobante\": \"FACTURA\",\n        \"establecimiento\": \"001\",\n        \"punto_emision\": \"001\",\n        \"secuencial\": \"000001234\",\n        \"importe_total\": \"156.80\",\n        \"xml_url\": \"https://s3.amazonaws.com/.../comprobante.xml\",\n        \"ride_url\": \"https://s3.amazonaws.com/.../comprobante.pdf\"\n      }\n    ]\n  },\n  \"billing\": {\n    \"documents_charged\": 2,\n    \"price_per_document\": 0.004,\n    \"total_charged\": \"0.0080\",\n    \"remaining_balance\": \"49.9920\"\n  },\n  \"metadata\": {\n    \"source\": \"python\",\n    \"ruc\": \"0901234567001\"\n  }\n}\n

💾 Desde Caché (sin cargo)

{\n  \"status\": \"success\",\n  \"data\": { \"total_comprobantes\": 5, \"comprobantes\": [...] },\n  \"billing\": { \"documents_charged\": 0, \"total_charged\": \"0.0000\" },\n  \"metadata\": { \"source\": \"cache\", \"message\": \"Datos obtenidos desde caché local (fecha pasada, sin cargo)\" }\n}\n

❌ Error 403 - RUC no coincide

{ \"status\": \"error\", \"message\": \"RUC_MISMATCH: El RUC enviado no coincide con el registrado en este token\" }\n

❌ Códigos de Error Comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Error	Descripción
401	Unauthenticated	Token inválido, expirado o no proporcionado
402	Insufficient Balance	Saldo insuficiente. Recargue en webservices.ec
403	Invalid ability provided	El token no tiene el permiso necesario para este endpoint
403	Forbidden	Acceso denegado por restricción de IP o permisos
404	Not Found	Identificación no encontrada en registros públicos
422	Validation Error	Parámetros inválidos o formato incorrecto
429	Query Limit Reached	El token alcanzó su límite de consultas
500	Server Error	Error interno del servicio público consultado

Ejemplo Error 401 - Token Inválido

{ \"message\": \"Unauthenticated.\" }\n

Ejemplo Error 402 - Saldo Insuficiente

{ \"data\": { \"error\": \"Saldo del paquete agotado para este token. Adquiera más saldo en webservices.ec\" } }\n

Ejemplo Error 402 - Sin Saldo Global

{ \"data\": { \"error\": \"No dispone de saldo suficiente para realizar esta consulta. Por favor recargue su saldo en la página de webservices.ec\" } }\n

Ejemplo Error 403 - Sin Permiso

HTTP 403 Forbidden - Invalid ability provided.\n

Ejemplo Error 429 - Límite de Consultas

{ \"data\": { \"error\": \"Este token ha alcanzado su límite de consultas (1100). Adquiera más consultas en la página de paquetes.\" } }\n

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]},"isInherited":true,"source":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","type":"collection"}},"urlObject":{"path":["api","sri","comprobantes"],"host":["https://webservices.ec"],"query":[],"variable":[]}},"response":[],"_postman_id":"ff63c8da-deda-4e74-a880-6e990b2bb3b4"},{"name":"Historial de Comprobantes","id":"dcd84649-4eb2-47a6-9f99-328965793baf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://webservices.ec/api/sri/historial?per_page=25&page=1","description":"

Historial de Comprobantes

Consulta comprobantes previamente descargados (paginado).

Permiso: `api:sri_comprobantes`

Query Params (opcionales)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Param	Tipo	Descripción
per_page	int	Resultados por página (default: 25)
page	int	Número de página
ruc	string	Filtrar por RUC emisor
desde	date	Fecha desde (YYYY-MM-DD)
hasta	date	Fecha hasta (YYYY-MM-DD)
tipo	string	Tipo de comprobante

","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]},"isInherited":true,"source":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","type":"collection"}},"urlObject":{"path":["api","sri","historial"],"host":["https://webservices.ec"],"query":[{"key":"per_page","value":"25"},{"key":"page","value":"1"}],"variable":[]}},"response":[],"_postman_id":"dcd84649-4eb2-47a6-9f99-328965793baf"},{"name":"Estadísticas de Comprobantes","id":"52a9c1ee-2869-4bd4-9465-3a811c8e628e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"}],"url":"https://webservices.ec/api/sri/stats","description":"

Estadísticas

Resumen de comprobantes descargados.

Permiso: `api:sri_comprobantes`

Descarga de comprobantes electrónicos del SRI.

⚠️ Requisitos

Permiso api:sri_comprobantes
RUC se vincula al token en primer uso
Contraseña SRI requerida (NO se almacena)

Tipos de Comprobante

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Valor	Tipo
1	Factura
2	Liquidación de compras
3	Nota de Crédito
4	Nota de Débito
5	Retención

","_postman_id":"04143b83-fed9-4ff1-b09b-26fdc3ea3a6f","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]},"isInherited":true,"source":{"_postman_id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","id":"72b2fecc-01cc-47d7-bf18-63f9f2aeccf9","name":"WEBSERVICES.EC - Documentación API v2.0","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"TU_TOKEN_AQUI"}]}},"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"804d2379-71ec-4dc4-9f44-34796c42c0f5"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"256dfc70-7bb8-4df8-95ae-f5f9a338a231"}}],"variable":[{"key":"base_url","value":"https://webservices.ec"},{"key":"token","value":"TU_TOKEN_AQUI"},{"key":"token_id","value":"1","description":"ID del token a eliminar"}]}

🔐 Autenticación

⚙️ Configuración

💰 Precios por Consulta

📋 Permisos por Endpoint

❌ Códigos de Error Comunes

Ejemplo Error 401 - Token Inválido

Ejemplo Error 402 - Saldo Insuficiente

Ejemplo Error 402 - Sin Saldo Global

Ejemplo Error 403 - Sin Permiso

Ejemplo Error 429 - Límite de Consultas

📞 Soporte

Consulta de Placas

Parámetros URL

Permiso: api:placas — Costo: $0.08

✅ Respuesta Exitosa (200)

❌ Códigos de Error Comunes

Ejemplo Error 401 - Token Inválido

Ejemplo Error 402 - Saldo Insuficiente

Ejemplo Error 402 - Sin Saldo Global

Ejemplo Error 403 - Sin Permiso

Ejemplo Error 429 - Límite de Consultas

Consulta SENESCYT

Parámetros URL

Permiso: api:senescyt — Costo: $0.10

✅ Respuesta Exitosa (200)

❌ Códigos de Error Comunes

Ejemplo Error 401 - Token Inválido

Ejemplo Error 402 - Saldo Insuficiente

Ejemplo Error 402 - Sin Saldo Global

Ejemplo Error 403 - Sin Permiso

Ejemplo Error 429 - Límite de Consultas

Consulta de Título de Bachiller

Parámetros URL

Permiso: api:bachiller — Costo: $0.10

✅ Respuesta Exitosa (200)

❌ Sin Título Registrado

❌ Códigos de Error Comunes

Ejemplo Error 401 - Token Inválido

Ejemplo Error 402 - Saldo Insuficiente

Ejemplo Error 402 - Sin Saldo Global

Ejemplo Error 403 - Sin Permiso

Ejemplo Error 429 - Límite de Consultas

Consulta Completa de RUC

Parámetros URL

Permiso: api:ruc — Costo: $0.04

Estructura de Respuesta

✅ Persona Natural (200)

✅ Persona Jurídica (200)

📋 Campos Principales (main)

📋 Campos Fechas (informacionFechasContribuyente)

📋 Campos Establecimientos (addit)

❌ Códigos de Error Comunes

Ejemplo Error 401 - Token Inválido

Ejemplo Error 402 - Saldo Insuficiente

Ejemplo Error 402 - Sin Saldo Global

Ejemplo Error 403 - Sin Permiso

Ejemplo Error 429 - Límite de Consultas

Consulta Rápida de RUC (Lite)

Parámetros URL

Permiso: api:ruc_lite — Costo: $0.05

✅ Respuesta Exitosa (200)

❌ Códigos de Error Comunes

Ejemplo Error 401 - Token Inválido

Ejemplo Error 402 - Saldo Insuficiente

Ejemplo Error 402 - Sin Saldo Global

Ejemplo Error 403 - Sin Permiso

Ejemplo Error 429 - Límite de Consultas

Consulta de Cédula

Parámetros URL

Permiso: api:cedula — Costo: $0.05

✅ Respuesta Exitosa (200)

💀 Persona Fallecida

❌ Cédula No Encontrada (200 con Info)

❌ Códigos de Error Comunes

Ejemplo Error 401 - Token Inválido

Ejemplo Error 402 - Saldo Insuficiente

Ejemplo Error 402 - Sin Saldo Global

Ejemplo Error 403 - Sin Permiso

Ejemplo Error 429 - Límite de Consultas

Crear Token

Permiso: `api:placas` — Costo: $0.08

Permiso: `api:senescyt` — Costo: $0.10

Permiso: `api:bachiller` — Costo: $0.10

Permiso: `api:ruc` — Costo: $0.04

📋 Campos Principales (`main`)

📋 Campos Fechas (`informacionFechasContribuyente`)

📋 Campos Establecimientos (`addit`)

Permiso: `api:ruc_lite` — Costo: $0.05

Permiso: `api:cedula` — Costo: $0.05

Permiso: `api:create_tokens`

Permiso: `api:whatsapp_check_phone` — Costo: $0.02

Permiso: `api:sri_comprobantes`

Permiso: `api:sri_comprobantes`