🇨🇴 コロンビア — DIAN 税務確認
Verifik の DIAN 確認 API は、公的データを用いてコロンビア企業の 税務当局(DIAN) 登録状態を認証します。KYB(Know Your Business)の効率化、不正防止、規制要件への対応を支援します。
コロンビアの企業・パートナー・ベンダーの税務ステータスと正当性を、迅速・安全・自動的に確認したいビジネス向けに構築しました。
この API は何を検証しますか?
本 API は公式 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 | はい | 税 ID(NIT)。サーバー側で 空白除去;検証桁の有無は任意。API 検証上 最小 5 文字。 |
リクエスト
- Node.js
- Python
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);
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 成功時は 法人 または 自然人(persona natural) の 2 パターンがあります。自然人の場合、Verifik が nombreRazon から氏名フィールドを分割します。
- 200 - 法人
- 200 - 自然人
- 404
- 409
{
"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"
}
{
"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"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "documentType must be one of: [NIT]"
}
注意
GETクエリのみ — ボディなし。JSON レスポンスにはAccept(Content-Typeではない)を使用してください。- 有効な NIT 文字列を使用してください。連携は DIAN が返す形式と検証桁を処理します。
- 自然人の氏名分割: persona natural の場合、Verifik は
nombreRazonからfirstName、lastName、fullName、arrayNameを自動分割します。ソースは単一フィールドのため、分割は常に 100% 正確とは限りません。nombreRazonは DIAN 原文のまま保持されます。 - 一般 納税者 状態とは別に 電子請求 登録を確認する場合は DIAN 法定請求者確認(
GET /v2/co/company/dian/invoicer)を使用してください。
一般的なユースケース
- B2B オンボーディング: パートナー・ベンダー登録時の即時確認
- 金融サービス: 口座開設・取引前の企業認証
- コンプライアンス・デューデリジェンス: KYC/KYB ワークフローでの税務ステータス検証
公式ソースと信頼性
コロンビア税務当局 DIAN の公式ソースと直接接続し、検証済みの最新情報を提供します。
主な利点
- 自動コンプライアンス: KYB チェックを効率化し不正を防止
- 即時結果: 数秒で照会、リアルタイムオンボーディングに最適
- 信頼できるデータ: 公式税務記録に基づく情報