Ir directamente al contenido
Español
  • No hay sugerencias porque el campo de búsqueda está vacío.

Consulta DIAN Terceros por API

Este artículo detalla cómo consultar un tercero utilizando la API de Dataico. Sigue los pasos a continuación para realizar la consulta correctamente.

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

Si tienes dudas, escríbenos por el chat de soporte dentro de tu cuenta de Dataico. Lo encuentras en la burbuja de la esquina inferior derecha de la pantalla.