🇨🇴 Colômbia — Verificação de faturador legal
A API de Verificação de Faturador Legal da Verifik ajuda a validar se uma empresa colombiana possui faturador legal registrado na DIAN (Dirección de Impuestos y Aduanas Nacionales). 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 de registro de faturador de empresas, parceiros ou fornecedores colombianos.
O que esta API valida?
Nossa API conecta-se diretamente aos registros oficiais da DIAN para validar:
- NIT da empresa e registro de faturamento eletrônico (facturación electrónica): suporta o Número de Identificación Tributaria (NIT).
- Contato do faturador: retorna o e-mail do faturador registrado e campos relacionados quando a DIAN os expõe.
- Verificação de registro: confirma que a entidade aparece no conjunto de dados de faturador legal da DIAN para faturamento eletrônico (distinto do status fiscal geral — veja Verificação DIAN).
Ao validar esses elementos, você pode confiar que a empresa possui capacidades de faturamento adequadas e está em conformidade com os requisitos da DIAN, 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/invoicer
Mesmo caminho no app: GET https://verifik.app/v2/co/company/dian/invoicer.
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
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/company/dian/invoicer", {
params: { documentType: "NIT", documentNumber: "901708460" },
headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/company/dian/invoicer"
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
- 200
- 404
- 409
- 500
{
"data": {
"documentNumber": "901708460",
"documentType": "NIT",
"email": "info@sayshannon.com",
"nit": "901708460"
},
"signature": {
"dateTime": "October 10, 2025 5:11 PM",
"message": "Certified by Verifik.co"
},
"id": "JS4GP"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [NIT]"
}
{
"code": "MissingParameter",
"message": "missing documentNumber\n"
}
{
"code": "MissingParameter",
"message": "missing documentType\n"
}
{
"code": "InternalServerError",
"message": "Server error."
}
Notas
GETapenas em query — sem corpo. UseAccept(nãoContent-Type) para respostas JSON.- Esta rota retorna dados de registro de faturador legal / faturamento eletrônico (ex.: e-mail quando disponível). Para status fiscal geral e obrigações, use Verificação DIAN (
GET /v2/co/company/dian). - 404 pode ocorrer quando a DIAN não retorna e-mail de faturador para aquele NIT (veja a lógica de integração).
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 registro de faturador como parte dos fluxos KYC/KYB.
- E-commerce e marketplaces: confirme capacidades de faturamento 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.