3Convenciones utilizadas en el formato JSON

3.1 Columnas de las tablas de definición

Tabla 2 — Significado de cada columna en las tablas del NUC

TítuloDescripción
CConjunto de campos
IDIdentificador del campo, para fines de referencia
CampoNombre del campo
DescripciónDescripción del campo y su significado
PReferencia al ID del campo del grupo que contiene este campo específico (padre)
TTipo de dato (ver Tabla 3)
TamTamaño del campo (ver Tabla 4)
OcuOcurrencias en el formato m-n, en el cual m: número mínimo de veces que el campo debe aparecer en el grupo; n: número máximo de veces que el campo puede aparecer en el grupo. Cabe recalcar que si un campo contiene un valor de 1-n, este campo es Obligatorio. Si un campo contiene un valor de 0-n, este campo es Opcional.
ObservacionesObservaciones importantes sobre el elemento, incluyendo listas de posibles valores, validaciones relevantes, entre otras.

3.2 Tipos de dato en el archivo JSON

Tabla 3 — Tipos de dato

TipoDescripción
JSONDocumento JSON, descrito en un schema contenido en esta ficha técnica
OObjeto JSON y/o grupos de elementos
AAlfanumérico
NNumérico: ver diversos formatos en la Tabla 4
FFecha: Los campos de fecha deberán siempre contener fecha y hora en el formato UTC (Universal Coordinated Time), o sea: AAAA-MM-DDThh:mm:ssTZH. Por ejemplo, para expresar 2:23 PM de 17 de abril de 2017, en la zona horaria GMT -5 (hora de Panamá): 2017-04-17T14:23:00-05:00
LArreglo o Lista: Atributo de tipo arreglo que puede contener "n" cantidad de objetos o datos
IInformación Adicional: Objeto que contiene atributos para describir la información. Los atributos que contiene son: Name: Nombre o identificador de la información a agregar; Data: Dato adicional de la información; Value: Valor que corresponde al Name/Nombre de la información a agregar. Estructura del elemento: { "Name": "", "Data": "", "Value": "" }. Ejemplo: { "Name": "IndicadorEnvioDiferido", "Data": null, "Value": "1" }

3.3 Tamaños de los campos

Tabla 4 — Formato de tamaños

FormatoDescripción
xTamaño exacto del campo. Ejemplo: 5
x-yTamaño mínimo de "x", máximo de "y". Ejemplo: 0-10 (en este caso es posible expresar ningún valor, porque se permite el tamaño "0")
xpnTamaño de "x" enteros, y con "n" casillas decimales. Ejemplo: si el tamaño es 5p3, es válido 54321.103
xpn-mTamaño de "x" enteros, y con un mínimo de "n" casillas decimales y un máximo de "m" casillas decimales. Ejemplo: 11p0-6
x-ypn-mTamaño mínimo de "x" enteros, máximo de "y" enteros; y con un mínimo de "n" casillas decimales y un máximo de "m" casillas decimales. Ejemplo: 1-11p0-6 (es obligatorio expresar algún valor en la parte entera, porque no se permite el tamaño "0", pero la parte decimal es opcional)

4Formato del NUC

4.1 Información que debe contener el NUC

Tabla 5 — Conjuntos de campos del NUC

ConjuntoDescripción
RCampos que contienen información para la generación de la factura electrónica
ACampos que contienen información general de la Factura Electrónica
BCampos que contienen la información del emisor de la transacción documentada
CCampos que contienen la información del receptor de la transacción documentada
DCampos que contienen información sobre terceros
ECampos que describen cada ítem de la transacción documentada
FCampos que describen los subtotales y totales de la transacción documentada
GCampos que describen las formas de pago
HCampos que describen información adicional sobre la transacción documentada
HAInformación Adenda Comercial
⚠️

La API es case-sensitive. Los nombres de los campos y datos que hagan referencia a información deben ingresarse respetando mayúsculas y minúsculas exactamente como se especifican.

4.1Secuencia Autorizada por la DGII (eNCF)

Para la identificación única de una factura, se necesita implementar secuencia alfanumérica que identifica un comprobante fiscal electrónico otorgado por la Dirección General de Impuestos Internos, que identifica de manera única la factura que queda en responsabilidad del contribuyente. Nota: El API genera el eNCF correspondiente a los datos que se ingresaron en el contenido del NUC, por lo que no se deberá agregar este campo. Composición (Tabla 5): Serie (tamaño 1, secuencias que inician con la serie E) + Tipo de Documento (A02 DocType, tamaño 2) + Secuencial (AI02 Secuencia, número secuencial de 10 dígitos). Tamaño total del eNCF: 13. Ejemplo: E320000000014 (Serie E, tipo 32, secuencial 0000000014).

4.3.1Schema NUCConjunto R

Importante. Los nombres de los campos y datos que hagan referencia a información deben ser ingresados tomando en cuenta las mayúsculas y minúsculas, es decir, el API es case sensitive por lo que si no se ingresan los valores como se espera, la aplicación no podrá generar el texto equivalente a la Factura Electrónica.

CIDCampoDescripciónPTTamOcuObservaciones
RR01RootNUC (raíz)RaízJSON1-1
RR02VersionVersión del formato de la factura electrónicaR01A1-p21-1
Control de versiones. Valor a ingresar: 1.00
RR03CountryCodeCódigo del país donde pertenece la factura electrónica a generarR01A21-1
Único valor permitido DO: República Dominicana

4.3.2.1Grupo AdditionalIssueDocInfo

CIDCampoDescripciónPTTamOcuObservaciones
AI02SecuenciaSecuencia del documento electrónico.N101-1
Llenar con ceros las posiciones de la izquierda.
AI03FechaVencimientoSecuenciaFecha de vencimiento de la secuencia de e-NCF.A100-1
Obligatorio para todos los documentos excepto en Factura de consumo electrónica (32) o Nota de Crédito electrónica (34). El formato debe ser AAAA-MM-DD. Ejemplo: 2025-12-31
AI04IndicadorNotaCreditoIndicador de nota de crédito mayor a 30 días.N10-1
Únicamente usar en caso de que A02 = 34 (Nota de Crédito Electrónica). Válido solo para Notas de Crédito que no tienen derecho a rebajar ITBIS. El indicador tomará valor 1 si la fecha es mayor a 30 días calendario de la emisión del e-CF afectado. De lo contrario colocar como valor 0.
AI05IndicadorEnvioDiferidoIdentifica a los contribuyentes que han sido previamente autorizados a tener ventas a través de dispositivos móviles offline, takes como ventas con Handheid, entre otros.N10-1
Válido para todos los documentos excepto Compras Electrónico (41) y Pagos Exterior Electrónico (47). Valor permitido: 1: Envío diferido autorizado.
AI06IndicadorMontoGravadoIndica si en la línea de detalle, el monto se encuentra con ITBIS incluido (impuestos adicionales no están incluídos en el precio del ítem).N10-1
Valor 0 si los montos en las líneas de los ítems no tienen el ITBIS incluido. Valor 1 si los montos en las líneas de los ítems se encuentran con el ITBIS incluido. Válido para todos los documentos excepto documentos 43, 46 y 47.
AI07TipoIngresosIndica el tipo de ingreso recibido, según clasificación del formato de envío de ventas de Bienes o servicios.N20-1
01: Ingresos por operaciones (No financieros); 02: Ingresos Financieros; 03: Ingresos Extraordinarios; 04: Ingresos por Arrendamientos; 05: Ingresos por Venta de Activo Despreciable; 06: Otros ingresos. Válido para todos los documentos excepto documentos 41, 43 y 47.
Valores permitidos
  • 01 · Ingresos por operaciones (No financieros)
  • 02 · Ingresos Financieros
  • 03 · Ingresos Extraordinarios
  • 04 · Ingresos por Arrendamientos
  • 05 · Ingresos por Venta de Activo Despreciable
  • 06 · Otros ingresos
AI08TipoPagoIndica el tipo de pago del cliente.N10-1
1: Contado; 2: Crédito; 3: Gratuito
Valores permitidos
  • 1 · Contado
  • 2 · Crédito
  • 3 · Gratuito
AI09FechaLimitePagoFecha límite en la que se puede realizar el pago.A100-1
Condicional a que el tipo de pago (AI08) sea a crédito. La fecha límite debe ser mayor que la fecha de emisión del documento. El formato debe ser AAAA-MM-DD. Válido para todos los documentos excepto documento 43.
AI10TerminoPagoIndica el tiempo establecido para el pago de la factura y se debe especificar si el mismo es en horas, días, semanas, meses u otro.A1-150-1
Ejemplo: 1) 72 horas 2) 120 días. Válido para todos los documentos excepto documentos 34 y 43.
AI11TipoCuentaPagoCuenta de origen de la transferencia o del cheque.A20-1
CT: Cuenta corriente; AH: Ahorro; OT: Otra. Válido para todos los documentos excepto documentos 34 y 43.
Valores permitidos
  • CT · Cuenta corriente
  • AH · Ahorro
  • OT · Otra
