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 y webhooks de estado.

Activar plan Pro 
POST /emitir-factura
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.

Ejemplo de respuesta

{
  "estado": "AUTORIZADO",
  "claveAcceso": "2207202601179000000000120010010000001231234567811",
  "numero": "001-001-000000123",
  "xmlUrl": "https://...",
  "rideUrl": "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 Pro