ボゴタ — 車両税
エンドポイント
GET https://api.verifik.co/v2/co/bogota/vehicle/tax
ボゴタに登録された車両の税務上の負担状況を取得します。所有者の documentType・documentNumber と車両の plate を クエリパラメータ で渡します。レスポンスには車両情報と年度ごとの納税義務の状態が含まれます。
ヘッダー
| 名前 | 値 |
|---|---|
| Accept | application/json |
| Authorization | Bearer <token> |
パラメーター
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
plate | string | はい | 照会するプレート。5~6文字。スペースやピリオドを含めないでください。 |
documentNumber | string | はい | 照会する証明番号。スペースやピリオドを含めないでください。 |
documentType | string | はい | 証明の種類。使用可能: CC(市民証)または NIT(納税者番号)。 |
リクエスト
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/co/bogota/vehicle/tax", {
params: {
plate: "ABC123",
documentType: "CC",
documentNumber: "123456789"
},
headers: {
Accept: "application/json",
Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`
},
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/co/bogota/vehicle/tax"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"plate": "ABC123", "documentType": "CC", "documentNumber": "123456789"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
レスポンス
- 200
- 400
- 409
{
"data": {
"details": "",
"documentNumber": "123456789",
"documentType": "CC",
"obligation": {
"vehicle": [
{
"brand": "MAZDA",
"form": "2020003010100010240",
"linea": "050365",
"model": "2021",
"obligation": "1.080.000",
"obligationStatus": "Moroso",
"plate": "ABC123",
"reference": "0000020034588543",
"taxableYear": "2020",
"totalToPay": "1.080.000"
}
]
},
"plate": "ABC123"
},
"signature": {"message": "Certified by Verifik.co", "dateTime": "July 3, 2024 3:59 PM"},
"id": "5P20N"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing plate"
}
メモ
CCはコロンビアの市民証(cédula)、NITは法人・事業者の納税者番号(Número de Identificación Tributaria)を指します。obligationStatusがMorosoの場合、未納の税金があります。