AI12NumeroCuentaPagoNúmero de la cuenta si la forma de pago es por cheque o transferencia bancaria.A1-280-1
Válido para todos los documentos excepto documentos 34 y 43.
AI13BancoPagoBanco de la cuentaA1-750-1
Válido para todos los documentos excepto documentos 34 y 43.
AI14FechaDesdeFecha inicial del servicio facturado.A100-1
Período de facturación para Servicios Periódicos Ej. Energía eléctrica, telefónica, otros. El formato debe ser AAAA-MM-DD. Válido para todos los documentos excepto documentos 41 y 43.
AI15FechaHastaFecha final del servicio facturado.A100-1
Período de facturación para Servicios Periódicos Ej. Energía eléctrica, telefónica, otros. El formato debe ser AAAA-MM-DD. Válido para todos los documentos excepto documentos 41 y 43.
AI16TotalPaginasIndica el total de páginas en la que será impreso el e-CF. Cuenta las veces que se repite el campo Páginas No. de la sección Paginación.N30-1
Debe existir paginación.
AAI02AsignacionDeSecuenciaSecuencia electrónica asignada automáticamente por Digifact, utilizando las secuencias registradas y vigentes en el portal web.A01N10-1
Método de asignación automática de secuencias en el que Digifact administra y selecciona el e-NCF a utilizar según las secuencias registradas y vigentes por el contribuyente en el módulo Gestión de Secuencias del portal web. Al utilizar este método, no es necesario enviar una secuencia específica en cada documento, ya que Digifact asigna automáticamente el e-NCF correspondiente de acuerdo con la configuración realizada por el cliente. Esto permite centralizar y simplificar la administración de secuencias electrónicas. Ejemplo: AsignacionDeSecuencia: 1

4.3.3Campos que contienen la información del emisor de la transacción documentadaConjunto B

CIDCampoDescripciónPTTamOcuObservaciones
BB01SellerInformación del emisor del documento electrónicoR01O1-1
Nodo obligatorio para todos los documentos
BB02TaxIDIdentificador tributario o RNC del emisorB01N9-111-1
RNC del emisor
BB03NameRazón social del emisor.B01A1-1501-1
BB04ContactInformación de contacto del emisorB01O0-1
BB041PhoneListLista de números telefónicosB04O0-1
BB0411PhoneNúmero telefónicoB041L7-120-3
Formato válido: xxx-xxx-xxxx
BB042EmailListLista de correos electrónicosB04O0-1
BB0421EmailCorreo electrónicoB042L1-800-1
Correo válido
BB043WebsiteDato correspondiente a la página web del emisorB04A1-500-1
BB05AdditionalInfoElemento que contiene información tributaria adicional del emisorB01L251-1
BB051InfoElemento que describe la información adicionalB04I1-25
Ver en sección Emisor AdditionalInfo
BB06BranchInfoInformación sobre el establecimiento del emisorB01O1-1
BB061NameCodigo de sucursal que emite el documentoB06A1-201-1
BB062AddressInfoInformación de la dirección del establecimiento del emisorB06O1-1
BB0621AddressDirección de la ubicaciónB062A1-1001-1
Urbanización, Calle, Casa/Edificio, Número de Local
BB0622DistrictDato correspondiente al municipio de operación del Emisor.B062N60-1
Debe corresponder al catálogo de municipios según el Catálogo de Provincias y Municipios
Valores permitidos
  • 010000 · DISTRITO NACIONAL (Provincia)
  • 010100 · MUNICIPIO SANTO DOMINGO DE GUZMÁN (Municipio de DISTRITO NACIONAL)
  • 010101 · SANTO DOMINGO DE GUZMÁN (D. M.). (Municipio de DISTRITO NACIONAL)
  • 020000 · PROVINCIA AZUA (Provincia)
  • 020100 · MUNICIPIO AZUA (Municipio de PROVINCIA AZUA)
Ver los 582 valores →
BB0623StateDato correspondiente a la provincia de operación del Emisor.B062N60-1
Debe corresponder al catálogo de provincias según el Catálogo de Provincias y Municipios
Valores permitidos
  • 010000 · DISTRITO NACIONAL (Provincia)
  • 010100 · MUNICIPIO SANTO DOMINGO DE GUZMÁN (Municipio de DISTRITO NACIONAL)
  • 010101 · SANTO DOMINGO DE GUZMÁN (D. M.). (Municipio de DISTRITO NACIONAL)
  • 020000 · PROVINCIA AZUA (Provincia)
  • 020100 · MUNICIPIO AZUA (Municipio de PROVINCIA AZUA)
Ver los 582 valores →
BB0624CountryPaís donde se encuentra el estadoB062A501-1
Colocar DO

4.3.3.1Grupo Emisor AdditionalInfo

CIDCampoDescripciónPTTamOcuObservaciones
BI01ActividadEconomicaDato correspondiente a la actividad económica del Emisor.A1-1000-1
Se puede incluir solo la actividad económica que corresponde a la transacción.
BI02CodigoVendedorIdentificador del vendedorA1-600-1
Válido para todos los documentos excepto documentos 41, 43 y 47.
BI03NumeroFacturaInternaCorresponde al número interno de la factura.A1-200-1
BI04NumeroPedidoInternoCorresponde al número de pedido interno asignado a la factura.A1-200-1
BI05ZonaVentaCorresponde a la zona de venta del vendedor.A1-200-1
Válido para todos los documentos excepto documentos 41, 43 y 47.
BI06RutaVentaCorresponde a la ruta de venta del vendedor.A1-200-1
Válido para todos los documentos excepto documentos 41, 43 y 47.
BI07InformacionAdicionalEmisorOtra información relativa del Emisor.A1-2500-1
BI08NombreComercialNombre comercialA1-1500-1
Válido para todos los documentos

4.3.4Campos que contienen la información del receptor de la transacción documentadaConjunto C

CIDCampoDescripciónPTTamOcuObservaciones
CC01BuyerInformación del receptor/comprador de la factura electrónicaR01O0-1
Válido para todos los documentos excepto el documento 43. Opcional para los documentos 33, 34 y 47.
CC02TaxIDIdentificador tributario o RNC del receptorC01N9-110-1
RNC del Receptor. Para el documento 32, debe agregarse el RNC cuando el monto total sea igual o mayor a DOP$250 mil y si el monto total es menor a DOP$250 mil, este campo puede ser completado de manera opcional. Para los documentos 33 y 34, si se modifica un e-CF tipo 32 con monto total mayor o igual a DOP$250 mil se debe indicar el RNC del comprador. En el caso que se desee no informarlo o no sea permitido agregarlo por el tipo de documento, deberá llenarlo con la cadena "NO_APLICA". No permitido agregar para documentos 43 y 47.
CC03TaxIDTypeTipo de contribuyente receptorC01N100-1
Indicar "EXTRANJERO" en caso de ser un contribuyente extranjero y agregar el identificador tributario en el campo C02. Debe agregarse si el e-CF es una factura de consumo electrónica > DOP$250,000.00 y el comprador no posee RNC/Cédula por ser extranjero. No permitido agregar indicador de receptor extranjero para documentos 31, 41, 43 y 45
CC04NameRazón social del receptor del documento.C01A1-1500-1
Para el documento 32, debe agregarse el nombre o razón social del receptor cuando el monto total sea igual o mayor a DOP$250 mil y si el monto total es menor a DOP$250 mil, este campo puede ser completado de manera opcional. Para los documentos 33 y 34, si se modifica un e-CF tipo 32 con monto total mayor o igual a DOP$250 mil se debe indicar el nombre o razón social.
CC05ContactInformación de contacto del receptorC01O0-1
CC051PhoneListLista de números telefónicosC05O0-1
CC0511PhoneNombre y teléfono de contacto del comprador.C051L1-800-1
CC052EmailListLista de correos electrónicosC05O0-1
CC0521EmailCorreo electrónicoC052L1-800-1
Correo válido correspondiente al correo electrónico del comprador
CC06AdditionlInfoInformación adicional del receptorC01L1-1
CC061InfoElemento que describe la información adicional del receptorC06I1-25
Ver en sección Receptor AdditionlInfo
CC07AddressInfoInformación de la dirección del receptorC01O0-1
CC071AddressDirección del comprador.C07A1000-1
Urbanización, Calle, Casa/Edificio, Número de Local
CC072DistrictMunicipio del comprador.C07A61-1
Debe corresponder al catálogo de municipios según el Catálogo de Provincias y Municipios
Valores permitidos
  • 010000 · DISTRITO NACIONAL (Provincia)
  • 010100 · MUNICIPIO SANTO DOMINGO DE GUZMÁN (Municipio de DISTRITO NACIONAL)
  • 010101 · SANTO DOMINGO DE GUZMÁN (D. M.). (Municipio de DISTRITO NACIONAL)
  • 020000 · PROVINCIA AZUA (Provincia)
  • 020100 · MUNICIPIO AZUA (Municipio de PROVINCIA AZUA)
