Consultar un catálogo de la DIAN
const url = 'https://example.com/v1/catalogs/departments';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://example.com/v1/catalogs/departmentsDevuelve los registros de una tabla de códigos de la DIAN. Admite filtro por texto sin tildes con q y, para municipios, por código de departamento DIVIPOLA de 2 dígitos. No requiere API key.
Parameters
Sección titulada «Parameters»Path Parameters
Sección titulada «Path Parameters»El catálogo de la DIAN a consultar (ej. municipalities, units, taxes, tax-responsibilities)
El nombre del catálogo
Query Parameters
Sección titulada «Query Parameters»Texto sin distinción de mayúsculas ni tildes para filtrar por código o nombre (ej. “bogota”)
Para municipios: solo los de este código de departamento DIVIPOLA de 2 dígitos (ej. “11”)
Responses
Sección titulada «Responses»Los registros del catálogo
object
Los registros del catálogo
Un registro de una tabla de códigos de la DIAN
object
El código que se envía en la API y se escribe en el XML de la DIAN
El nombre oficial del código en la DIAN, en español
Para municipios: el código DIVIPOLA de 2 dígitos de su departamento
Example generated
{ "data": [ { "code": "example", "name": "example", "departmentCode": "example" } ]}La petición no cumple el esquema (VALIDATION_ERROR, con details por campo)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}No existe (NOT_FOUND)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Error del servicio
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}