SifenEmitirDE

Descripción

Emite un Documento Electrónico (factura, nota de crédito, nota de débito o remisión) ante SIFEN, el Sistema Integrado de Facturación Electrónica Nacional de la DNIT en Paraguay (conocido también como e-Kuatia). El nodo arma el XML del DE, calcula el CDC (Código de Control), lo firma con el certificado digital .p12 de la credencial y lo envía por SOAP con TLS mutuo (siRecepDE).

El envío es síncrono e idempotente por número de comprobante: si la numeración (establecimiento, punto de expedición y número) ya fue aprobada antes, el nodo no vuelve a emitir y devuelve el CDC existente.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial de SIFEN (certificado .p12, RUC y ambiente)
de	json	No	Documento Electrónico en JSON. Si se deja vacío se usan los datos de entrada. El emisor se completa desde la credencial si falta

Credenciales

Este módulo requiere una credencial de tipo sifen con:

• Certificado (.p12): certificado digital del contribuyente, en base64
• Contraseña del certificado: para abrir el .p12
• RUC del emisor: con o sin dígito verificador
• DV del RUC: dígito verificador (opcional, se completa desde la credencial)
• Establecimiento y punto de expedición: numeración habilitada ante la DNIT
• ID CSC y CSC: Código de Seguridad del Contribuyente, usado para el QR del KuDE
• Ambiente: test (SIFEN Test) o prod (SIFEN producción)

Salida

{
  "success": true,
  "cdc": "01800123456001001000001234567890123456789012",
  "estado": "Aprobado",
  "protocolo": "123456789",
  "codigo": "0260",
  "mensaje": "Autorizado",
  "totals": { "totalOpe": 1000000, "totalIVA": 90909 },
  "xml": "<rDE>...</rDE>"
}

Ejemplo de Uso

{
  "credentials_id": "cred-sifen-prod",
  "de": {
    "tipoDE": 1,
    "numero": 1,
    "receptor": {
      "ruc": "80012345-6",
      "razonSocial": "Empresa Cliente S.A.",
      "email": "cliente@empresa.com.py"
    },
    "items": [
      {
        "descripcion": "Servicio de consultoría",
        "cantidad": 1,
        "precioUnitario": 2500000,
        "ivaTipo": 10
      }
    ]
  }
}

Notas

• El CDC tiene 44 dígitos y es el identificador único del DE ante la DNIT; se usa para consultarlo, cancelarlo y generar el KuDE
• Es idempotente por numeración: reintentar el mismo establecimiento/punto/número ya aprobado devuelve el CDC existente (idempotent: true) en lugar de reemitir
• El envío usa TLS mutuo: la credencial autentica la conexión con SIFEN, no solo firma el documento
• Si la DNIT rechaza el DE, el nodo devuelve error con el código y el mensaje de rechazo

Nodos Relacionados

• SifenEnviarLote - Enviar varios DE de forma asíncrona
• SifenConsultarDE - Consultar el estado de un DE por su CDC
• SifenCancelarDE - Cancelar un DE ya aprobado
• SifenKuDE - Generar el KuDE (PDF/QR) del DE