Ver los 582 valores →
CC073StateProvincia del compradorC07A61-1
Debe corresponder al catálogo de provincias según el Catálogo de Provincias y Municipios
Valores permitidos
  • 010000 · DISTRITO NACIONAL (Provincia)
  • 010100 · MUNICIPIO SANTO DOMINGO DE GUZMÁN (Municipio de DISTRITO NACIONAL)
  • 010101 · SANTO DOMINGO DE GUZMÁN (D. M.). (Municipio de DISTRITO NACIONAL)
  • 020000 · PROVINCIA AZUA (Provincia)
  • 020100 · MUNICIPIO AZUA (Municipio de PROVINCIA AZUA)
Ver los 582 valores →
CC074CountryPaís del comprador.C07A501-1
Valor permitido "DO". Si el documento es 46 – Comprobante electrónico de exportación, puede agregar el país del comprador.

4.3.4.1Grupo Receptor AdditionlInfo

CIDCampoDescripciónPTTamOcuObservaciones
CI01FechaEntregaCorresponde a la fecha de entrega del ítem.A100-1
Formato válido AAAA-MM-DD. No permitido agregar para documentos 41, 43 y 47.
CI02ContactoEntregaDato de contacto donde será realizada la entrega o envío del ítem.A1-1000-1
Utilizar si el contacto entrega es distinto al comprador. No permitido agregar para documentos 41, 43 y 47.
CI03DireccionEntregaDirección o destino del contacto de entrega.A1-1000-1
No permitido agregar para documentos 41, 43 y 47.
CI04TelefonoAdicionalDato del teléfono correspondiente al contacto de entrega.A7-120-1
Formato válido xxx-xxx-xxxx. No permitido agregar para documentos 41, 43 y 47.
CI05FechaOrdenCompraCorresponde a la fecha de la orden de compra.A100-1
Formato válido AAAA-MM-DD. No permitido agregar para documentos 41, 43 y 47.
CI06NumeroOrdenCompraCorresponde al número de orden de compra.A1-200-1
No permitido agregar para documentos 41, 43 y 47.
CI07CodigoInternoCompradorPara identificación interna del comprador.A1-200-1
Ejemplo: Código del cliente, número de medidor, etc. No permitido agregar para documentos 43 y 47.
CI08ResponsablePagoCorresponde a la identificación del que realiza el pago del documento.A1-200-1
No permitido agregar para documentos 43 y 47.
CI09InformacionAdicionalCompradorOtra información relativa al comprador.A1-1500-1
No permitido agregar para documentos 43 y 47.

4.3.5Campos que describen cada ítem de la transacción documentadaConjunto E

CIDCampoDescripciónPTTamOcuObservaciones
EE01ItemsGrupo de datos que especifica los ítems de la transacción.R01L1-1
EE02ItemGrupo de datos que especifica cada detalle del ítem.E01O1-100
EE03CodesInformación relacionada a códigos del ítem.E02L0-1
EE031CodeElemento que describe la información adicional.E03I11-5
Ver en sección Ítem Codes
EE04TypeIdentifica si el ítem corresponde a Bien o Servicio.E02N11-1
Ejemplo: 1: Bien; 2: Servicio
Valores permitidos
  • 1 · Bien
  • 2 · Servicio
EE05DescriptionNombre del producto o servicioE02A2-801-1
EE06QtyCantidad del ítemE02N1-16p0-21-1
Expresado en la unidad de medida del código interno
EE07UnitOfMeasureIndica la unidad de medida que está expresada en la cantidad.E02N20-1
Debe corresponder al Catálogo de Unidades de Medida
EE08PriceDato correspondiente al precio unitario del ítem.E02N1-9p1-41-1
Si el ítem no es valorable: informar campo en 0.00. En el caso de ventas de productos de alcohol, bebidas alcohólicas y cerveza, a nivel de productor, fabricante o importador, en este campo se deberá indicar el precio de lista del ítem. En el caso de ítems gravados con impuesto selectivo a los servicios de seguros en general, el precio corresponde a la prima del seguro.
EE09DiscountsInformación relacionada a descuentos del ítemE02O0-1
No permitido agregar para documentos 43 y 47.
EE091DiscountElemento que describe un descuentoE09L1-12
Se pueden incluir 12 nodos que describan descuentos en el ítem.
EE0911CodeIndica si el Subdescuento está en monto o porcentaje.E091A11-1
Ejemplo: $: Descuento expresado en monto; %: Descuento expresado en porcentaje del precio unitario
EE0912RateValor del Subdescuento en porcentaje.E091N0-3p0-20-1
Campo obligatorio si E0911 es "%".
EE0913AmountCorrespondiente al valor del descuento expresado en monto.E091N1-16p0-21-1
Si E0911 es "%", el valor a colocar deberá ser igual a E08 * E0912 * E06. Si E0911 es "$", el valor a colocar será el monto neto del descuento
EE10TaxesInformación relacionada con los impuestos adicionales.E02O0-1
EE101TaxElemento que describe un impuestoE10L1-15
Puede contener Datos de Subcantidad (para cálculo de impuestos selectivos al consumo a productos derivados de alcohol y cervezas y productos del tabaco y cigarrillos) y, los Códigos de los tipos de impuestos adicionales. Se pueden incluir 5 repeticiones de este nodo para agregar datos de Subcantidad. Para los Impuestos Adicionales, pueden incluirse 2 repeticiones de este nodo. Datos de Subcantidad no permitido agregar en documentos 41, 43, 44, 46 y 47. Datos de Impuestos Adicionales no permitido agregar en documentos 41, 43, 46 y 47.
EE1011CodeUnidad de medida de la subcantidad/Código del impuesto adicional a aplicar.E101A2-31-1
Si E1012 es SUBCANTIDAD debe ser la unidad de medida de la subcantidad. Si E1012 es IMPUESTO_ADICIONAL deberá contener el código del impuesto adicional. Debe concordar con la tabla de codificación tipos de impuestos adicionales.
EE1012DescriptionCampo para describir si se agregará a la tabla de Códigos de impuesto adicional o la tabla de Subcantidades.E101A11-181-1
Puede tener uno de los siguientes valores: SUBCANTIDAD: Los datos serán agregados a la tabla de Subcantidades. IMPUESTO_ADICIONAL: Los datos serán agregados a la tabla de impuestos adicionales.
EE1013AmountCantidad de unidades de referencia que tiene la unidad del ítem.E101N1-16p0-31-1
Si E1012 es SUBCANTIDAD deberá contener la cantidad de referencia. Si E1012 es IMPUESTO_ADICIONAL deberá ingresar siempre 0.00
EE11ChargesContiene los Subrecargos otorgados al ítem.E02O0-1
No permitido agregar para documentos 43 y 47.
EE111ChargeElemento que contiene los datos de los recargos a aplicar.E11L1-12
Se pueden incluir 12 nodos que describan descuentos en el ítem.
EE1111CodeTipo de subrecargo a aplicarE111A11-1
Ejemplo: $: El subrecargo es tipo monto. %: El subrecargo es tipo porcentaje.
EE1112RateValor del Subrecargo en porcentaje.E111N1-3p0-20-1
Campo obligatorio si E1111 es "%".
EE1113AmountCorrespondiente al valor del Subrecargo expresado en monto.E111N1-16p0-21-1
Si E1111 es "%", el monto deberá ser igual a E08 * E1112 * E06. Si E1111 es "$", el valor a colocar será el monto neto del subrecargo
EE12TotalsGrupo de datos que contienen información relacionada a los precios totales del ítemE02O
EE121TotalItemPrecio total del ítem, (Precio unitario * cantidad) – Monto Descuento + Monto RecargoE11N1-16p0-21-1
El precio total del ítem debe calcularse de la siguiente manera: Total = [PrecioUnitarioItem (E08) * Cantidad (E06)] – sumatoriaDescuentos (Σ E0913) + sumatoriaRecargos (Σ E1113)
EE13AdditionalInfoInformación adicionalE02L0-1
EE121-infoInfoElemento que describe la información adicionalE12I1-25
Ver en sección Ítem AdditionalInfo. (Nota: el PDF identifica este campo con el ID E121, duplicado con TotalItem.)

