DgiiEmitirFactura

Descripción

Emite un Comprobante Fiscal Electrónico (e-CF) de tipo Factura ante la DGII de República Dominicana: Factura de Crédito Fiscal (31) o Factura de Consumo (32). El nodo arma el XML del e-CF con los datos del emisor, comprador e ítems, lo firma digitalmente con XMLDSig usando el certificado .p12 de la credencial, se autentica ante la DGII con el mecanismo de semilla y realiza la recepción.

Como resultado devuelve el TrackId asignado por la DGII, el e-NCF (número de comprobante fiscal electrónico) y el código de seguridad del comprobante. Opcionalmente, el mismo nodo puede consultar el estado final inmediatamente después de la recepción.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial dgii
factura	json	No	Factura en JSON: tipo (31 crédito fiscal, 32 consumo), comprador (rnc, razonSocial — el 31 requiere RNC), items (precioUnitario sin ITBIS). Si se deja vacío se usan los datos de entrada del nodo
consultar_estado	boolean	No	Consultar el estado del e-CF inmediatamente después de la recepción (por defecto sí)

El emisor (RNC, razón social) se completa automáticamente desde la credencial cuando no viene en factura.

Credenciales

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

• Certificado digital (.p12): certificado de firma en base64 (alternativamente, clave privada + certificado en PEM)
• Contraseña del certificado: contraseña del .p12
• RNC del emisor: RNC de la empresa que emite el comprobante (9 a 11 dígitos)
• Ambiente: test, cert (certificación) o prod (producción)

Salida

{
  "encf": "E310000000123",
  "tipo": "31",
  "trackId": "TR-2026-000123456",
  "estado": "accepted",
  "codigoSeguridad": "Ab3xZ9",
  "total": 1180,
  "itbis": 180,
  "mensajes": [],
  "xmlFirmado": "<ECF>...firmado...</ECF>"
}

Ejemplo de Uso

Factura de Crédito Fiscal con un ítem gravado al 18%

{
  "credentials_id": "cred-dgii-prod",
  "factura": {
    "tipo": "31",
    "comprador": {
      "rnc": "130123456",
      "razonSocial": "Cliente SRL"
    },
    "items": [
      { "descripcion": "Servicio de consultoría", "cantidad": 1, "precioUnitario": 1000 }
    ]
  }
}

Notas

• El campo factura.items es obligatorio y debe tener al menos un ítem; si falta, el nodo devuelve error sin firmar ni enviar nada.
• La Factura de Crédito Fiscal (31) requiere el RNC del comprador; la Factura de Consumo (32) no lo exige.
• Si el certificado .p12 de la credencial está vencido, el nodo rechaza la emisión antes de armar el XML.
• El e-CF puede quedar en received (recibido, sin resolver) si consultar_estado está en falso; para conocer el resultado final hay que usar DgiiConsultarEstado más tarde.

Nodos Relacionados

• DgiiEmitirNota - Emitir nota de crédito o débito referenciando este e-CF
• DgiiConsultarEstado - Consultar el estado final por TrackId
• DgiiRepresentación - Generar la representación impresa con QR