Catálogos DIAN

Varios campos de la API no reciben texto libre sino un valor de una lista oficial de la DIAN: el tipo de identificación, el tributo, la unidad de medida, el municipio… Aquí están todas esas listas, con qué campos las usan y si esperan el id o el codigo.

Cada una se puede descargar en JSON o CSV para cargarla en tu sistema, o consultar en vivo en la API: /api/catalogos/ es público y no pide credencial.

Catálogo	Registros	Descargar
Tipos de factura	9	JSON · CSV
Tipos de identificación	11	JSON · CSV
Tipos de organización	2	JSON · CSV
Responsabilidades fiscales	5	JSON · CSV
Tributos	16	JSON · CSV
Unidades de medida	1.090	JSON · CSV
Formas de pago	2	JSON · CSV
Medios de pago	75	JSON · CSV
Monedas	179	JSON · CSV
Países	249	JSON · CSV
Departamentos	33	JSON · CSV
Municipios	1.122	JSON · CSV
Periodos de nómina	6	JSON · CSV
Tipos de contrato	5	JSON · CSV
Tipos de trabajador	16	JSON · CSV
Subtipos de trabajador	2	JSON · CSV

El id o el codigo

Cada fila tiene las dos cosas. El codigo es el de la DIAN. El id es el de RedEDoc: en cada página, la tabla «Dónde se usa» dice cuál de los dos espera cada campo.

El id es fijo

Cada código tiene un id asignado de una vez y para siempre, el mismo en todos los ambientes: el que ves aquí es el que acepta la API, en pruebas y en producción. Un código nuevo recibe un id nuevo; uno existente no cambia de id. En el tipo de identificación el id es el propio código: 13 cédula, 31 NIT.

En la API

# Qué catálogos hay, de qué lista y anexo salen y qué campos los usan
curl https://api.rededoc.co/api/catalogos/

# Un catálogo entero, sin paginar
curl https://api.rededoc.co/api/catalogos/municipio/exportar/

# Buscar por código o nombre
curl "https://api.rededoc.co/api/catalogos/municipio/?search=Medell"