4.3.5.1Grupo Ítem Codes

CIDCampoDescripciónPTTamOcuObservaciones
EI01TipoCodigoTipo de codificación utilizada para el ítem.A1-141-1
Este campo debe ser informado en el atributo "Name" del campo Code. Ejemplo: EAN, PLU, DUN, etc.
EI02CodigoItemCódigo del ítem de acuerdo a tipo de codificación indicada en campo anterior.A1-351-1
Este campo debe ser informado en el atributo "Value" del campo Code

4.3.5.2Grupo Ítem AdditionalInfo

CIDCampoDescripciónPTTamOcuObservaciones
EI04IndicadorFacturacionIndica si el item es exento, si es gravado, o No facturable.N11-1
Ejemplo: 0: No Facturable; 1: ITBIS 1 (18%); 2: ITBIS 2 (16%); 3: ITBIS 3 (0%); 4: Exento (E). El valor del Indicador de facturación para los documentos 43, 44 y 47 debe ser igual a 4 (Exento). El valor del indicador de facturación para el tipo de documento 46 debe ser igual a 3 (ITBIS tasa 0).
Valores permitidos
  • 0 · No Facturable
  • 1 · ITBIS 1 (18%)
  • 2 · ITBIS 2 (16%)
  • 3 · ITBIS 3 (0%)
  • 4 · Exento (E)
EI05IndicadorAgenteRetencionPercepcionPara Agentes de Retención o Percepción. Indica para cada transacción si es agente retenedor del producto que está vendiendo o el servicio.N10-1
Ejemplo: 1: "R"; 2: "P"
Valores permitidos
  • 1 · "R"
  • 2 · "P"
EI06MontoITBISRetenidoMonto del ITBIS correspondiente a la retención que será realizado por el comprador.N1-16p0-20-1
EI07MontoISRRetenidoMonto del Impuesto Sobre la Renta correspondiente a la retención realizada a la prestación o locación de servicios.N1-16p0-40-1
Cuando el tipo de documento (A02) sea 41 es condicional a que exista retención y E04 sea igual a 2 (Servicio).
EI08DescripcionItemDescripción Adicional del ítem.A1-10000-1
EI09CantidadReferenciaCantidad para la unidad de medida de referencia (No se usa para el cálculo del Monto ítem).N1-16p0-20-1
Condicional a que exista un E1011 de IMPUESTO_ADICIONAL que se encuentre entre los códigos 006-022.
EI10UnidadReferenciaIndica la unidad de medida que está expresada la cantidad referencia.N20-1
Condicional a que exista un E1011 de IMPUESTO_ADICIONAL que se encuentre entre los códigos 006-022 y que esté completado el valor de CantidadReferencia (EI09). Debe corresponder al Catálogo de Unidades de Medida.
EI11GradosAlcoholCorresponde al porcentaje de alcohol en el volumen de concentración total alcohólica por unidad de producto.N1-3p0-20-1
Condicional a que exista un E1011 de IMPUESTO_ADICIONAL que se encuentre entre los códigos 006-018. No permitido agregar para documentos 41, 43, 44, 46 y 47.
EI12PrecioUnitarioReferenciaPrecio unitario para la unidad de medida de referencia (No se usa para el cálculo del monto Total).N1-16p0-20-1
Condicional a que exista un E1011 de IMPUESTO_ADICIONAL que se encuentre entre los códigos 023-039. En el caso de que el ítem esté gravado con códigos de impuestos adicionales entre 023-039, se deberá colocar en este campo el previo de venta al por menor (PVP) empleado como base imponible para el cálculo del ISC Ad Valorem. No permitido agregar para documentos 41, 43, 44, 46 y 47.
EI13FechaElaboracionLa fecha de elaboración del ítem.A100-1
El formato debe ser AAAA-MM-DD. No permitido agregar para documentos 43 y 47.
EI14FechaVencimientoItemLa fecha de vencimiento del ítem.A100-1
El formato debe ser AAAA-MM-DD. No permitido agregar para documentos 43 y 47.
EI15PesoNetoKilogramoIndica el peso neto en kilogramo del mineralN1-16p0-30-1
Se debe usar cuando exista facturación de minerales (oro, plata, etc.). Válido para documentos 32, 33, 34 y 46.
EI16PesoNetoMineriaIndica el peso neto del mineral.N1-16p0-30-1
Se debe usar cuando exista facturación de minerales (oro, plata, etc.). Válido para documentos 32, 33, 34 y 46.
EI17TipoAfiliacionIndica si el destinatario es o no afiliada.N10-1
Se debe usar cuando exista facturación de minerales (oro, plata, etc.). Ejemplo: 1: Afiliada; 2: No afiliada. Válido para documentos 32, 33, 34 y 46.
Valores permitidos
  • 1 · Afiliada
  • 2 · No afiliada
EI18LiquidacionIndica si la liquidación del mineral es provisional o final.N10-1
Se debe usar cuando exista facturación de minerales (oro, plata, etc.). Ejemplo: 1: Provisional; 2: Final. Válido para documentos 32, 33, 34 y 46.
Valores permitidos
  • 1 · Provisional
  • 2 · Final

4.3.6Campos que describen los subtotales y totales de la transacción documentadaConjunto F

CIDCampoDescripciónPTTamOcuObservaciones
FF01TotalsGrupo de datos que contiene información sobre el total del documento electrónico.R01O1-1
Sección obligatoria para todos los documentos
FF02QtyItemsCantidad de Items en el documento electrónico.F01N1-31-1
FF03TotalTaxableAmountMonto gravado total del documento.F01N1-16p0-60-1
Es la suma de cada ocurrencia de F0412 (TaxableAmount) que corresponde a los montos gravados cuando el código es ITBIS1, ITBIS2 e ITBIS3.
FF04TotalTaxesGrupo de datos que contiene información de montos por tipo de facturación.F01L0-1
Pueden existir los montos de los tipos de facturación del 1 al 4, puesto que el monto no facturable se declarará en otro nodo, el cual se describirá más adelante. En caso de que no sea tipo de facturación, en este nodo deberá informar los datos de los impuestos adicionales. No permitido agregar para documentos 43, 44 y 47.
FF041TotalTaxElemento que contiene información sobre los montos según el tipo de facturación.F04O1-4
FF0411CodeCódigo que identificará a qué tipo de facturación está describiendo el grupo de datos o el código de impuesto adicional.F041A61-1
Ejemplo: ITBIS1, ITBIS2, ITBIS3, EXENTO, 001, 006, 023, etc. a) Codigos ITBIS1, ITBIS2 no permitidos para documentos 43, 44, 46 y 47. b) ITBIS3 no permitido para documentos 43, 44 y 47. c) EXENTO no permitido para documento 46. En caso de ser un impuesto adicional, el código a colocar debe concordar con la Tabla de impuestos adicionales.
FF0412TaxableAmountMonto gravado del tipo de facturación.F041N1-16p0-41-1
Para ITBIS1, ITBIS2 o ITBIS3: a) Debe corresponder a la suma de valores del ítem con IndicadorFacturacion que corresponda al Codigo agregado (F0411), menos descuentos más recargos aplicados al IndicadorFacturacion. b) Si el campo AI06 (IndicadorMontoGravado) es 1, se debe dividir la suma de valores de los montos de ítem con mismo indicador de facturacion, entre (1+tasa ITBIS). Por ejemplo, si la suma de los ítems con IndicadorFacturacion = 1 (ITBIS1 18%) es 300.00, debe realizarse el siguiente calculo 300.00 / (1 + 0.18) = 254.24. Y debe hacerse lo mismo para cualquier tasa ITBIS cuando el campo IndicadorMontoGravado sea 1. c) Si el campo IndicadorMontoGravado no es 1, solo deberá sumarse el monto gravado de los ítems que correspondan al código (F0411) agregado. d) Si el código es ITBIS1 y el campo IndicadorNorma1007 (HI16) es completado, se debe dividir la suma de valores del monto de ítem con indicador de facturacion = 1, entre (1+tasa ITBIS 18% +tasas de códigos de impuestos adicionales 002 y 004, asignados al item). Si existe descuento, el monto de descuento correspondiente no se deberá rebajar del monto gravado ITBIS tasa 1. Para EXENTO: a) Debe corresponder a la suma de los totales de ítems con indicador facturación 4, menos descuentos más recargos con indicador facturación 4. Para Impuestos Adicionales: a) Códigos del 001 al 005, deberá agregarse la cantidad a la que se le aplicará la tasa (F0414) correspondiente. b) Códigos del 006 al 022, este nodo no deberá agregarse. c) Códigos del 023 al 039: a. Si en la sección de Items se incluye un item con unidad de medida a granel (código 18) y contiene un código de impuesto adicional entre 023 y 039 no se deberá agregar este nodo. b. Si en la sección de Items se incluye un item con unidad de medida diferente a granel (código 18) y contiene un código de impuesto adicional entre 023 y 039 se deberá agregar este nodo y su valor debe ser el monto ISC especifico correspondiente al monto equivalente del impuesto ISC especifico (entre los códigos 006 a 022).
FF0413RateTasa el tipo de facturación.F041N1-21-1
Tasa del impuesto según el tipo de facturación, por ejemplo: ITBIS1: 18.00 (que corresponde al 18%); ITBIS2: 16.00 (que corresponde al 16%); ITBIS3: 0.00 (que corresponde al 0%). Si se desea agregar en monto EXENTO, no se debe colocar este nodo. En caso de que se trate de un impuesto adicional, se debe colocar la tasa que se encuentra en la tabla de impuestos adicionales según el código indicado.
FF0414AmountMonto total del tipo de facturación.F041N1-16p0-41-1
Ver observaciones en sección Detalle de Amount en TotalTaxes/TotalTax
FF05GrandTotalInformación sobre el precio total de la facturaF01O1-1
FF053InvoiceTotalPrecio total de la facturaF05N1-16p0-41-1
Monto total es igual a la suma de los montos gravados (F03) + Monto exento + Total ITBIS + Monto de los impuestos adicionales.
FF06AdditionalInfoInformación adicionalF01L0-1
FF061InfoElemento que describe la información adicionalE12I1-25
Ver en sección Total AdditionalInfo

