La API

REST sobre /api/v1, JSON en snake_case, autenticación con Bearer. Envelope uniforme en todas las respuestas: { success, message, data, errors }.

Autenticación

Crea un token desde el portal (Configuración → Tokens de API) y mándalo en cada petición. El emisor sale del token, nunca del cuerpo: no hay forma de emitir en nombre de otro contribuyente.

curl https://tu-dominio/api/v1/facturas \
  -H "Authorization: Bearer flt_xxxxxxxxxxxx"

Emitir una factura

Describe el hecho —qué vendiste, cuánto, con qué código de IVA— y el sistema calcula, firma y transmite. No envías totales ni tarifas: los calcula el servidor desde el catálogo vigente a la fecha de emisión.

curl -X POST https://tu-dominio/api/v1/facturas \
  -H "Authorization: Bearer flt_xxxxxxxxxxxx" \
  -H "Idempotency-Key: 4f0c1c2e-..." \
  -H "Content-Type: application/json" \
  -d '{
    "establecimiento": "001",
    "punto_emision": "010",
    "receptor": {
      "tipo_identificacion": "05",
      "identificacion": "0912345675",
      "razon_social": "JUAN PEREZ",
      "email": "juan@ejemplo.ec"
    },
    "detalles": [{
      "codigo_principal": "SRV-1",
      "descripcion": "Servicio",
      "cantidad": "1.000000",
      "precio_unitario": "100.000000",
      "impuestos": [{ "codigo": "2", "codigo_porcentaje": "4" }]
    }],
    "pagos": [{ "forma_pago": "20", "total": "115.00" }]
  }'

La Idempotency-Key es obligatoria. Reintentar la misma petición no emite dos facturas — y en facturación electrónica un duplicado es un secuencial quemado y un comprobante que hay que anular.

Sandbox

Tu cuenta arranca en el ambiente de Pruebas del SRI. Lo que emitas ahí no tiene valor fiscal: sirve para comprobar tu integración antes de pasar a producción.

Referencia

Estos endpoints se listan desde las rutas reales del servidor: si aparece aquí, existe.