Ir al contenido

SriEmitirFactura

Emite una factura electrónica (tipo 01) ante el SRI de Ecuador. El nodo arma el XML del comprobante, calcula la clave de acceso de 49 dígitos, lo firma digitalmente (XAdES) con el certificado de la credencial y ejecuta el flujo completo en dos pasos: primero la recepción (validación de esquema) y luego la autorización ante el SRI. El comprobante recién es válido cuando el SRI responde AUTORIZADO; que quede RECIBIDA no alcanza.

Si el secuencial no se indica, el nodo lo autonumera por establecimiento y punto de emisión del tenant. El emisor (RUC, razón social, dirección matriz) sale de la credencial sri.

CampoTipoRequeridoDescripción
credentials_idcredentialsSíCredencial del SRI (certificado + RUC)
facturajsonNoFactura en JSON: comprador (tipoIdentificación, identificación, razonSocial), items (con precioUnitario y codigoPorcentajeIva: 4=15%, 0=0%). Secuencial opcional (si no, se autonumera). Si se omite, toma los datos del input del nodo anterior

Este módulo requiere una credencial de tipo sri con los siguientes campos:

  • Certificado (.p12): certificado digital del emisor, en formato PKCS#12
  • Contraseña del certificado: contraseña para abrir el .p12
  • RUC: RUC del emisor (13 dígitos)
  • Ambiente: pruebas (homologación) o producción
{
"claveAcceso": "0512202501179001234500110010010000000011234567811",
"estado": "authorized",
"numeroAutorizacion": "0512202501179001234500110010010000000011234567811",
"fechaAutorizacion": "2025-12-05T14:32:10-05:00",
"total": 113.00,
"iva": 13.00,
"xml": "<?xml version=\"1.0\"?><autorizacion>...</autorizacion>"
}

Si el SRI deja el comprobante EN PROCESAMIENTO, la salida trae estado: "received" y enProceso: true; hay que reconciliar después con SriConsultarAutorización.

Factura por un producto a un consumidor final

Sección titulada «Factura por un producto a un consumidor final»
{
"credentials_id": "cred-sri-prod",
"factura": {
"comprador": {
"tipoIdentificacion": "07",
"identificacion": "9999999999999",
"razonSocial": "CONSUMIDOR FINAL"
},
"items": [
{
"codigo": "0001",
"descripcion": "Camisa de algodón talla M",
"cantidad": 1,
"precioUnitario": 100.00,
"codigoPorcentajeIva": 4
}
]
}
}

Factura a una empresa con cédula/RUC del comprador

Sección titulada «Factura a una empresa con cédula/RUC del comprador»
{
"credentials_id": "cred-sri-prod",
"factura": {
"comprador": {
"tipoIdentificacion": "04",
"identificacion": "1790012345001",
"razonSocial": "Comercial Andina S.A."
},
"items": [
{
"codigo": "SRV-01",
"descripcion": "Servicio de mantenimiento mensual",
"cantidad": 2,
"precioUnitario": 250.00,
"codigoPorcentajeIva": 4
}
]
}
}
  • El comprobante es válido recién cuando el SRI responde AUTORIZADO; RECIBIDA (paso de recepción) no es suficiente.
  • Los códigos de porcentaje de IVA del catálogo SRI usados por el nodo son: 0=0%, 4=15% (tarifa vigente desde 2024).
  • Si el certificado (.p12) de la credencial está vencido, el nodo devuelve error sin intentar emitir.
  • El campo xml de la salida trae el comprobante autorizado devuelto por el SRI (o el XML firmado si el SRI no lo reenvía).