4.3.6.1Detalle de Amount en TotalTax

Para ITBIS1: Si existen impuestos adicionales con códigos desde 006 hasta 039, el total de Amount será el monto gravado F0412 (TaxableAmount) más la suma de los montos de dichos impuestos adicionales, todo esto multiplicado por la tasa porcentual de F0413 (Rate). Si no se encuentran impuestos adicionales con códigos desde 006 al 039, el total de este nodo (Amount) será el monto gravado multiplicado por la tasa porcentual de F0413 (Rate). Para ITBIS2, ITBIS3 y EXENTO: El total debe ser igual al monto gravado F0412 (TaxableAmount) multiplicado por la tasa porcentual de F0413 (Rate). Para impuestos adicionales: Para los códigos entre 001-005, se deben multiplicar los montos de ítems gravados por este impuesto, por el campo F0413 (Rate). Para los códigos 001, 002, 003 y 004, si el campo AI06 (IndicadorMontoGravado) es igual a 1, se debe dividir el monto del ítem entre (1 + ITBIS tasa 1), y el resultado multiplicarlo por la tasa en el campo F0413. Para los códigos 002 y 004, si el campo HI16 de la sección DESCUENTOS_O_RECARGOS es completado, debe dividir la suma de los valores del monto ítem con indicador de facturación = 1, entre (1+tasa ITBIS tasa 1+tasa de código de impuesto adicional 002+tasa de código de impuesto adicional 004), para luego multiplicar este resultado por la tasa correspondiente al código de impuesto adicional. Si existe descuento global se debe multiplicar el porcentaje del monto ítem por línea, por el HI20 de descuento. Si el código de impuesto se encuentra entre 001-004, se debe tomar la sumatoria de los montos ítems asignados al código, y restar los montos de descuentos aplicables al código indicado, para luego multiplicar este resultado por la tasa del código de impuesto adicional. Si el campo HI16 es completado, el monto de descuento correspondiente no se deberá considerar. Si existe recargo global se debe multiplicar el porcentaje del monto ítem por línea por el Monto Recargo (global). Si el código se encuentra entre 001, 002, y 004, se debe tomar la sumatoria de los montos ítems asignados a los códigos y sumar los montos de recargos aplicables al código indicado, para luego multiplicar este resultado por la tasa del código de impuesto adicional. Si el código del impuesto se encuentra entre 006-018 se debe verificar la unidad de medida del ítem, si es a granel (código 18) no se deberá calcular el impuesto selectivo al consumo específico. Para los ítems con códigos 006-018 y unidad de medida distinta de granel, para el cálculo del monto de impuesto específico se debe multiplicar la cantidad de referencia por los grados de alcohol, por la tasa del impuesto indicada en la tabla para dicho código, por la subcantidad y cantidad. Para los códigos del 019 al 022, se debe calcular multiplicando la cantidad por la cantidad de referencia, por la tasa del impuesto adicional indicado. Si el código del impuesto se encuentra entre 023-035 se debe verificar la unidad de medida del ítem, si es granel (código 18) se deberá calcular el impuesto incrementando en un treinta por ciento (30%) el precio unitario del ítem (equivalente al precio de lista) por la cantidad ítem por la tasa del impuesto correspondiente. Para los ítems con código entre 023-035 (ISC Ad valorem) y unidad de medida distinta de granel, se debe dividir el precio unitario de referencia entre (1 + tasa ITBIS tasa 1); este resultado se debe restar del ISC Específico unitario y este último resultado se debe dividir entre (1+tasa del impuesto adicional especificado), esto dará como resultado la base imponible del impuesto; esta base se deberá multiplicar por la cantidad, por la cantidad de referencia y por la tasa del impuesto correspondiente. Cuando la tasa del impuesto adicional sea entre 036-039, se debe calcular el impuesto dividiendo el precio unitario de referencia entre (1+tasa ITBIS tasa 1); a este resultado se debe restar la tasa del ISC Específico y el resultado se debe dividir entre (1+tasa del impuesto adicional especificado), esto dará como resultado la base imponible para el ISC Ad Valorem; esta base se debe multiplicar por la cantidad, por la cantidad de referencia y por la tasa del impuesto correspondiente. (Las fórmulas completas se encuentran en las páginas 37-39 del PDF NUC-JSON V1.0.7.)

4.3.6.2Grupo Total AdditionalInfo

CIDCampoDescripciónPTTamOcuObservaciones
FI01MontoNoFacturableTotal de la suma de montos de bienes o servicios con indicador de facturación 0N1-16p0-20-1
Se debe agregar cuando existan ítems con IndicadorFacturacion (EI04) con valor 0 (No facturable). No permitido agregar para documentos 41, 43 y 47.
FI02MontoPeriodoTotal de la suma de Monto Total y Monto no Facturable.N1-16p0-20-1
Monto período = Monto Total (F053) + Monto No Facturable (FI01)
FI03SaldoAnteriorSaldo Anterior. Se incluye sólo con fines de ilustrar con claridad el cobro.N1-16p0-20-1
Puede ser negativo.
FI04ValorPagarValor cobrado.N1-16p0-20-1
Valor a pagar = Monto total – Monto Avance de pago ± Saldo Anterior (± atendiendo si el valor es positivo o negativo). Si el campo "Indicador Norma 10-07" de la sección Descuento o Recargo es completado entonces; Valor a pagar = Monto total – Monto descuento - Monto Avance de pago ± Saldo Anterior (± atendiendo si el valor es positivo o negativo).
FI05TotalITBISRetenidoMonto del ITBIS correspondiente a la retención que será realizada por el comprador. Condicional a que en la línea de detalle de ítems exista retención.N1-16p0-20-1
Suma de los campos Monto ITBIS Retenido en la sección de detalle de los ítems. No permitido agregar para documentos 32, 43, 44, 45, 46 y 47.
FI06TotalISRRetencionMonto del Impuesto Sobre la Renta correspondiente a la retención realizada de la prestación o locación de servicios. Condicional a que en la línea de detalle de ítems exista retención.N1-16p0-20-1
Suma de los campos Monto Retención Renta de la sección de detalle de los ítems. No permitido agregar para documentos 32, 43, 44, 45 y 46.
FI07TotalITBISPercepcionMonto del ITBIS que el contribuyente cobra a tereros como adelante del impuesto que éste percibirá en sus operaciones. Condicional a que en la línea de detalle de ítems exista percepción.N1-16p0-20-1
Condicional a que en la línea de detalle exista percepción. No permitido agregar para documentos 32, 43, 44, 45, 46 y 47.
FI08TotalISRPercepcionMonto del Impuesto Sobre la Renta que el contribuyente cobra a terceros como adelanto del impuesto que este percibirá en sus operaciones.N1-16p0-20-1
Condicional a que en la línea de detalle exista percepción. No permitido agregar para documentos 32, 43, 44, 45, 46 y 47.
FI09MontoAvancePagoPago parcial por adelantado de la factura que se emiteN1-16p0-20-1

