상품
카플랫에 상품을 등록하고 관리하는 방법을 설명합니다.
카플랫 시스템에서 상품(Product) 도메인의 역할과 구성 요소를 설명합니다. 이 문서는 물리적 자산인 '차량'이 어떻게 판매 가능한 서비스 단위로 추상화되는지 이해하는 것을 목표로 합니다.
1. 상품(Product)이란?
카플랫에서 상품(Product)은 고객에게 실제 판매되는 렌터카 서비스 단위입니다. 이것은 물리적인 차량 목록(Car List) 에 요금(Fare Plan), 운영 정책(Policy), 보험 조건(Insurance Plan) 등을 결합한 논리적인 패키지입니다.
고객은 특정 차량(license_plate: 12가3456)을 예약하는 것이 아니라, "주중 시간당 15,000원짜리 아반떼 렌트"와 같은 상품을 보고 예약합니다.
하나의 상품(예: 아반떼 상품)은 여러 대의 동일 차종 차량(아반떼 1호기, 2호기, 3호기)을 재고(inventory)로 가질 수 있습니다. 이를 통해 렌트카 업체는 개별 차량이 아닌, 차종 기반의 재고 관리가 가능해져 운영 효율성이 극대화됩니다.
2. 상품의 데이터 모델
상품은 여러 하위 정책 객체와 관계를 맺는 복합 객체입니다.
Loading...
- idinteger
상품 일련번호
- productNamestring
상품명
- carTypeMakerCodeinteger
제조사코드
- seaterinteger
인승
- carTypeBaseModelCodeinteger
대표모델코드
- carTypeDetailModelCodeinteger
세부모델코드
- carTypeDetailModelNamestring
세부모델명
- carTypeFuelCodeinteger
유종코드
- carTypeFuelNamestring
유종명
- insuranceAgeLimitstring
보험연령 (O:21세이상, S:26세이상)
- licenseTypestring
면허종류 (O:1종보통, T:2종보통, H:1종 대형)
- fareIdinteger
요금제 일련번호
- updateNamestring
수정자 이름
- updateDateTimestring형식date-time
수정 시간
- basicSectionFareInfoobject
요금제 정보
- fareIdinteger
요금제 식별값
- namestring
요금제 명
- baseFareinteger
기본 요금
- maxFareinteger
최대(상한) 요금
- productCarOptionListarray<object>
차량옵션리스트
Array items:- idinteger
옵션일련번호
- optionNamestring
옵션명
- optionStringstring
KM 전달용 문자열
- optionValuestring
선택여부 (Y: 설치, N:미설치)
상품 승인 상태(productApproveStatus) 유형
| 상태 | 한글명 | 설명 |
|---|---|---|
0 | 승인대기 | 상품 등록 후 카플랫 관리자의 승인을 대기하는 상태 |
1 | 승인완료 | 승인이 완료되어 고객이 예약할 수 있는 상태 |
차량 판매 상태(saleYn) 유형
| 상태 | 한글명 | 설명 |
|---|---|---|
Y | 판매중 | 해당 차량이 예약 가능한 상태 |
N | 판매중지 | 해당 차량이 일시적으로 예약 불가능한 상태 |
관련 정책 객체
Fare (요금제)
basicSectionFareInfo 객체를 통해 기본 요금, 최대 요금, 주중/주말별 일별/시간별 요금 등 복잡한 가격 구조를 정의합니다.
Car Options (차량 옵션)
productCarOptionList를 통해 썬루프, 네비게이션 등 차량에 포함된 옵션들을 관리합니다.
Camping Options (캠핑카 옵션)
productCarCampOptionList를 통해 냉장고, 싱크대 등 캠핑카 전용 옵션들을 관리합니다.
3. 상품의 생명주기
3.1 생성 (Creation)
- 방법: carplat.co.kr 웹사이트의 상품 관리 페이지
- 설명: 렌트카 업체는 카플랫 웹사이트에 로그인하여 상품 관리 메뉴에서 새로운 상품을 등록합니다. 차종 정보, 요금제, 차량 목록, 옵션 등을 웹 인터페이스를 통해 설정합니다.
- 초기 상태:
0(승인대기)
3.2 상품 수정 (Update)
- 방법: carplat.co.kr 웹사이트의 상품 관리 페이지
- 설명: 등록된 상품의 정보를 카플랫 웹사이트에서 수정할 수 있습니다. 차량 추가/제거, 옵션 변경, 요금제 수정 등이 가능합니다.
3.3 승인 완료 (Approval)
- 수행자: 카플랫 관리자
- 설명: 웹사이트에서 등록/수정된 상품을 카플랫 관리자가 검토한 후 승인하면
productApproveStatus가1(승인완료)로 변경됩니다. 이 시점부터 고객이 예약할 수 있게 됩니다.
3.4 차량 판매 상태 관리
- 방법: carplat.co.kr 웹사이트의 상품 관리 페이지
- 설명: 상품 내 특정 차량의 판매 상태를 개별적으로 관리할 수 있습니다.
saleYn을 "Y" 또는 "N"으로 설정하여 차량별 판매 여부를 제어합니다.
3.5 상품 삭제 (Deletion)
- 방법: carplat.co.kr 웹사이트의 상품 관리 페이지
- 설명: 더 이상 사용하지 않는 상품을 카플랫 웹사이트에서 삭제할 수 있습니다.
4. 개발자를 위한 핵심 포인트
렌트카 업체 개발자
- 상품 관리: 상품의 생성, 수정, 삭제는 carplat.co.kr 웹사이트에서 직접 진행합니다. API를 통한 상품 등록은 지원하지 않으며, 웹 인터페이스를 통해 차종 정보, 요금제, 차량 목록, 옵션 등을 설정해야 합니다.
수요 채널(서비스사) 개발자
- 상품 정보 확인: 상품을 조회하는 API는 제공하지 않습니다. 고객이 예약한 차량 정보는 예약 정보 등록 이벤트의
carId,carNumber로 전달받습니다.