Saltar a contenido

Catálogos (valores permitidos)

Todos los códigos se envían como string, respetando los ceros a la izquierda ("01", no 1). Un código fuera de catálogo produce 422 con un mensaje del tipo "El campo tipo de ingresos seleccionado no es válido.".

Estos catálogos provienen de los esquemas oficiales de la DGII. Si la DGII publica valores nuevos, los sincronizamos y aparecen aquí sin cambios en su integración.


Tipo de ingresos — id_doc.tipo_ingresos

Código Descripción
01 Ingresos por operaciones (no financieros)
02 Ingresos financieros
03 Ingresos extraordinarios
04 Ingresos por arrendamientos
05 Ingresos por venta de activo depreciable
06 Otros ingresos

Tipo de pago — id_doc.tipo_pago

Código Descripción Implicación
1 Contado
2 Crédito Requiere id_doc.fecha_limite_pago y admite id_doc.termino_pago.
3 Gratuito No lleva formas de pago.

Forma de pago — id_doc.formas_pago[].forma

Hasta 7 formas de pago por comprobante. La suma de los montos debe cubrir el total.

Código Descripción
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

Tipo de cuenta de pago — id_doc.tipo_cuenta_pago

Código Descripción
AH Ahorros
CT Cuenta Corriente
OT Otra

Código de modificación — referencia.codigo_modificacion

Obligatorio en notas de crédito (34) y débito (33).

Código Descripción Uso
1 Anula el NCF modificado Anulación total del comprobante original.
2 Corrige texto del NCF modificado Sólo texto: el monto total debe ser 0.
3 Corrige montos del NCF modificado Ajuste de importes.
4 Reemplaza NCF emitido en contingencia Regularización tras contingencia.
5 Referencia Factura Consumo Electrónica Sólo en Factura de Crédito Fiscal (31).

Indicador de facturación — items[].indicador_facturacion

Se envía como número. Determina el tratamiento del ITBIS de la línea.

Valor Significado ITBIS de la línea Suma a
1 Gravado con ITBIS tasa 1 (18 %) 18 % del monto Monto gravado
2 Gravado con ITBIS tasa 2 (16 %) 16 % del monto Monto gravado
3 Gravado con ITBIS tasa 3 (0 %) 0 Monto gravado
4 Exento Monto exento
0 No facturable No suma al total

En la representación impresa, los ítems con indicador 4 se marcan con una E a la izquierda de la descripción, como exige la DGII.

Indicador de bien o servicio — items[].indicador_bien_servicio

Código Descripción
1 Bien
2 Servicio

Monedas — otra_moneda.tipo_moneda

Sólo si factura en divisa. La moneda local (DOP) no se declara.

Código Moneda Código Moneda
USD Dólar estadounidense JPY Yen japonés
EUR Euro MXN Peso mexicano
GBP Libra esterlina COP Peso colombiano
CAD Dólar canadiense BRL Real brasileño
CHF Franco suizo HTG Gourde haitiana
CHY Yuan chino VEF Bolívar fuerte venezolano
DKK Corona danesa NOK Corona noruega
SEK Corona sueca SCP Libra escocesa
XDR Derecho especial de giro

Unidades de medida — items[].unidad_medida

Opcional. Se envía el código numérico como string; en la representación impresa se imprime el nombre en palabras.

Cód. Unidad Cód. Unidad Cód. Unidad
1 Barril 22 Kilovatio Hora 43 Unidad
2 Bolsa 23 Libra 44 Elemento
3 Bote 24 Litro 45 Millar
4 Bultos 25 Lote 46 Saco
5 Botella 26 Metro 47 Lata
6 Caja/Cajón 27 Metro Cuadrado 48 Display
7 Cajetilla 28 Metro Cúbico 49 Bidón
8 Centímetro 29 Millones de Unidades Térmicas 50 Ración
9 Cilindro 30 Minuto 51 Quintal
10 Conjunto 31 Paquete 52 Toneladas de registro bruto
11 Contenedor 32 Par 53 Pie Cuadrado
12 Día 33 Pie 54 Pasajero
13 Docena 34 Pieza 55 Pulgadas
14 Fardo 35 Rollo 56 Parqueo Barcos En Muelle
15 Galones 36 Sobre 57 Bandeja
16 Grado 37 Segundo 58 Hectárea
17 Gramo 38 Tanque 59 Mililitro
18 Granel 39 Tonelada 60 Miligramo
19 Hora 40 Tubo 61 Onzas
20 Huacal 41 Yarda 62 Onzas Troy
21 Kilogramo 42 Yarda cuadrada

Impuestos adicionales — totales.impuestos_adicionales[].tipo

Cada fila lleva el código del impuesto y su importe en isc_especifico, isc_advalorem u otros (según corresponda). En la representación impresa se totalizan por separado:

Códigos Grupo Etiqueta en la RI
001 Propina Legal Propina legal
002 Contribución al Desarrollo de las Telecomunicaciones (CDT) CDT
003005 Otros (seguros, telecomunicaciones, primera placa) Otros Impuestos Adicionales
006039 Impuesto Selectivo al Consumo (bebidas, alcoholes, cigarrillos) Total ISC

Los códigos 006018 y 023035 corresponden a bebidas y alcoholes; 019022 y 036039, a cigarrillos. El catálogo completo con las 39 entradas está disponible bajo pedido.

Provincias y municipios

Catálogo de 582 entradas con codificación jerárquica de 6 dígitos (PPMMDD): PP0000 = provincia, PPMM00 = municipio, PPMMDD = distrito municipal. Se configura una sola vez en los datos de su empresa (no viaja en el JSON de cada comprobante).