4.3.7Campos que describen las formas de pagoConjunto G

CIDCampoDescripciónPTTamOcuObservaciones
GG01PaymentsGrupo de datos que contiene información sobre las formas de pago del documento electrónico.R01L1-1
GG02PaymentGrupo que describe un pagoG01O0-7
Puede haber máximo 7 formas de pago
GG021CodeIndica el método de pago en que se pagará el documento electrónicoG02A20-1
Podrá colocar uno de los siguientes valores: 1: Efectivo; 2: Cheque/Transferencia/Depósito; 3: Tarjeta de Débito/Crédito; 4: Venta a Crédito; 5: Bonos o Certificados de regalo; 6: Permuta; 7: Nota de crédito; 8: Otras formas de pago. Si la forma de pago corresponde al tipo 5 el campo A02 debe ser tipo 32
Valores permitidos
  • 1 · Efectivo
  • 2 · Cheque/Transferencia/Depósito
  • 3 · Tarjeta de Débito/Crédito
  • 4 · Venta a Crédito
  • 5 · Bonos o Certificados de regalo (Si la forma de pago corresponde al tipo 5 el campo A02 debe ser tipo 32)
  • 6 · Permuta
  • 7 · Nota de crédito
  • 8 · Otras formas de pago
GG022AmountIndica el monto asociado para cada forma de pago.G02N1-16p0-41-1

4.3.8Campos que describen información adicional sobre la transacción documentadaConjunto H

CIDCampoDescripciónPTTamOcuObservaciones
HH01AdditionalDocumentInfoGrupo de datos que contiene información adicional sobre el documento electrónicoR01L1-1
HH02AdditionalInfoGrupo que contiene información adicionalH01O1-1
HH03AditionalDataGrupo que contiene datos adicionales como información de documento fiscal referenciadoH02O0-1
Obligatorio si Tipo de documento A02 = 33 o 34. Llenar campos cuando se desee agregar información sobre Documentos Fiscales Referenciados.
HH031DataElemento que contiene datos adicionales sobre documentos, referencias, etc.H03L1-50
En el atributo Name puede venir el siguiente contenido. SUBTOTALES: Apartado de subtotales informativos, no aumentan o disminuyen la base del impuesto, ni modifican los campos totalizadores. Estos subtotales tienen una descripción que especifica el concepto. Por ejemplo, un subtotal aplicado a un grupo determinado de ítems, etc. Pueden enviarse hasta 20 repitencias de este nodo para describir los Subtotales. DESCUENTOS_O_RECARGOS: Apartado para indicar montos que aumenten o disminuyan la base del impuesto. Estos descuentos o recargos tienen una descripción que especifica el concepto. Por ejemplo, un descuento aplicado a un determinado tipo de ítems o un descuento por pago al contado que afecta a todos los ítems. Pueden incluirse hasta 20 repeticiones para indicar descuentos o recargos globales. PAGINACION: Sección que indica la cantidad de páginas del e-CF en la representación impresa y cuales ítems estarán en cada una. Esta deberá repetirse para el total de páginas especificadas. INFORMACION_REFERENCIA: Corresponde a la sección donde se indica la información del comprobante fiscal electrónico modificado por la nota de crédito o débito electrónica emitida o reemplazado por el e-CF emitido. Se puede incluir hasta 1 linea.
HH0311InfoElemento que contiene la información adicionalH031I1-3
Ver en sección Información Adicional Data
HH04AditionalInfoGrupo que contiene información adicionalH02L1-1
Si se quiere agregar información sobre forma de Pago de la factura
HH041InfoElemento que contiene la información adicionalH04I1-25
Ver en sección Información Adicional AditionalInfo

4.3.8.1Grupo Información Adicional Data

CIDCampoDescripciónPTTamOcuObservaciones
HI01DescripcionSubtotalTítulo del SubtotalA1-401-1
SUBTOTALES
HI02OrdenUbicación para impresión. De uso para el contribuyente como ayuda para indicar cómo imprimirá Subtotales.N20-1
SUBTOTALES
HI03SubTotalMontoGravadoTotalValor de la sumatoria del Subtotal Monto Gravado ITBIS Tasa 1, ITBIS Tasa 2 e ITBIS Tasa 3; en DOP$ u otra moneda.N1-16p0-40-1
SUBTOTALES. No permitido agregar para documentos 43, 44 y 47.
HI04SubTotalMontoGravado1Valor del monto gravado del Subtotal asignados a ítem con ITBIS tasa 1 (18%); en DOP$ u otra moneda.N1-16p0-20-1
SUBTOTALES. No permitido agregar para documentos 43, 44, 46 y 47.
HI05SubTotalMontoGravado2Valor del monto gravado del Subtotal asignados a ítem con TIBIS tasa2 (16%); en DOP$ u otra moneda.N1-16p0-20-1
SUBTOTALES. No permitido agregar para documentos 43, 44, 46 y 47.
HI06SubTotalMontoGravado3Valor del monto gravado del Subtotal asignados a ítem con ITBIS tasa 2 (0%); en DOP$ u otra moneda.N1-16p0-20-1
SUBTOTALES. No permitido agregar para documentos 43, 44, 46 y 47.
HI07SubTotalITBISValor de la sumatoria del Subtotal ITBIS Tasa 1, subtotal ITBIS Tasa 2 y Subtotal ITBIS Tasa 3; en DOP$ u otra moneda.N1-16p0-20-1
SUBTOTALES. No permitido agregar para documentos 43, 44 y 47.
HI08SubTotalITBIS1Valor total de ITBIS tasa 1 del Subtotal; en DOP$ u otra moneda.N1-16p0-20-1
SUBTOTALES. No permitido agregar para documentos 43, 44, 46 y 47.
HI09SubTotalITBIS2Valor total de ITBIS tasa 2 del Subtotal; en DOP$ u otra moneda.N1-16p0-20-1
SUBTOTALES. No permitido agregar para documentos 43, 44, 46 y 47.
HI10SubTotalITBIS3Valor total de ITBIS tasa 3 del Subtotal; en DOP$ u otra moneda.N1-16p0-20-1
SUBTOTALES. No permitido agregar para documentos 43, 44 y 47.
HI11SubTotalImpuestoAdicionalValor de los impuestos adicionales del Subtotal; en DOP$ u otra moneda.N1-16p0-20-1
SUBTOTALES. No permitido agregar para documentos 43, 44 y 47.
HI12SubTotalExentoValor Exento del Subtotal; en DOP$ u otra moneda.N1-16p0-20-1
SUBTOTALES. No permitido agregar para documento 46.
HI13MontoSubTotalValor de la línea de subtotal. Corresponde a la sumatoria e Subtotal Monto Gravado ITBIS Total, Subtotal ITBIS, Subtotal Impuestos adicionales y/o Subtotal Exento; en DOP$ u otra moneda.N1-16p0-20-1
SUBTOTALES
HI14LineasIndica la cantidad de líneas que se subtotaliza.N20-1
SUBTOTALES
HI15TipoAjusteDato que indica si es Descuento o Recargo.A10-1
DESCUENTOS_O_RECARGOS. D: Descuento; R: Recargo. No permitido agregar para documentos 43 y 47.
Valores permitidos
  • D · Descuento
  • R · Recargo
HI16IndicadorNorma1007Indica si el descuento que se aplica es según lo establecido en la norma 10-07.N10-1
DESCUENTOS_O_RECARGOS. Valor 1 si corresponde aplicar el descuento según lo establecido en la norma 10-07. No permitido agregar para documentos 41, 43, 44, 46 y 47.
HI17DescripcionDescuentooRecargoEspecificación de descuento o recargo.A1-450-1
DESCUENTOS_O_RECARGOS. No permitido agregar para documentos 43 y 47.
HI18TipoValorIndica si existe descuento o recargo aplicado en Porcentaje o Monto a aplicar de manera global.A10-1
DESCUENTOS_O_RECARGOS. %: Descuento/Recargo aplicado en porcentaje; $: Descuento/Recargo aplicado en monto. No permitido agregar para documentos 43 y 47.
Valores permitidos
  • % · Descuento/Recargo aplicado en porcentaje
  • $ · Descuento/Recargo aplicado en monto
