⚡ API REST de facturación · SRI Ecuador

Factura al SRI con una llamada REST

Emite facturas, notas de venta y retenciones autorizadas por el SRI desde tu propio sistema. Nosotros manejamos la firma, la clave de acceso y el SRI. Tú haces un POST.

Sandbox gratis Webhooks firmados MCP para agentes
emitir una factura
# Emite y el SRI autoriza en tiempo real
curl -X POST https://facturacobra.com/api/v1/documents \
  -H "Authorization: Bearer mfact_tu_llave" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo": "01",
    "comprador": { "identificacion": "1790012345001" },
    "items": [{ "descripcion": "Consultoría",
                "cantidad": 1, "precio": 50.00,
                "iva_codigo": "4" }]
  }'

# → respuesta
{ "estado": "AUTORIZADA",
  "clave_acceso": "18072026...819",
  "total": 57.50 }
Tres pasos para tu primera factura

Empieza en minutos

Crea una llave, apunta al sandbox y emite. Sin contratos, sin integraciones eternas.

🔑

1 · Crea tu llave

En Cobra: Config → Desarrolladores → Nueva llave. Eliges permisos y ambiente. La copias una vez.

🧪

2 · Prueba en sandbox

Con la llave en ambiente de pruebas, emites contra el SRI sin consecuencias fiscales.

🚀

3 · Pasa a producción

Cuando todo funcione, usas una llave de producción y ya facturas de verdad.

Funciona igual desde curl, Python, Node o PHP: es HTTP + JSON. Los snippets por lenguaje están en la documentación.

La API

Endpoints principales

Base: https://facturacobra.com/api/v1

POST
/documents
Emite factura, NC, ND o retención
GET
/documents
Lista tus comprobantes
GET
/documents/:id
Estado y detalle de un comprobante
POST
/documents/:id/anular
Guía la anulación según el SRI
GET
/sri-lookup/:ruc
Valida un RUC en el catastro
POST
/contacts
Crea un cliente
POST
/products
Crea un producto o servicio
POST
/webhooks
Registra un webhook firmado (HMAC)
GET
/webhooks
Lista tus webhooks
GET
/whoami
Negocio, permisos y ambiente de la llave

Ver referencia completa (OpenAPI) →

Autenticación

Una llave, una cabecera

Cada petición lleva tu llave mfact_... en la cabecera Authorization. Cada llave declara permisos (leer, emitir, anular) y ambiente (pruebas o producción). La revocas cuando quieras desde tu panel.

🔑 auth
Authorization: Bearer mfact_ab12cd_...
Webhooks

Te avisamos al autorizar

Registra una URL y te enviamos un POST firmado cuando un comprobante queda autorizado o rechazado. Verificas la firma HMAC-SHA256 y actúas.

🔔 webhook headers
X-Cobra-Signature: sha256=<hex>
X-Cobra-Timestamp: 1721270000
Moderno por dentro

Adiós al webservice SOAP del SRI

Nosotros hablamos SOAP y XAdES con el SRI para que tú no tengas que hacerlo.

😵 El camino directo al SRI

  • Webservice SOAP y XML por armar a mano
  • Firma XAdES-BES con tu .p12
  • Clave de acceso de 49 dígitos con Módulo 11
  • Reintentos y parseo de códigos de error

💚 Con Cobra API

  • REST + JSON, una llamada
  • Firma y clave de acceso resueltas por Cobra
  • Estados legibles y webhooks firmados
  • Sandbox, MCP y documentación OpenAPI
¿Y la IA?

¿Prefieres que lo haga un agente?

La misma facturación está disponible como servidor MCP: conecta Claude o ChatGPT y factura al SRI con lenguaje natural.

Conoce Cobra MCP →

Dudas

Preguntas frecuentes

¿Cómo emito una factura del SRI con la API?

Haces un POST a /api/v1/documents con tu llave en la cabecera Authorization: Bearer. La API firma el comprobante, lo envía al SRI y te devuelve la clave de acceso y el estado de autorización. Funciona con curl, Python, Node o PHP.

¿Usan el webservice SOAP del SRI?

No para ti. Cobra expone REST + JSON. Por dentro manejamos la firma XAdES, la clave de acceso y la comunicación SOAP con el SRI; tú solo haces llamadas REST.

¿Hay ambiente de pruebas?

Sí. Cada llave apunta al sandbox (pruebas) del SRI o a producción. Pruebas gratis y pasas a producción cuando estés listo.

¿Qué comprobantes puedo emitir?

Factura (01), nota de crédito (04), nota de débito (05) y comprobante de retención, con las validaciones del SRI aplicadas por la API.

¿Cuánto cuesta?

El sandbox es gratis. Para emitir en producción usas tu plan de Cobra. Crea tu cuenta y obtén tu llave.

Tu primera factura por API, hoy

Crea tu cuenta, genera una llave y empieza en el sandbox. Gratis.