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
4se marcan con unaEa 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 |
003–005 |
Otros (seguros, telecomunicaciones, primera placa) | Otros Impuestos Adicionales |
006–039 |
Impuesto Selectivo al Consumo (bebidas, alcoholes, cigarrillos) | Total ISC |
Los códigos 006–018 y 023–035 corresponden a bebidas y alcoholes; 019–022 y 036–039,
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).