🇨🇴 Colômbia — Verificação DIAN

A API de Verificação DIAN da Verifik ajuda a autenticar o status fiscal de empresas colombianas usando dados governamentais oficiais. Foi projetada para automatizar seus processos KYB (Know Your Business), prevenir fraudes e garantir o cumprimento de todos os requisitos regulatórios sem esforço.

Construímos esta integração para empresas que precisam de uma forma rápida, segura e automatizada de confirmar o status fiscal e a legitimidade de empresas, parceiros ou fornecedores colombianos.

O que esta API valida?

Nossa API conecta-se diretamente aos registros oficiais da DIAN (Dirección de Impuestos y Aduanas Nacionales) para validar:

• Razão social e NIT: suporta o Número de Identificación Tributaria (NIT).
• Status fiscal: retorna o status de registro da empresa na DIAN.
• Correspondência da empresa: confirma que as informações correspondem ao NIT e valida responsabilidades fiscais ativas.

Ao validar esses elementos, você pode confiar que a empresa com quem está negociando é legítima, está corretamente registrada na autoridade fiscal e possui obrigações fiscais ativas, reduzindo significativamente o risco de fraude e garantindo conformidade.

Referência da API

Ponto de acesso

GET https://api.verifik.co/v2/co/company/dian

Mesmo caminho no app: GET https://verifik.app/v2/co/company/dian.

Cabeçalhos

Nome	Valor
Accept	application/json
Authorization	Bearer <token>

Parâmetros

Nome	Tipo	Obrigatório	Descrição
documentType	string	Sim	Deve ser NIT.
documentNumber	string	Sim	NIT. Espaços são removidos no servidor; você pode incluir ou omitir o dígito verificador. Comprimento mínimo 5 caracteres (validação da API).

Requisição

Node.js

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/company/dian", {
  params: { documentType: "NIT", documentNumber: "901708460" },
  headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/company/dian"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "NIT", "documentNumber": "901708460"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Resposta

A API pode retornar dois tipos de respostas bem-sucedidas (200):

1. Resposta de empresa: informações padrão da empresa
2. Resposta de pessoa natural: quando o NIT pertence a uma « persona natural » registrada na DIAN, a resposta inclui campos de nome adicionais divididos pelas funções internas da Verifik.

200 - Empresa

{
  "data": {
    "date": "2025-10-10T16:49:00Z",
    "descripcion": "Los datos de la persona estan activos, es decir tiene vigentes sus responsabilidades ",
    "estado": "REGISTRO ACTIVO",
    "nombreRazon": "SAY SHANNON COLOMBIA SAS",
    "nit": "901708460"
  },
  "signature": {
    "dateTime": "October 10, 2025 4:49 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "5RCBO"
}

200 - Pessoa natural

{
  "data": {
    "date": "2026-01-20T22:07:00Z",
    "descripcion": "Los datos de la persona estan activos, es decir tiene vigentes sus responsabilidades ",
    "estado": "REGISTRO ACTIVO",
    "nombreRazon": "RODRIGUEZ MARTINEZ CARLOS ANDRES",
    "nit": "1234567890",
    "fullName": "CARLOS ANDRES RODRIGUEZ MARTINEZ",
    "firstName": "CARLOS ANDRES",
    "lastName": "RODRIGUEZ MARTINEZ",
    "arrayName": [
      "RODRIGUEZ",
      "MARTINEZ",
      "CARLOS",
      "ANDRES"
    ]
  },
  "signature": {
    "dateTime": "January 20, 2026 10:07 PM",
    "message": "Certified by Verifik.co"
  },
  "id": "5SQEM"
}

404

{
    "code": "NotFound",
    "message": "Record not found."
}

409

{
  "code": "MissingParameter",
  "message": "documentType must be one of: [NIT]"
}

{
  "code": "MissingParameter",
  "message": "missing documentNumber\n"
}

{
  "code": "MissingParameter",
  "message": "missing documentType\n"
}

500

{
  "code": "InternalServerError",
  "message": "Server error."
}

Notas

• GET apenas em query — sem corpo. Use Accept (não Content-Type) para respostas JSON.
• Use uma string NIT válida; a integração trata formatação e dígito verificador conforme retornado pela DIAN.
• Divisão de nome para pessoas naturais: quando a resposta é de uma « persona natural », a Verifik divide automaticamente o nome do campo nombreRazon em firstName, lastName, fullName e arrayName. Como a fonte retorna o nome em um único campo (nombreRazon), a divisão pode não ser 100% precisa. O campo nombreRazon sempre contém o nome original retornado pela DIAN.

---

Casos de uso comuns

• Onboarding B2B: verifique empresas instantaneamente durante o registro de parceiros ou fornecedores.
• Serviços financeiros: autentique empresas antes de abrir contas ou processar transações.
• Conformidade e due diligence: valide o status fiscal como parte dos fluxos KYC/KYB.
• E-commerce e marketplaces: confirme legitimidade e conformidade fiscal antes de permitir vendas na plataforma.

Fontes oficiais e confiabilidade

Conectamo-nos diretamente às fontes oficiais da DIAN (autoridade fiscal colombiana) para garantir informações verificadas e atualizadas. Cada consulta é tratada com estrita aderência a padrões de segurança e regulamentação.

Principais benefícios

• Conformidade automatizada: simplifique verificações KYB para prevenir fraudes sem atrito para parceiros.
• Resultados instantâneos: processe verificações em segundos, ideal para onboarding em tempo real.
• Dados confiáveis: confie em dados provenientes diretamente de registros fiscais oficiais.
• Integração fácil: conecte-se via nossa API REST ou SDKs compatíveis.

Conformidade e segurança

Priorizamos a segurança dos seus dados. A Verifik usa criptografia avançada (HTTPS/TLS 1.3) e padrões rigorosos de privacidade. Nosso serviço é monitorado 24/7 quanto à disponibilidade e oferece controles de acesso baseados em funções.

Sobre a Verifik

A Verifik é uma plataforma líder em verificação de identidade, conformidade e prevenção a fraudes na América Latina. Nossas APIs automatizam processos KYC, KYB, AML e validação biométrica, conectando empresas a fontes oficiais na Colômbia, México, Peru, Chile, Uruguai, Argentina, Brasil e além.