SifenEnviarLote

Descripción

Envía un lote de hasta 50 Documentos Electrónicos (DE) a SIFEN de forma asíncrona (siRecepLoteDE). El nodo firma cada DE individualmente con el certificado .p12 de la credencial, los agrupa (comprimidos y en base64) y los envía en una sola llamada. La DNIT devuelve un protocolo de consulta (dProtConsLote) que se usa después con el nodo SifenConsultarLote para conocer el resultado de cada documento.

Es la opción recomendada frente a SifenEmitirDE cuando hay que emitir varios comprobantes en simultáneo, ya que evita hacer una llamada síncrona por cada uno.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial de SIFEN
documentos	json	No	Lista de DE (JSON array), máximo 50. Si se deja vacío se usan los datos de entrada (array o un objeto con documentos)

Credenciales

Este módulo requiere una credencial de tipo sifen (certificado .p12, RUC, establecimiento, punto de expedición y ambiente). Ver el detalle de campos en SifenEmitirDE.

Salida

{
  "success": true,
  "protocolo": "987654321",
  "count": 3,
  "codigo": "0260",
  "mensaje": "Lote recibido",
  "cdcs": [
    "01800123456001001000001234567890123456789012",
    "01800123456001001000001234567890123456789013",
    "01800123456001001000001234567890123456789014"
  ]
}

Ejemplo de Uso

{
  "credentials_id": "cred-sifen-prod",
  "documentos": [
    {
      "tipoDE": 1,
      "numero": 2,
      "receptor": { "ruc": "80012345-6", "razonSocial": "Empresa Cliente S.A." },
      "items": [{ "descripcion": "Producto A", "cantidad": 2, "precioUnitario": 150000, "ivaTipo": 10 }]
    },
    {
      "tipoDE": 1,
      "numero": 3,
      "receptor": { "ruc": "80098765-4", "razonSocial": "Otro Cliente S.R.L." },
      "items": [{ "descripcion": "Producto B", "cantidad": 1, "precioUnitario": 300000, "ivaTipo": 10 }]
    }
  ]
}

Notas

• El lote admite un máximo de 50 documentos; si se supera, el nodo rechaza el envío antes de contactar a SIFEN
• Cada DE queda persistido en estado “firmado” antes del envío, para trazabilidad aunque falle la comunicación
• El resultado no llega en esta llamada: hay que consultar el protocolo devuelto con SifenConsultarLote
• Cada DE del lote comparte el mismo emisor (RUC, establecimiento y punto de expedición de la credencial), salvo que se indique otro en cada documento

Nodos Relacionados

• SifenConsultarLote - Consultar el resultado de un lote enviado
• SifenEmitirDE - Emitir un único DE de forma síncrona