차량금융 견적 오케스트레이터 · API 문서

개요

GNA 견적 화면이 매칭된 하나코드 + 차량금액만 넘기면, 오케스트레이터가 하나 릴레이를 dvCd=1(잔가조회) → dvCd=2(렌탈료계산) 순으로 호출하고 GNA 최종 산출값을 반환한다.

엔드포인트 · 통합 견적

curl -sS -X POST \
 'http://localhost:8080/api/v1/vehicle-finance/quote' \
 -H 'Content-Type: application/json' \
 -d '{
  "vehicle":  {"braNo":"111","mdlNo":"11609",
               "linupNo":"115311","trimNo":"1049401"},
  "contract": {"puryCarAmt":34000000,"cntrPrid":36,
               "prrpAmt":0,"drvrAgeDvCd":"04"},
  "options":  {"reprPrdtCd":"1","custDvCd":"1",
               "agrTrvgDstnCd":"20000"}
 }'

{
  "status": "OK",
  "priceResidualRto": 61.5,
  "priceResidual": 20910000,
  "priceMonth": 1174910,
  "rentalFeeInfo": {
    "rlpnRtfe":"1174910","carRtfe":"986700",
    "addRtfe":"81400","spprcAmt":"1068100",
    "srtxAmt":"106810","acqCamtAmt":"31679602",
    "irrPer":"5.8","jnIscoNm":"디비손해보험주식회사"
  },
  "residualDistanceSeg": "00000",
  "resInfo": {"rspnsCd":"PS000001",
              "rspnsMsg":"정상처리 되었습니다."}
}

엔드포인트 · 잔가조회만

하위 릴레이 전문 (참고)

오케스트레이터가 내부적으로 주고받는 하나 릴레이 전문 구조. 직접 호출 시 참고.

{
 "Header":{"serviceID":"UCARI00013","version":"1.0"},
 "Message":{
  "reqInfo":{"ccoCustNo":"6502189659",
    "ccoCustSno":"0","prdtCd":"0","dvCd":"1"},
  "info":{"braNo":"111","mdlNo":"11609",
    "linupNo":"115311","trimNo":"1049401",
    "puryCarAmt":"34000000","cntrPrid":"36",
    "prrpAmt":"0","drvrAgeDvCd":"04",
    "reprPrdtCd":"1","agrTrvgDstnCd":"20000",
    "custDvCd":"1", ... 고정 파라미터 전체 ...}
 }}

{
 "Header":{"serviceID":"UCARI00013","version":"1.0"},
 "Message":{
  "reqInfo":{... "dvCd":"2"},
  "info":{... 1단계와 동일 +
    "rcstPer":"61.5",          // 1단계 잔가율
    "aplRcstAmt":"20910000"}   // 차량금액×잔가율%
 }}

잔가맵 파싱 (mxRevalRtoCtnt)

mxRevalRtoCtnt는 {계약기간={약정주행거리구간=잔가율, ...}, ...} 형태의 Java Map 문자열. 1차 키=계약기간(개월), 2차 키=주행거리구간(00000=기본), 값=최대 잔가율(%).

"mxRevalRtoCtnt":
 "{12={00000=68.5, ...}, 36={00000=61.5, 15000=67.5,
    20000=66.0, 25000=62.0, 30000=60.0, 50000=55.0}, 60={...}}"

→ 잔가율 = mxRevalRtoCtnt["36"]["00000"] = 61.5   (36개월/기본구간)

렌탈료 응답 필드 (rentalFeeInfo)

※ 금액은 실테스트(쏘나타 디 엣지 가솔린 1.6터보, 3,400만원/36개월/기본구간) 결과. 실제 값은 차량·조건·시점에 따라 달라진다.

응답 결과 · 에러 코드

코드는 4자리(또는 접두문자+숫자). 0000 / Z000 / 1200 / H000 / F000 = 정상. 그 외는 오류.

산출물