Consulta DIAN Terceros por API

Referencia técnica para consultar un tercero utilizando la API de Dataico.

Autenticación

La API utiliza el encabezado Auth-token como método de autenticación: puede ser una llave API o el Auth Token de la cuenta, que aparece en Opciones (parte superior) > Configuración. Esta consulta no usa dataico_account_id: toma la empresa de la credencial.

Consultar Tercero DIAN

Método: GET

Endpoint: https://api.dataico.com/direct/dataico_api/v2/dian_terceros

Parámetros (Params):

Parámetro	Descripción	Ejemplo
`identification`	Número de identificación a consultar	`123456895`
`identification_type`	Tipo de identificación. Solo se aceptan `NIT` (o `31`) para empresas y `CC` (o `13`) para personas	`NIT`

Headers:

Content-Type: application/json
Auth-token: <tu llave API o el Auth Token de la cuenta>

Configuración en Postman

Configura la solicitud con el método GET, agrega los Params con los campos identification e identification_type, y en Headers incluye el Auth-token.

Respuesta

Si la DIAN tiene datos del tercero, la respuesta trae:

Campo	Descripción
`identification`	La identificación consultada
`identification_type`	El tipo de identificación consultado
`email`	Correo registrado en la DIAN
`company_name`	Razón social (empresas)
`first_name`, `other_names`	Nombres (personas)
`family_name`, `second_last_name`	Apellidos (personas)

Errores

Código HTTP	Mensaje	Qué hacer
400	El campo `identification` es requerido o El campo `identification_type` es requerido	Envía los dos parámetros
400	El campo `identification_type` debe ser uno de NIT, CC, 13, 31	Usa uno de esos cuatro valores. Otros tipos de identificación no se pueden consultar
404	`Información del tercero no encontrado en la DIAN`	La DIAN no tiene datos de ese tercero. Revisa el número y el tipo
500	`Error en la API de DIAN`	La consulta a la DIAN no se pudo completar. Intenta de nuevo más tarde y, si persiste, escríbenos al chat de soporte