DgiEnviarReceptor

Descripción

Envía al receptor un Comprobante Fiscal Electrónico (CFE) ya emitido. El nodo lo envuelve en un Sobre firmado (con Carátula que identifica emisor y receptor), lo firma digitalmente y lo POSTea al endpoint SOAP del receptor usando TLS mutuo (el certificado de la credencial se usa también para la conexión). Luego procesa el Acuse de Recibo devuelto y actualiza el estado del CFE (enviado, aceptado o rechazado).

El CFE a enviar se puede identificar por tipo, serie y número (el nodo recupera el XML firmado que quedó guardado al emitirlo) o pasarse directamente el XML firmado en la entrada, por ejemplo encadenado desde DgiEmitirCFE.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial dgi
receptor_url	text	Sí	Endpoint SOAP del receptor (es por-receptor, cada cliente tiene el suyo)
tipo_cfe	text	No	Tipo del CFE a enviar (para recuperarlo de la base)
serie	text	No	Serie del CFE a enviar
número	text	No	Número del CFE a enviar
rut_receptor	text	No	RUT del receptor (para la Carátula del Sobre)
soap12	boolean	No	Usar SOAP 1.2 en vez de 1.1 (según lo que exponga el receptor)

Hay que completar tipo_cfe + serie + numero, o pasar el XML firmado en la entrada del nodo; si no se encuentra el CFE firmado, el nodo devuelve error.

Credenciales

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

• Certificado (.p12): certificado de firma avanzada en base64 (se usa también para el TLS mutuo)
• Contraseña del certificado: contraseña del .p12
• RUT: RUT del emisor
• Entorno: test (homologación) o prod (producción)

Salida

{
  "enviado": true,
  "aceptado": true,
  "estado": "acked",
  "codigo": "00",
  "glosa": "Comprobante aceptado",
  "tipoCfe": 111,
  "serie": "A",
  "numero": 159
}

Ejemplo de Uso

{
  "credentials_id": "cred-dgi-prod",
  "receptor_url": "https://receptor.example.com/wsefactura",
  "tipo_cfe": "111",
  "serie": "A",
  "numero": "159",
  "rut_receptor": "212345670010"
}

Notas

• Si el receptor devuelve un SOAP Fault, el nodo lo interpreta como error y no da por enviado el comprobante.
• El estado del CFE queda registrado como acked cuando el receptor confirma la recepción, o sent si se envió pero aún no hay acuse.
• La conexión al endpoint del receptor usa el mismo certificado .p12 de la credencial para el TLS mutuo, no un certificado separado.
• Cada receptor puede tener su propio endpoint SOAP; receptor_url conviene resolverlo dinámicamente por cliente en el workflow (por ejemplo, desde un CRM o base de datos).

Nodos Relacionados

• DgiEmitirCFE - Emitir el CFE antes de enviarlo
• DgiReporteDiario - Reportar el CFE a la DGI
• DgiConsultarCFE - Verificar el estado de un CFE