HI19ValorDescuentooRecargoValor del Descuento o Recargo en porcentaje.N1-3p0-20-1
DESCUENTOS_O_RECARGOS. Obligatorio si HI18 = %. No permitido agregar para documentos 43 y 47.
HI20MontoDescuentooRecargoValor del descuento o recargo.N1-16p0-40-1
DESCUENTOS_O_RECARGOS. Si HI18 es igual a %, debe ir el monto correspondiente. Si HI18 es igual a $, se debe de indicar el monto. No permitido agregar para documentos 43 y 47.
HI21MontoDescuentooRecargoOtraMonedaValor en otra moneda. Aplica en montos de descuento o recargo global.N1-16p0-40-1
DESCUENTOS_O_RECARGOS. Si HI18 es igual a %, debe ir el monto correspondiente. Si HI18 es igual a $, se debe de indicar el monto. Valor Opcional. No permitido agregar para documentos 43 y 47.
HI22IndicadorFacturacionDescuentooRecargoIndica si el descuento o recargo afecta a ítems según su tipo de facturación.N10-1
DESCUENTOS_O_RECARGOS. Ejemplo: 1: Ítem gravado a ITBIS tasa 1; 2: Ítem gravado a ITBIS tasa 2; 3: Ítem gravado a ITBIS tasa 3; 4: Exento. No permitido agregar para documentos 43 y 47.
Valores permitidos
  • 1 · Ítem gravado a ITBIS tasa 1
  • 2 · Ítem gravado a ITBIS tasa 2
  • 3 · Ítem gravado a ITBIS tasa 3
  • 4 · Exento
HI23NoLineaDesdeIndica el no. de la línea de detalle del primer ítem que contiene la página.N30-1
PAGINACION. El valor indicado debe ser menor o igual al colocado en el campo HI24 y debe ser mayor a cero.
HI24NoLineaHastaIndica el no. de línea de detalle del último ítem que será incluido en la página.N30-1
PAGINACION. El valor indicado debe ser mayor o igual al colocado en el campo HI23 y debe ser mayor a cero.
HI25SubtotalMontoGravadoPaginaTotal de la suma de valores de monto gravado ITBIS a diferentes tasas, de las líneas correspondientes a la página que se indica.N1-16p0-20-1
PAGINACION. Suma de los campos HI26, HI27, HI28. No permitido agregar para documentos 43, 44 y 47.
HI26SubtotalMontoGravado1PaginaTotal de la suma de valores de ítems gravados asignados a ITBIS tasa 1 (tasa 18%), de las líneas correspondientes a la página que se indica, menos descuentos más recargos.N1-16p0-20-1
PAGINACION. No permitido agregar para documentos 43, 44, 46 y 47.
HI27SubtotalMontoGravado2PaginaTotal de la suma de valores de ítems gravados asignados a ITBIS tasa 2 (tasa 16%), de las líneas correspondientes a la página que se indica, menos descuentos más recargos.N1-16p0-20-1
PAGINACION. No permitido agregar para documentos 43, 44, 46 y 47.
HI28SubtotalMontoGravado3PaginaTotal de la suma de valores de ítems gravados asignados a ITBIS tasa 3 (tasa 0%), de las líneas correspondientes a la página que se indica, menos descuentos más recargos.N1-16p0-20-1
PAGINACION. No permitido agregar para documentos 43, 44 y 47.
HI29SubtotalExentoPaginaTotal de la suma de valores correspondientes a ítems exentos indicados en el no. de línea "Desde" "Hasta", de la página.N1-16p0-20-1
PAGINACION. No permitido agregar para documento 46.
HI30SubtotalItbisPaginaTotal de la suma de valores de ITBISN1-16p0-20-1
PAGINACION. Suma de los campos HI31, HI32 y HI33. No permitido agregar para documentos 43, 44 y 47.
HI31SubtotalItbis1PaginaSubtotal monto gravado 1 por la tasa ITBIS 1, de la línea indicada en la página.N1-16p0-20-1
PAGINACION. No permitido agregar para documentos 43, 44, 46 y 47.
HI32SubtotalItbis2PaginaSubtotal monto gravado 2 por la tasa ITBIS 2, de la línea indicada en la página.N1-16p0-20-1
PAGINACION. No permitido agregar para documentos 43, 44, 46 y 47.
HI33SubtotalItbis3PaginaSubtotal monto gravado 3 por la tasa ITBIS 3, de la línea indicada en la página.N1-16p0-20-1
PAGINACION. No permitido agregar para documentos 43, 44 y 47.
HI34SubtotalImpuestoAdicionalSubtotal del impuesto adicional por página.N1-16p0-20-1
PAGINACION. No permitido agregar para documentos 41, 43, 46 y 47.
HI35SubtotalImpuestoSelectivoConsumoEspecificoPaginaValor del impuesto selectivo al consumo escpecífico y Ad Valorem, correspondientes a los ítems del campo HI23 y HI24N1-16p0-20-1
PAGINACION. No permitido agregar para documentos 41, 43, 44, 46 y 47.
HI36SubtotalOtrosImpuestoValor del impuesto adicional (exceptuando el impuesto selectivo al consumo específico y Ad Valorem), correspondientes a los ítems del campo HI23 y HI24N1-16p0-20-1
PAGINACION. No permitido agregar para documentos 41, 43, 46 y 47.
HI37MontoSubtotalPaginaSumatoria de los campos Subtotal Monto Gravado Total Pagina, Subtotal ITBIS Pagina y Subtotal Impuesto Adicional PaginaN1-16p0-20-1
PAGINACION
HI38SubtotalMontoNoFacturablePaginaSuma de todos los valores correspondientes a ítems no facturables, que estén indicados en los capos HI23 y HI24N1-16p0-20-1
PAGINACION. No permitido agregar para documentos 41, 43 y 47.
HI39NCFModificadoEs el número del comprobante fiscal que será afectado o reemplazado por una secuencia electrónica.A11, 13 o 190-1
INFORMACION_REFERENCIA. Tanto el comprobante afectado o reemplazado, como la secuencia electrónica, deben estar emitidos por el mismo RNC/Cédula. Si la emisión del e-CF es por Código de Modificación 4: Reemplazo de un comprobante no electrónico emitido en contingencia, se debe validar que el tipo del NCF modificado sea el equivalente al tipo de e-CF que se está emitiendo. Obligatorio agregar para documentos 33 y 34.
HI41FechaNCFModificadoFecha del número de comprobante fiscal modificado.A100-1
INFORMACION_REFERENCIA. Formato de la fecha AAAA-MM-DD. Condicional a que la emisión del e-CF corresponda a un reemplazo de Comprobante Fiscal no electrónico emitido en contingencia. Obligatorio agregar para documentos 33 y 34.
HI42CodigoModificacionCódigo utilizado para indicar cuál es la finalidad del e-CF.N10-1
INFORMACION_REFERENCIA. Valores permitidos: 1: Anula el NCF modificado; 2: Corrige Texto del Comprobante Fiscal modificado; 3: Corrige montos del NCF modificado; 4: Reemplazo de NCF emitido en contingencia; 5: Referencia Factura Consumo electrónica. 1, 2 y 3 solo aplican para Nota de Crédito o Débito Electrónica.
Valores permitidos
  • 1 · Anula el NCF modificado (Solo aplica para Nota de Crédito o Débito Electrónica)
  • 2 · Corrige Texto del Comprobante Fiscal modificado (Solo aplica para Nota de Crédito o Débito Electrónica)
  • 3 · Corrige montos del NCF modificado (Solo aplica para Nota de Crédito o Débito Electrónica)
  • 4 · Reemplazo de NCF emitido en contingencia
  • 5 · Referencia Factura Consumo electrónica
HI43RazonModificacionCampo para describir los datos modificados o la razón de la emisión de la Nota de Crédito o Débito Electrónica.A1-900-1
INFORMACION_REFERENCIA. Permitido agregar en documentos 33 y 34.

4.3.8.2Grupo Información Adicional AditionalInfo

