Skip to main content

번호판 기반 차량 가치 조회 - Fasecolda

Verifik의 Fasecolda 번호판 기반 차량 가치 조회 API는 번호판만으로 콜롬비아에 등록된 차량의 공식 상업 가치와 기술 제원을 조회합니다. 승용차, SUV, 픽업트럭, 상용차 및 오토바이 전반에서 높은 조회 성공률을 달성하기 위해 본 엔드포인트는 두 가지 상호보완적인 공식 차량 데이터 소스를 결합합니다:

  1. 1차 조회 (번호판-코드 직접 인덱스): 번호판이 기본 평가 인덱스의 Fasecolda 코드와 직접 연결되어 있는 경우 카탈로그의 정확한 항목을 즉시 반환합니다.
  2. 2차 조회 (교차 소스 제원 매칭): 오토바이나 신규 등록 차량처럼 번호판에 직접 연결된 코드가 없는 경우, Verifik은 공식 차량 등록 데이터에서 검증된 기술 제원(brand, line, cylinderCapacity, year, vehicleClass)을 조회하여 Fasecolda 가치 산정 카탈로그와 교차 매칭합니다(matchSource: "runt_fallback").

교차 소스 제원 매칭을 통해 응답이 반환될 때는 추적성 및 신뢰도 점수 메타데이터(matchSource, matchConfidence, matchNote, matchDetails, runtVehicle)가 함께 포함되어, 어떤 방식으로 코드가 매칭되었고 어떤 요소가 신뢰도 점수를 차감했는지 명확히 확인할 수 있습니다.

이 API는 무엇을 검증하나요?​

  • 번호판 기반 차량 및 오토바이 조회: 콜롬비아 자동차, SUV, 픽업트럭, 상용차 및 오토바이 번호판(ABC123, ABC12D, ABC12)을 지원합니다. 번호판의 공백, 하이픈, 마침표는 자동으로 제거되고 대문자로 정규화됩니다.
  • 종합 제원 및 상업 가치 데이터: Fasecolda 코드(code / homoloCode), 제조사(marke), 세부 모델(line1, line2, line3), 차종(class), 카테고리(category), 배기량(cylinderCapacity), 연료(fuel), 변속기(transmission), 기준 상업 가격(bcpp), 연식별 가격(valueModel)을 반환합니다.
  • 교차 소스 투명성 및 신뢰도 점수 분석: 교차 매칭 시 가중 신뢰도 점수(0.60~1.00)와 감점 사유(matchDetails.penalties)를 상세히 제공합니다.

Endpoint​

GET https://api.verifik.co/v2/co/fasecolda/values-by-plate

콜롬비아 등록 차량의 공식 가치 및 제원(code, marke, line1, line2, line3, class, cylinderCapacity, bcpp, valueModel)을 반환하며, 교차 소스 매칭 시 matchSource, matchConfidence, matchNote, matchDetails, runtVehicle을 함께 반환합니다. 번호판은 쿼리 매개변수 **plate**로 전달합니다.

Headers​

NameValue
Acceptapplication/json
AuthorizationBearer <token>

Parameters​

NameTypeRequiredDescriptionExample
platestringYes조회할 콜롬비아 차량 또는 오토바이 번호판(공백, 하이픈, 마침표는 자동 제거됨).ABC123

Request​

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/fasecolda/values-by-plate", {
  params: { plate: "ABC123" },
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
  },
});
console.log(data);

Response​

{
  "data": {
    "absShow": "NO",
    "airbags": "0",
    "airconditioningShow": "SI",
    "axles": "2",
    "bcpp": "64200",
    "brakes": "DISCO/TAMBOR",
    "capacityLoad": "0",
    "capacityPassengers": "5",
    "category": "LIVIANO PASAJEROS",
    "class": "AUTOMOVIL",
    "code": "08001151",
    "country": "COL",
    "cylinderCapacity": "1598",
    "doors": "5",
    "electricChairs": "0",
    "electricGlasses": "0",
    "electricMirrors": "0",
    "explorersShow": "NO",
    "foodSystem": "NO APLICA",
    "fuel": "GASOLINA",
    "groupUpdate": "1",
    "homoloCode": "08001151",
    "importedShow": "NO",
    "line1": "SANDERO [FL]",
    "line2": "AUTHENTIQUE",
    "line3": "MT 1600CC 8V AA",
    "long": "4057",
    "marke": "RENAULT",
    "novelty": "A",
    "observation": "",
    "plate": "ABC123",
    "power": "90",
    "rearSuspension": "NO APLICA",
    "reverseCameraShow": "NO",
    "segmentCylinder": "L",
    "segmentSize": "B",
    "sensorsShow": "NO",
    "service": "PARTICULAR",
    "sunroofShow": "NO",
    "tachometer": "NO APLICA",
    "traction": "DELANTERA",
    "transmission": "4X2",
    "typeAddress": "HIDRÁULICA",
    "typeAirConditioning": "MANUAL",
    "typeBox": "MECANICA",
    "typeHeadlights": "HALOGENO",
    "typology": "HATCHBACK",
    "upholsteryLeatherShow": "NO",
    "valueModel": [
      {
        "modelo": "2016",
        "valor": 34500,
        "estado": "USADO",
        "modeloId": 47,
        "idEstado": 1
      },
      {
        "modelo": "2015",
        "valor": 32800,
        "estado": "USADO",
        "modeloId": 46,
        "idEstado": 1
      }
    ],
    "weight": "1108",
    "year": "2016"
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "October 20, 2026 2:20 PM"
  },
  "id": "mhlt7"
}

Notes​

  • 이중 소스 커버리지(승용차 및 오토바이): 번호판이 기본 평가 인덱스에 직접 등록된 경우 정확한 Fasecolda 레코드를 반환합니다(matchSource 생략). 번호판이 직접 인덱싱되지 않은 경우(특히 오토바이), 공식 보조 차량 등록소에서 제원을 검증한 뒤 Fasecolda 카탈로그와 매칭합니다(matchSource: "runt_fallback").
  • 신뢰도 계산 공식(matchConfidence 및 matchDetails): 교차 소스 매칭은 0.55 * textScore + 0.25 * ccScore + 0.20 * yearScore 공식을 사용하여 0.00~1.00 범위로 산정되며 최소 임계값은 0.60입니다.
  • matchConfidence 감점 요인(matchDetails.penalties):
    • 카탈로그의 추가 트림/사양 토큰(textPoints, 최대 0.55): 차량 등록 원부는 기본 모델명("VERSA", "TRK 502X")만 기록하는 반면 Fasecolda 카탈로그는 세부 트림과 변속기/ABS 사양("ADVANCE AT 1600CC 2AB ABS")을 포함합니다. 이 추가 토큰들은 extraGuideTokens에 표시됩니다.
    • 형식승인 코드와 상업용 모델명 차이: "FZN250 A" vs "FZ25 250" 같은 토큰 차이는 unmatchedRuntTokens에 기록됩니다.
    • 배기량 표기 반올림(ccPoints, 최대 0.25): 5% 이내 차이(199cc vs 200cc)는 만점(0.25/0.25)을 받으며, 공칭 배기량 차이(373cc vs 400cc)는 -0.07이 차감되어 penalties에 설명됩니다.
  • 통화 단위: valueModel은 연식별 상업 가치를 담고 있으며 bcpp는 콜롬비아 페소(COP) 기준 기본 상업 가격입니다.