🇨🇴 보고타 — 차량세

엔드포인트

GET https://api.verifik.co/v2/co/bogota/vehicle/tax

보고타에 등록된 차량의 세금 의무 정보를 조회합니다. 소유자 documentType, documentNumber 와 차량 plate 를 쿼리 문자열로 보냅니다. 응답에는 차량 세부 정보와 과세 연도별 의무 상태가 포함됩니다.

헤더(Headers)

Name	Value
Accept	application/json
Authorization	Bearer <token>

매개변수(Parameters)

name	type	required	description
plate	string	yes	조회할 번호판. 5–6자. 공백·마침표 없음.
documentNumber	string	yes	조회할 신분/사업자 번호. 공백·마침표 없음.
documentType	string	yes	증명 유형. 허용: CC, NIT.

요청(Request)

Node.js

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

Python

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

응답(Response)

200

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

400

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

409

{
  "code": "MissingParameter",
  "message": "missing plate"
}

참고(Notes)

• CC 는 콜롬비아 시민 신분증, NIT 은 납세자(사업자) 식별번호입니다.
• obligationStatus 가 Moroso 이면 미납 세금이 있습니다.