HANA CAPITAL × GNA (DATALAB) INTEGRATION

하나캐피탈 차량 금융상품 연동

차량코드 매칭 · 잔가/렌탈료 조회 API 연동 — 분석 · API · 문서 · 필요값 정리

serviceID UCARI00013 2단계 호출 (잔가→렌탈료) 검증 완료 ✅

산출물

📋 연동 플랜 · 분석plan.md — 개요, 아키텍처, 2단계 절차, 판정 규칙, 체크리스트 📖 API 문서api-docs.html — 요청/응답, 잔가맵 파싱, 렌탈료 필드, 에러코드 🔑 필요한 값 정리required-values.md — 발급값·매칭값·입력값·고정값·응답값 🧩 OpenAPI 스펙openapi.yaml — OpenAPI 3.0

연동 구조

GNA 견적 화면
   │ POST /api/v1/vehicle-finance/quote  {vehicle, contract}
   ▼
[오케스트레이터 API]  ①dvCd=1 잔가조회 → ②dvCd=2 렌탈료계산
   │ POST http://localhost:11080/inbound  (UCARI00013, raw JSON)
   ▼
[하나캐피탈 로컬 릴레이]  → 잔가율 / 월 렌탈료

핵심 결과 (실측 예시 재현)

GNA 필드값산출
priceResidualRto61.5잔가율(%) — 1단계
priceResidual20,910,000차량금액 × 잔가율% — 1단계
priceMonth1,174,910월 렌탈료(rlpnRtfe) — 2단계

빠른 실행

cd public_html/api
bash run_demo.sh      # 목 릴레이(11080) + API(18080) 기동 → 통합 테스트

실 연동: HANA_RELAY_URL, HANA_CCO_CUST_NO/SNO 환경변수 지정 후 python3 app.py — 자세한 내용은 api/README.md