API y webhooks SRI

API de facturación electrónica para Ecuador

Integra la emisión de comprobantes electrónicos SRI desde tu ERP, CRM, tienda en línea o sistema interno. Arqueo procesa XML, firma electrónica, autorización, PDF RIDE, correo, webhooks de estado y sincronización hacia sistemas externos.

Activar plan Avanza 
POST /emitir
Authorization: Bearer API_KEY

{
  "cliente": {
    "identificacion": "1790000000001",
    "razonSocial": "Cliente Demo"
  },
  "detalles": [
    {"codigo": "SERV-001", "cantidad": 1, "precioUnitario": 49.90}
  ]
}

Flujo general de integración

Tu sistema envía la venta

ERP, ecommerce, CRM o backend interno envía los datos del comprobante por API.

Arqueo procesa el comprobante

Se genera XML, se firma con el certificado del tenant y se envía al SRI.

Recibes el resultado

La API responde con estado inicial y luego notifica autorización, rechazo o cola mediante webhooks.

Autenticación

Credenciales por tenant, permisos por operación y uso de tokens para separar integraciones internas de usuarios humanos.

Estados

Firmado, en cola, recibido, autorizado, rechazado o error técnico, según el momento del ciclo del comprobante.

Webhooks

Notificaciones firmadas para que tu sistema actualice órdenes, ventas, entregas o contabilidad sin consultar manualmente.

Archivos

Acceso a XML autorizado y PDF RIDE cuando el comprobante termina correctamente.

Conexión SRI ERP

API de lectura para listar comprobantes, actualizar estados contra el SRI y descargar XML/RIDE desde sistemas contables externos.

Conexión SRI ERP

$99 / año + IVA. Sincroniza comprobantes, estados, XML y RIDE.

Agregar API lectura

Webhooks SRI

$49 / año + IVA. Recibe eventos de autorización, rechazo y cambios.

Agregar webhooks

Complemento Conexión SRI ERP

Este servicio adicional permite que un ERP o sistema contable sincronice facturas emitidas en Arqueo, consulte cambios con `updatedSince`, refresque comprobantes pendientes contra el SRI y descargue XML autorizado o RIDE PDF con API key.

GET /api/v1/comprobantes?updatedSince=2026-07-01T00:00:00.000Z
Authorization: Bearer API_KEY

POST /api/v1/comprobantes/{claveAcceso}/actualizar-sri
Authorization: Bearer API_KEY

Ejemplo de respuesta

{
  "data": {
    "estado": "AUTORIZADO",
    "claveAcceso": "2207202601179000000000120010010000001231234567811",
    "numero": "001-001-000000123",
    "archivos": {
      "xml": "https://...",
      "ridePdf": "https://..."
    }
  }
}

Casos de uso

IntegraciónUso típicoValor operativo
ERPEmitir facturas desde ventas aprobadas.Reduce doble digitación y conserva estados SRI.
EcommerceFacturar pedidos pagados en línea.Entrega XML/RIDE al cliente con menos intervención manual.
CRM o SaaSEmitir suscripciones, servicios o renovaciones.Automatiza comprobantes recurrentes y webhooks.

Seguridad, reintentos e idempotencia

La API está pensada para operar con credenciales controladas, validación de tenant, límites por plan y registro de errores. Para evitar duplicados, las integraciones deben usar identificadores propios o referencias internas que permitan detectar reintentos de la misma operación.

Cuando el SRI está saturado, Arqueo puede mantener comprobantes en cola y notificar el resultado posterior. Si el rechazo se debe a datos tributarios, el sistema devuelve el mensaje para corrección.

Preguntas frecuentes de integración

Suscribirme a Avanza