# Ecuafact API > Documentacion de la API de facturacion electronica del SRI (Ecuador): emision y consulta de comprobantes, consultas al catastro del SRI y webhooks firmados. Para integradores. Se autentica con la cabecera `X-Api-Key` (credencial de integracion) y se restringe por IP. La emision es idempotente por `Idempotency-Key`; el resultado fiscal se consulta o llega por webhook. ## Empezar - [Introduccion](https://docsapi.ecuafact.com/v1/guias/introduccion.md): La API de Ecuafact permite emitir y consultar comprobantes electronicos desde cualquier sistema: un ERP, un punto de venta, un SaaS o una tienda en linea. Tu... (actualizado: 2026-10-02) - [Primeros pasos](https://docsapi.ecuafact.com/v1/guias/primeros-pasos.md): Camino de cero a tu primer comprobante autorizado en el ambiente de pruebas. (actualizado: 2026-10-02) - [Datos de prueba](https://docsapi.ecuafact.com/v1/guias/datos-de-prueba.md): Todo lo necesario para tu primera emision en el ambiente de pruebas, de punta a punta. (actualizado: 2026-10-02) - [Ciclo de vida del comprobante](https://docsapi.ecuafact.com/v1/guias/ciclo-de-vida.md): Emitir un comprobante no es una sola llamada: es un proceso. Entenderlo te evita confusiones como creer que un comprobante ya esta autorizado cuando aun no l... (actualizado: 2026-10-01) - [Autenticacion](https://docsapi.ecuafact.com/v1/guias/autenticacion.md): Todas las peticiones a la API se autentican con tu API Key. La API Key identifica a tu integracion y representa al cliente y a sus contribuyentes habilitados. (actualizado: 2026-10-02) - [Limite de request](https://docsapi.ecuafact.com/v1/guias/limite-de-request.md): La API limita el numero de solicitudes para mantener el servicio estable. Si superas el limite, la API responde 429 Too Many Requests e indica cuanto esperar... (actualizado: 2026-10-02) - [Ambientes y contribuyentes](https://docsapi.ecuafact.com/v1/guias/ambientes.md): La API funciona en dos ambientes independientes. Elige la URL segun el momento de tu integracion. (actualizado: 2026-10-02) - [Buenas practicas](https://docsapi.ecuafact.com/v1/guias/buenas-practicas.md): Recomendaciones para integrar de forma estable: reintentos seguros, control de duplicados y buen manejo del estado fiscal. (actualizado: 2026-10-02) ## Emision - [Comprobantes electronicos](https://docsapi.ecuafact.com/v1/guias/emision.md): Todos los tipos de comprobante se emiten con el mismo endpoint y la misma estructura. Lo unico que cambia es el codDoc, los campos de info y las colecciones... (actualizado: 2026-10-02) - [Factura](https://docsapi.ecuafact.com/v1/guias/emision-01.md): La factura usa la misma estructura que los demas comprobantes; solo cambian los campos de info y las colecciones. (actualizado: 2026-10-02) - [Liquidacion de compra](https://docsapi.ecuafact.com/v1/guias/emision-03.md): La liquidacion de compra se emite cuando el emisor adquiere bienes o servicios a un proveedor. La estructura del comprobante es la misma que en Factura; camb... (actualizado: 2026-10-02) - [Nota de credito](https://docsapi.ecuafact.com/v1/guias/emision-04.md): La nota de credito ajusta o anula un comprobante ya emitido (devoluciones, descuentos, anulaciones). La estructura del comprobante es la misma que en Factura... (actualizado: 2026-10-02) - [Nota de debito](https://docsapi.ecuafact.com/v1/guias/emision-05.md): La nota de debito incrementa el valor de un comprobante ya emitido (intereses, recargos, ajustes). La estructura del comprobante es la misma que en Factura;... (actualizado: 2026-10-02) - [Guia de remision](https://docsapi.ecuafact.com/v1/guias/emision-06.md): La guia de remision acompana el traslado de bienes. (actualizado: 2026-10-02) - [Comprobante de retencion](https://docsapi.ecuafact.com/v1/guias/emision-07.md): El comprobante de retencion acredita los impuestos retenidos a un proveedor. (actualizado: 2026-10-02) - [Descargar PDF](https://docsapi.ecuafact.com/v1/guias/consulta-ride.md): Devuelve la representacion impresa del comprobante electronico (RIDE) en PDF. identificacion es el RUC del emisor habilitado en tu API Key y claveAcceso la c... (actualizado: 2026-10-02) - [Descargar XML](https://docsapi.ecuafact.com/v1/guias/consulta-xml.md): Devuelve el XML del comprobante emitido en application/xml. identificacion es el RUC del emisor habilitado en tu API Key y claveAcceso la clave de 49 digitos... (actualizado: 2026-10-02) - [Reenviar correo](https://docsapi.ecuafact.com/v1/guias/reenviar-correo.md): Reenvia el comprobante autorizado al correo indicado. Se adjuntan el PDF y el XML. (actualizado: 2026-10-02) - [Perfil del emisor](https://docsapi.ecuafact.com/v1/guias/perfil-emisor.md): Lee y actualiza el perfil del emisor que usa el RIDE: nombre comercial, direccion, contacto y logo. identificacion es el RUC habilitado en tu API Key. (actualizado: 2026-10-02) ## Consulta - [Contexto](https://docsapi.ecuafact.com/v1/guias/consulta-contexto.md): Devuelve el cliente y los contribuyentes habilitados para tu API Key. Es el punto de partida para conocer que RUC y servicios puedes operar. (actualizado: 2026-10-02) - [Comprobantes emitidos](https://docsapi.ecuafact.com/v1/guias/consulta-emitidos.md): Devuelve los comprobantes emitidos por el contribuyente, paginados. (actualizado: 2026-10-02) - [Leer catalogos](https://docsapi.ecuafact.com/v1/guias/consulta-catalogos.md): Devuelve los valores de un catalogo del SRI. (actualizado: 2026-10-05) - [Seguimiento de una operacion](https://docsapi.ecuafact.com/v1/guias/consulta-operacion.md): Devuelve el estado actual de la operacion. id es el idOperacion que devuelve la emision. (actualizado: 2026-10-02) - [Consumo y cuotas](https://docsapi.ecuafact.com/v1/guias/consumo.md): Devuelve el cupo efectivo disponible, sumando el plan y los paquetes de documentos comprados. Coincide con lo que muestra el portal. (actualizado: 2026-10-02) ## Consulta SRI - [Contribuyente por identificacion](https://docsapi.ecuafact.com/v1/guias/consulta-contribuyente.md): Devuelve los datos de un contribuyente del SRI por cedula, RUC o pasaporte: nombre o razon social, regimen, actividad, representantes legales, establecimient... (actualizado: 2026-10-02) - [Contribuyentes por nombre](https://docsapi.ecuafact.com/v1/guias/consulta-contribuyente-nombre.md): Busca contribuyentes por apellidos y nombres (o razon social) y devuelve identificaciones con sus nombres. La respuesta es un arreglo. (actualizado: 2026-10-02) - [Establecimientos de un RUC](https://docsapi.ecuafact.com/v1/guias/consulta-establecimientos.md): Devuelve los establecimientos de un RUC. La respuesta es plana. (actualizado: 2026-10-02) - [Validar identificacion](https://docsapi.ecuafact.com/v1/guias/consulta-identificacion.md): Valida el formato de una cedula, un RUC o un pasaporte sin consultar al SRI. Comprueba el digito verificador cuando corresponde; un pasaporte es alfanumerico... (actualizado: 2026-10-02) - [Decodificar clave de acceso](https://docsapi.ecuafact.com/v1/guias/consulta-clave-acceso.md): Valida el formato y el digito verificador de una clave de acceso, y devuelve sus segmentos. (actualizado: 2026-10-02) ## Webhooks - [Webhooks](https://docsapi.ecuafact.com/v1/guias/webhooks.md): La API te avisa de los cambios de estado de la operacion con un webhook: una peticion HTTP POST a la URL que configures. Cada envio va firmado para que pueda... (actualizado: 2026-10-02) - [Verificacion de firma](https://docsapi.ecuafact.com/v1/guias/webhooks-firma.md): Cada entrega incluye la cabecera: (actualizado: 2026-10-02) ## SDKs - [Vision general](https://docsapi.ecuafact.com/v1/guias/sdk.md): Ademas de llamar la API directamente, puedes usar un cliente oficial que resuelve las tareas repetitivas de la integracion. (actualizado: 2026-10-06) - [.NET](https://docsapi.ecuafact.com/v1/guias/sdk-dotnet.md): Cliente oficial de la API para .NET. Cubre autenticacion, idempotencia, reintentos y firma de webhook. (actualizado: 2026-10-05) - [Node.js](https://docsapi.ecuafact.com/v1/guias/sdk-node.md): Cliente oficial de la API para Node.js (TypeScript). Cubre autenticacion, idempotencia, reintentos y firma de webhook. (actualizado: 2026-10-05) - [Python](https://docsapi.ecuafact.com/v1/guias/sdk-python.md): Cliente oficial de la API para Python. Cubre autenticacion, idempotencia, reintentos y firma de webhook. (actualizado: 2026-10-05) - [Java](https://docsapi.ecuafact.com/v1/guias/sdk-java.md): Cliente oficial de la API para Java (17+). Cubre autenticacion, idempotencia, reintentos y firma de webhook. (actualizado: 2026-10-05) - [PHP](https://docsapi.ecuafact.com/v1/guias/sdk-php.md): Cliente oficial de la API para PHP. Cubre autenticacion, idempotencia, reintentos y firma de webhook. (actualizado: 2026-10-05) ## Recursos - [Colecciones](https://docsapi.ecuafact.com/v1/guias/colecciones.md): Importa la API en Postman (o Newman) con la coleccion lista para usar: incluye todos los endpoints, variables y ejemplos de request y respuesta. (actualizado: 2026-10-03) - [Changelog](https://docsapi.ecuafact.com/v1/guias/changelog.md): Cambios del API y de la documentacion, con fecha. Toda guia o contrato publico que cambie se registra aqui, con el impacto y tu accion. (actualizado: 2026-10-06) ## MCPs & Skills - [MCPs](https://docsapi.ecuafact.com/v1/guias/mcp.md): El servidor MCP de Ecuafact expone esta API a asistentes compatibles con Model Context Protocol (Claude Desktop, Cursor, VS Code). El asistente puede consult... (actualizado: 2026-10-02) - [Skills](https://docsapi.ecuafact.com/v1/guias/skill.md): El skill de Ecuafact es un paquete de conocimiento para asistentes de IA (Claude Code, Cursor, GitHub Copilot y cualquier agente compatible con el estandar A... (actualizado: 2026-10-02) - [Agentes](https://docsapi.ecuafact.com/v1/guias/agentes.md): Guia para asistentes (Claude, ChatGPT, Copilot, Cursor y agentes propios) que integran o consumen esta API. Describe como obtener la documentacion vigente, c... (actualizado: 2026-10-03) ## Referencia - [Respuestas del API](https://docsapi.ecuafact.com/v1/guias/respuestas.md): Forma comun de las respuestas del API. Aqui ves como leer el cuerpo segun el endpoint, la correlacion y como se reportan los errores. (actualizado: 2026-10-05) - [Errores](https://docsapi.ecuafact.com/v1/guias/errores.md): Cuando una peticion no se puede procesar, la API responde con un JSON como este: (actualizado: 2026-10-03) - [Catalogos](https://docsapi.ecuafact.com/v1/guias/catalogos.md): Tablas de referencia del SRI usadas por la API, agrupadas por donde se aplican. El mismo contenido, en JSON, esta en Catalogos. (actualizado: 2026-10-02) - [Limites](https://docsapi.ecuafact.com/v1/guias/limites.md): Limites de la API: tamano de solicitud, paginacion y cupo. Aqui ves los topes por peticion y por consulta, y como responde la API al superarlos. (actualizado: 2026-10-02) - [Glosario](https://docsapi.ecuafact.com/v1/guias/glosario.md): Terminos y convenciones de nombres de la API. Usa estos nombres al integrar y al reportar un caso. (actualizado: 2026-10-02) - [Preguntas frecuentes](https://docsapi.ecuafact.com/v1/guias/faq.md): La emision respondio 202: el comprobante ya esta autorizado? (actualizado: 2026-10-02) - [Versionado](https://docsapi.ecuafact.com/v1/guias/versionado.md): La API versiona el contrato por fecha. La version forma parte de la ruta (/v1) y se identifica con una fecha de publicacion. Puedes fijar la version con la c... (actualizado: 2026-10-03) ## Referencia interactiva - [Referencia interactiva](https://docsapi.ecuafact.com/v1/referencia) ## Mas - [Guia completa (llms-full.txt)](https://docsapi.ecuafact.com/llms-full.txt) - Markdown por pagina: agrega `.md` a cualquier guia (p. ej. `/v1/guias/introduccion.md`), o envia `Accept: text/markdown`. - [Sitemap](https://docsapi.ecuafact.com/sitemap.xml) ## Contrato - [OpenAPI](https://docsapi.ecuafact.com/api/openapi.json) - [Catalogo de servicios](https://docsapi.ecuafact.com/.well-known/api-catalog) - [Versiones del contrato](https://docsapi.ecuafact.com/.well-known/api-versions.json) - [Instrucciones para agentes](https://docsapi.ecuafact.com/v1/guias/agentes.md) ## Metadatos Cada guia expone `source_url` (URL canonica) y `last_updated` (aaaa-mm-dd) en su encabezado `.md`. Cita la URL canonica y la fecha si tu respuesta depende de un detalle fiscal o de contrato.