CIDCampoDescripciónPTTamOcuObservaciones
HI44FechaEmbarqueCorresponde a la fecha de embarque.F250-1
Formato AAAA-MM-DD. No permitido agregar para documentos 41, 43 y 47.
HI45NumeroEmbarqueDato correspondiente al número del embarque.A1-250-1
No permitido agregar para documentos 41, 43 y 47.
HI46NumeroContenedorDato correspondiente al número del contenedor.A1-1000-1
No permitido agregar para documentos 41, 43 y 47.
HI47NumeroReferenciaDato correspondiente al número de referencia.N1-200-1
No permitido agregar para documentos 41, 43 y 47.
HI48NombrePuertoEmbarqueNombre del puerto de embarque de la mercancía.A1-400-1
Permitido agregar únicamente para documento 46.
HI49CondicionesEntregaSe refiere a los términos comerciales fijados por el comprador y el vendedor referente a las condiciones de entrega de las mercancías y/o productos.A30-1
Se indica si es CIF, FOB, etc. Permitido agregar únicamente para documento 46.
HI50TotalFobCorresponde a la suma del valor FOB de todas las mercancías.N1-16p20-1
Permitido agregar únicamente para documento 46.
HI51SeguroCorresponde al monto total de la prima que figura en el documento de embarque o el documento que certifica el valor de la prima asignada a la compañía aseguradora.N1-16p20-1
Permitido agregar únicamente para documento 46.
HI52FleteCorresponde al importe pagado por el traslado de la mercancía de puertos dominicanos al extranjero.N1-16p20-1
Permitido agregar únicamente para documento 46.
HI53OtrosGastosImporte sobre gastos por otros servicios, hasta el transporte de las mercancías en la aduana de destino.N1-16p20-1
Permitido agregar únicamente para documento 46.
HI54TotalCifCorresponde al valor FOB, Flete, Seguro y otros gastos.N1-16p0-40-1
Permitido agregar únicamente para documento 46.
HI55RegimenAduaneroCorresponde al régimen aduanero al que se acoge la mercancía exportada, según se encuentra tipificada en la Dirección General de Aduanas (DGA).A1-350-1
Permitido agregar únicamente para documento 46.
HI56NombrePuertoSalidaNombre del puerto de donde sale la mercancía, distinto al puerto de embarque.A1-400-1
Permitido agregar únicamente para documento 46.
HI57NombrePuertoDesembarqueNombre del puerto de destino de la mercancía.A1-400-1
Permitido agregar únicamente para documento 46.
HI58PesoBrutoCorresponde al peso bruto del contenedor.N1-16p20-1
No permitido agregar para documentos 41, 43 y 47.
HI59PesoNetoCorresponde al peso neto del contenedor.N1-16p20-1
No permitido agregar para documentos 41, 43 y 47.
HI60UnidadPesoBrutoCorresponde a la unidad de medida en la que se encuentra el peso bruto de la mercancía.N20-1
Debe corresponder al Catálogo de Unidades de Medida. No permitido agregar para documentos 41, 43 y 47.
HI61UnidadPesoNetoCorresponde a la unidad de medida en la que se encuentra el peso neto de la mercancía.N20-1
Debe corresponder al Catálogo de Unidades de Medida. No permitido agregar para documentos 41, 43 y 47.
HI62CantidadBultoCorresponde a la cantidad de bultos que ampara el documento.N1-16p20-1
No permitido agregar para documentos 41, 43 y 47.
HI63UnidadBultoCorresponde a la unidad de medida en la que se encuentran los bultos.N20-1
Debe corresponder al Catálogo de Unidades de Medida. No permitido agregar para documentos 41, 43 y 47.
HI64VolumenBultoCorresponde al volumen de los bultos.N1-16p20-1
No permitido agregar para documentos 41, 43 y 47.
HI65UnidadVolumenCorresponde a la unidad de medida en la que se encuentra el volumen de los bultos.N20-1
Debe corresponder al Catálogo de Unidades de Medida. No permitido agregar para documentos 41, 43 y 47.
HI66ViaTransporteSe especifica la vía del transporteN20-1
Ejemplo: 01: Terrestre; 02: Marítimo; 03: Aérea. Permitido agregar únicamente para documento 46.
Valores permitidos
  • 01 · Terrestre
  • 02 · Marítimo
  • 03 · Aérea
HI67PaisOrigenCorresponde al país de origen de la mercancía.A1-600-1
Permitido agregar únicamente para documento 46.
HI68DireccionDestinoCorresponde a la dirección de destino donde será realizado el envío del ítem.A1-1000-1
Debe ser utilizado cuando la dirección es distinta a la dirección del comprador. Permitido agregar únicamente para documento 46.
HI69PaisDestinoCorresponde al país destino donde será realizado el envío del ítem.A1-600-1
Debe ser utilizado cuando el país destino es distinto al país del comprador. Permitido agregar únicamente para documentos 46 y 47.
HI70RNCIdentificacionCompaniaTransportistaCorresponde al dato de RNC o de Identificación de la compañía que realiza el transporteA1-200-1
Permitido agregar únicamente para documento 46.
HI71NombreCompaniaTransportistaCorresponde al dato del nombre o razón social de la compañía que realiza el transporte.A1-1500-1
Permitido agregar únicamente para documento 46.
HI72NumeroViajeCorresponde al número de viaje o el número de vuelo.A1-200-1
Permitido agregar únicamente para documento 46.
HI73ConductorCorresponde al código o nombre del conductor.A1-200-1
No permitido agregar para documentos 41, 43 y 47.
HI74DocumentoTransporteCorresponde al documento de transporte del conductor.N1-200-1
No permitido agregar para documentos 41, 43 y 47.
HI75FichaCorresponde a la ficha del transporte.A100-1
No permitido agregar para documentos 41, 43 y 47.
HI76PlacaCorresponde al número de placa del vehículo del transporte.A70-1
No permitido agregar para documentos 41, 43 y 47.
HI77RutaTransporteCorresponde a la ruta establecida de transporte.A1-200-1
No permitido agregar para documentos 41, 43 y 47.
HI78ZonaTransporteCorresponde a la zona de transporte.A1-200-1
No permitido agregar para documentos 41, 43 y 47.
HI79NumeroAlbaranCorresponde al número de albarán de entrega.A1-200-1
No permitido agregar para documentos 41, 43 y 47.

5Respuesta de la API

Al enviar el contenido del NUC, se obtiene como respuesta un objeto JSON que tiene la siguiente estructura.

Donde:

AtributoDescripción
codecontiene el código de la respuesta obtenida
messagecontiene un mensaje informativo relacionado a la respuesta
descriptiondescripción adicional del mensaje
responseData1texto codificado en base64 del xml del documento enviado
responseData2texto codificado en base64 que contiene la factura el formato HTML
responseData3texto codificado en base64 que contiene la factura el formato PDF
authNumberIdentificador único del documento
urlContiene el enlace para consultar el documento en el portal de la DGII
infoDetailsatributo tipo arreglo de objetos que, cuando la respuesta es un error, muestra el listado de errores que contiene el NUC.
suggestedFileNamenombre sugerido para nombrar y guardar el contenido de la información que contiene el responseData1, responseData2, responseData3 o algún otro documento relacionado con la información de la factura emitida.
suggestedFileName2otro nombre sugerido
batcheNCF del documento emitido
serialatributo sin valor por el momento
issuedTimeStampfecha de emisión de la factura electrónica
taxIDRNC del contribuyente emisor del documento
namenombre o razón social del emisor
branchCodecódigo de establecimiento o sucursal donde fue emitida la factura, atributo sin valor por el momento
branchNamenombre comercial, atributo sin valor por el momento
receiverTaxIDRNC/cedula o identificador del receptor/comprador. atributo sin valor por el momento
receiverNamenombre o razón social del receptor
discountsindica el total de descuentos aplicados a la factura, atributo sin valor por el momento
taxesindica el total de impuestos aplicados a la factura, atributo sin valor por el momento
subtotalsubtotal de la factura, atributo sin valor por el momento
totalAmountmonto total de la factura, atributo sin valor por el momento
enrolledTimeStampfecha y hora de certificación de la factura
backprocessorservidor que realiza la consulta
additionalInfoatributo tipo objeto que contiene información adicional sobre la factura emitida. atributo sin valor por el momento

5.1 Códigos dentro de la Respuesta

Tabla 8 — Códigos de respuesta de la API

CódigoDescripción
-1Error al realizar certificación. País no válido ingresado en el NUC. Mostrará el mensaje de error en el atributo "message".
0Error en el contenido del XML NUC. Este tipo de error se mostrará si en el proceso de transformar xml surge un error, puede ser causado por la ausencia de un valor importante, un tipo de dato incorrecto, etc. Se indicará en los atributos "message" y "description" el detalle y la descripción del error informado, indicando donde se encuentra el error y la referencia hacia esta documentación.
1Operación realizada correctamente. (Aplica para notas de crédito; no aplica para notas de débito — aclaración equipo DO 2026-07)
400Error en realizar la consulta. Se mostrará en el atributo "message" la descripción del error.
500Error inesperado. Se mostrará el contenido del error en los atributos "message" y "description".
3010Error en el Schema del NUC. Verificar que el esquema (nodos y atributos del archivo XML) sea válido y que corresponda al NUC. Se indicará el error en los atributos "message" y "description"
3000Error en el proceso de certificación. Puede ser por motivos de documento duplicado, RNC del emisor incorrecto, entre otros. Se indicará el error en los atributos "message" y "description".

5.2 Códigos de Estado HTTP

Tabla 9 — Códigos de estado HTTP

CódigoDescripción
200Ok
400Bad Request
401Unauthorized. Verificar token de autorización
500Internal Server Error