Introduccion
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 sistema envia el comprobante en JSON y la plataforma se encarga de validarlo, firmarlo, transmitirlo al SRI y generar el RIDE (el PDF del comprobante).
Base URL#
La API tiene una URL por ambiente. Empieza con la de pruebas y, cuando tu integracion este lista, usa la de produccion.
| Ambiente | Base URL |
|---|---|
| Pruebas (sandbox) | https://staging-api.mynexusapi.com |
| Produccion | https://api.mynexusapi.com |
Todos los ejemplos de esta documentacion usan la URL de pruebas.
Autenticacion#
Cada peticion incluye tu API Key en la cabecera X-Api-Key. Si aun no la
tienes, ve a Autenticacion para saber como obtenerla.
Que puedes hacer#
| Metodo | Ruta | Para que sirve |
|---|---|---|
GET |
/v1/contexto |
Ver tu cliente y los contribuyentes habilitados |
POST |
/v1/contribuyentes/{identificacion}/comprobantes |
Emitir un comprobante |
GET |
/v1/contribuyentes/{identificacion}/comprobantes/emitidos |
Listar comprobantes emitidos |
GET |
/v1/contribuyentes/{identificacion}/comprobantes/{claveAcceso}/ride |
Descargar PDF |
GET |
/v1/contribuyentes/{identificacion}/comprobantes/{claveAcceso}/xml |
Descargar XML |
POST |
/v1/contribuyentes/{identificacion}/comprobantes/{claveAcceso}/correo |
Reenviar el correo |
GET |
/v1/catalogos/{nombre} |
Leer un catalogo SRI |
GET |
/v1/operaciones/{id} |
Consultar el estado de una emision |
GET |
/v1/consumo |
Ver tu cupo disponible |
GET |
/v1/contribuyentes/{identificacion}/perfil |
Ver el perfil del emisor |
PUT |
/v1/contribuyentes/{identificacion}/perfil |
Actualizar el perfil del emisor |
POST |
/v1/contribuyentes/{identificacion}/perfil/logo |
Actualizar el logo del RIDE |
GET |
/v1/consultas/* |
Consultar datos del SRI (contribuyentes, establecimientos, claves) |
Los cambios de estado de una emision tambien se pueden recibir por webhook.
Tipos de comprobante#
Puedes emitir facturas, liquidaciones de compra, notas de credito y debito, guias de remision, comprobantes de retencion y liquidaciones. Cada tipo tiene su propia pagina con los campos que recibe.
Siguientes pasos#
- Primeros pasos: emite tu primer comprobante paso a paso.
- Ciclo de vida del comprobante: entiende que ocurre desde que envias hasta que el SRI autoriza.
- Referencia API: la especificacion OpenAPI interactiva.