Estructura del JSON de un DTE: qué campos importan

24 de septiembre de 2026 · JSON · Lectura ~10 min

El archivo JSON del DTE es la representación estructurada del documento fiscal. No es un PDF “bonito”: es un conjunto de campos con nombres y reglas definidos por el esquema oficial del Ministerio de Hacienda. Entender qué bloques importan te ayuda a depurar errores y a diseñar automatizaciones confiables.

Identificación del documento

Suele incluir tipo de documento, numeración, fecha de emisión, código de generación u otros identificadores únicos. Estos campos permiten detectar duplicados y ordenar por período.

Emisor y receptor

Datos del contribuyente que emite y, cuando aplica, del que recibe: NIT, nombre o razón social, NRC, dirección, etc. En compras, el emisor del JSON recibido es tu proveedor. En ventas, el receptor es tu cliente.

Cuerpo / detalle

Líneas de productos o servicios, cantidades, precios, descuentos y tratamientos de IVA por línea. A veces el total del documento se calcula a partir del detalle; otras veces el esquema trae totales ya consolidados que deben cuadrar con las líneas.

Resumen de tributos

Bloques de IVA, montos gravados, exentos, retenciones y otros tributos. Aquí es donde una herramienta lee el crédito o débito fiscal y las retenciones para F07, F08 y Casilla 162.

Nota: los nombres exactos de los campos dependen de la versión del esquema oficial. Siempre conviene validar contra la documentación técnica vigente del MH y no asumir que un campo “se llama igual que el año pasado”.

Por qué no basta con el PDF

El PDF es legible para humanos, pero copiar montos a mano introduce errores. El JSON permite lectura automatizada, filtros y consolidación. Si solo archivas PDF, cada mes vuelves a digitar; si ordenas JSON, puedes reprocesar el mismo lote cuando cambie un criterio de clasificación.

Conclusión

No necesitas memorizar todo el esquema, pero sí saber qué bloques alimentan tus anexos. Esa claridad es la diferencia entre un Excel frágil y un proceso repetible.

¿Opinión o duda?

¿Qué campo del JSON te ha dado más problemas al integrar?

Comentar por WhatsApp