哥伦比亚 — DIAN 税务核验

Verifik DIAN 税务核验 API 通过官方政府数据确认哥伦比亚企业的 税务登记状态，用于 KYB（Know Your Business）、防欺诈与合规流程。

本接口核验什么？

对接 DIAN（Dirección de Impuestos y Aduanas Nacionales）官方记录：

• 企业名称与 NIT：支持 Número de Identificación Tributaria（NIT）
• 税务状态：返回企业在 DIAN 的登记状态
• 信息匹配：确认企业信息与 NIT 一致，并验证有效税务义务

API 参考

端点

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

应用域名：GET https://verifik.app/v2/co/company/dian

请求头

名称	值
Accept	application/json
Authorization	Bearer <token>

参数

名称	类型	必填	说明
documentType	string	是	必须为 NIT。
documentNumber	string	是	税号 (NIT)。服务端去除空格；可含或省略校验位。API 校验最少 5 个字符。

请求

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())

响应

成功时 (200) 可能返回两类响应：

1. 企业响应：标准企业信息
2. 自然人响应：当 NIT 属于 DIAN 登记的 persona natural（自然人）时，响应包含 Verifik 内部分拆的姓名字段

200 - 企业

{
  "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 - 自然人

{
  "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."
}

说明

• 仅 GET 查询，无请求体。JSON 响应请用 Accept（非 Content-Type）。
• 请使用有效 NIT 字符串；集成按 DIAN 返回处理格式与校验位。
• 自然人姓名拆分：当响应为 persona natural 时，Verifik 会将 nombreRazon 拆分为 firstName、lastName、fullName、arrayName；因源数据为单字段，拆分可能不完全准确。nombreRazon 始终保留 DIAN 原始值。