DgiiEmitirNota

Descripción

Emite una Nota de Débito (33) o una Nota de Crédito (34) ante la DGII de República Dominicana, referenciando el e-NCF del e-CF que se está modificando. El nodo arma el XML de la nota con los datos de referencia, comprador e ítems, lo firma con XMLDSig usando el certificado .p12 de la credencial, se autentica con el mecanismo de semilla y realiza la recepción.

Igual que la emisión de facturas, devuelve el TrackId, el e-NCF de la nota y el código de seguridad, y puede consultar el estado final en el mismo paso.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial dgii
nota	json	No	Nota en JSON: tipo (33 débito, 34 crédito), informacionReferencia (ncfModificado, fecha, codigoModificación), comprador, items (precioUnitario sin ITBIS). Si se deja vacío se usan los datos de entrada del nodo
consultar_estado	boolean	No	Consultar el estado de la nota 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 nota.

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 la nota (9 a 11 dígitos)
• Ambiente: test, cert (certificación) o prod (producción)

Salida

{
  "encf": "E340000000045",
  "tipo": "34",
  "trackId": "TR-2026-000123789",
  "estado": "accepted",
  "codigoSeguridad": "Kx9pQ2",
  "total": 236,
  "itbis": 36,
  "ncfModificado": "E310000000123",
  "mensajes": [],
  "xmlFirmado": "<ECF>...firmado...</ECF>"
}

Ejemplo de Uso

Nota de crédito por devolución parcial

{
  "credentials_id": "cred-dgii-prod",
  "nota": {
    "tipo": "34",
    "informacionReferencia": {
      "ncfModificado": "E310000000123",
      "fecha": "2026-08-01",
      "codigoModificacion": "1"
    },
    "comprador": {
      "rnc": "130123456",
      "razonSocial": "Cliente SRL"
    },
    "items": [
      { "descripcion": "Devolución parcial de servicio", "cantidad": 1, "precioUnitario": 200 }
    ]
  }
}

Notas

• El campo nota.items es obligatorio y debe tener al menos un ítem; si falta, el nodo devuelve error sin firmar ni enviar nada.
• Es obligatorio referenciar el e-NCF de origen en informacionReferencia.ncfModificado; sin ese dato el nodo rechaza la nota antes de armar el XML.
• Si el certificado .p12 de la credencial está vencido, el nodo rechaza la emisión.
• La nota queda ligada al e-CF original en la base de datos, lo que permite trazar el historial completo de modificaciones de un comprobante.

Nodos Relacionados

• DgiiEmitirFactura - Emitir la factura original que la nota va a referenciar
• DgiiConsultarEstado - Consultar el estado final por TrackId
• DgiiRepresentación - Generar la representación impresa con QR