SriEmitirNota

Descripción

Emite una Nota de Crédito (tipo 04) o una Nota de Débito (tipo 05) ante el SRI de Ecuador. Ambas referencian el documento modificado (docModificado: tipo, número y fecha de la factura original). El nodo arma el XML, calcula la clave de acceso, lo firma y ejecuta el mismo flujo de dos pasos que la factura: recepción y autorización.

La Nota de Crédito lleva items (igual que una factura, para anular o corregir montos); la Nota de Débito lleva motivos[] (razón y valor) para cargos adicionales sobre el documento original.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial del SRI
nota	json	No	Nota en JSON: tipo (04 crédito, 05 débito), comprador, docModificado (tipo, número, fecha). La NC lleva items; la ND lleva motivos[] (razón, valor). Si se omite, toma los datos del input del nodo anterior

Credenciales

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

Salida

{
  "claveAcceso": "0512202504179001234500110010010000000021234567822",
  "tipo": "04",
  "estado": "authorized",
  "numeroAutorizacion": "0512202504179001234500110010010000000021234567822",
  "docModificado": { "tipo": "01", "numero": "001-001-000000001" },
  "total": 100.00,
  "xml": "<?xml version=\"1.0\"?><autorizacion>...</autorizacion>"
}

Ejemplo de Uso

Nota de crédito por devolución total de una factura

{
  "credentials_id": "cred-sri-prod",
  "nota": {
    "tipo": "04",
    "comprador": {
      "tipoIdentificacion": "05",
      "identificacion": "1712345678",
      "razonSocial": "Juan Pérez"
    },
    "docModificado": {
      "tipo": "01",
      "numero": "001-001-000000001",
      "fecha": "2025-12-01"
    },
    "motivo": "Devolución de mercadería",
    "items": [
      {
        "codigo": "0001",
        "descripcion": "Camisa de algodón talla M",
        "cantidad": 1,
        "precioUnitario": 100.00,
        "codigoPorcentajeIva": 4
      }
    ]
  }
}

Nota de débito por un cargo adicional

{
  "credentials_id": "cred-sri-prod",
  "nota": {
    "tipo": "05",
    "comprador": {
      "tipoIdentificacion": "04",
      "identificacion": "1790012345001",
      "razonSocial": "Comercial Andina S.A."
    },
    "docModificado": {
      "tipo": "01",
      "numero": "001-001-000000002",
      "fecha": "2025-12-01"
    },
    "motivos": [
      { "razon": "Intereses por mora", "valor": 12.50 }
    ]
  }
}

Notas

• El motivo (Nota de Crédito) y el docModificado son obligatorios; sin el documento referenciado el SRI rechaza la nota.
• Igual que la factura, la nota es válida recién cuando el SRI la AUTORIZA.
• Si la nota queda EN PROCESAMIENTO, reconciliá el estado con SriConsultarAutorización.

Nodos Relacionados

• SriEmitirFactura - Emitir la factura original a referenciar
• SriConsultarAutorización - Reconciliar comprobantes EN PROCESAMIENTO
• SriRIDE - Generar el RIDE con QR de la nota emitida