SRI Ecuador — Facturación electrónica (comprobantes electrónicos)

Descripción

Los nodos SRI conectan tus workflows con la facturación electrónica de Ecuador (comprobantes electrónicos del Servicio de Rentas Internas). Floogos arma el XML, calcula la clave de acceso (49 dígitos), lo firma y hace el flujo de recepción y autorización ante el SRI.

Nodo	Qué hace
SRI: Emitir factura (sriEmitirFactura)	Emite una factura (01) → autorización
SRI: Nota de crédito/débito (sriEmitirNota)	Emite NC (04) o ND (05) referenciando el original
SRI: Consultar autorización (sriConsultarAutorizacion)	Estado de un comprobante por su clave de acceso
SRI: RIDE / QR (sriRIDE)	Genera la representación impresa con QR

Flujo de dos pasos: recepción y autorización

El SRI valida en dos etapas. Primero recibe el comprobante (RECIBIDA / DEVUELTA); si fue recibido, se consulta la autorización (AUTORIZADO / NO AUTORIZADO / EN PROCESAMIENTO). El comprobante es válido sólo cuando el SRI lo AUTORIZA — que sea RECIBIDA no alcanza. El IVA general es 15% (desde 2024).

Credencial

Los nodos usan una credencial de tipo SRI. Creala en Credenciales → Agregar → Ecuador SRI con:

Campo	Descripción
Certificado (.p12)	Tu certificado digital, base64.
Contraseña del certificado	La clave del .p12.
RUC y Razón social	Datos del emisor (RUC de 13 dígitos).
Ambiente	Pruebas o Producción.
Establecimiento y Punto de emisión	Los códigos (ej. 001 / 001).
Obligado a contabilidad	SI / NO.

El flujo completo

1. Preparás el comprobante como JSON (comprador, ítems con precioUnitario y codigoPorcentajeIva).

2. Emitís con Emitir factura. Floogos arma el XML, calcula la clave de acceso, firma, envía a recepción y consulta la autorización.

3. Si quedó EN PROCESAMIENTO, lo reconciliás con Consultar autorización.

4. Generás el RIDE con RIDE / QR para entregar/imprimir el comprobante.

Emitir una factura

Nodo: SRI: Emitir factura. Ejemplo:

{
  "comprador": { "tipoIdentificacion": "04", "identificacion": "1791234567001", "razonSocial": "Cliente SA" },
  "items": [
    { "codigo": "P1", "descripcion": "Producto", "cantidad": 2, "precioUnitario": 50, "codigoPorcentajeIva": 4 }
  ]
}

codigoPorcentajeIva: 4 = 15%, 0 = 0%, 7 = exento, 6 = no objeto. El precioUnitario va sin IVA. El secuencial se autonumera si no lo pasás. tipoIdentificacion del comprador: 04 RUC, 05 cédula, 06 pasaporte, 07 consumidor final.

Notas de crédito y débito

Nota de crédito/débito emite una NC (04) o ND (05) que referencia el documento modificado (docModificado):

{
  "tipo": "04",
  "motivo": "Devolución de mercadería",
  "docModificado": { "tipo": "01", "numero": "001-001-000000001", "fecha": "2026-07-20" },
  "comprador": { "tipoIdentificacion": "04", "identificacion": "1791234567001" },
  "items": [ { "descripcion": "Producto", "cantidad": 1, "precioUnitario": 100, "codigoPorcentajeIva": 4 } ]
}

La nota de débito (05) usa motivos (razón + valor) en vez de items.

Consultar la autorización

Consultar autorización consulta un comprobante por su clave de acceso y devuelve si está AUTORIZADO, NO AUTORIZADO o EN PROCESAMIENTO, actualizando el estado en la base. Útil cuando la emisión quedó en procesamiento.

RIDE (representación con QR)

RIDE / QR genera la Representación Impresa del Documento Electrónico en HTML (exportable a PDF), con el número de autorización, la clave de acceso y el QR que la contiene.

Manejo de errores

Situación	Reintentable	Qué hacer
DEVUELTA (recepción)	No	El SRI devolvió el comprobante con mensajes de error. Corregí el XML.
NO AUTORIZADO	No	El SRI no autorizó; revisá los mensajes.
Certificado vencido	No	Renová el .p12 y actualizá la credencial.
Red / Timeout	Sí	Problema pasajero; se reintenta automáticamente.

Firma XAdES-BES y ambiente de pruebas

El SRI exige firma XAdES-BES. Antes de producción, probá en el ambiente de pruebas del SRI y validá la firma (QualifyingProperties) y la estructura XML contra el XSD del SRI.

Ver también

• Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones que fallan.
• Nodo HTTP — para servicios no cubiertos por estos nodos.