| Page Tree |
|---|
1. Structure
Order 도메인을 쉽게 이해하기 위해 Order, Depth Combination, Purchaser, Traveler에 대한 이해도가 요구됩니다.
1) Order
위 API에서 하나의 주문에 대응되는 객체
하나의 주문 생성에 필요한 정보를 담습니다.
...
Name
...
Required
...
Type
...
Description
...
channel_order_id
...
O
...
String
...
채널에서 주문을 식별하기 위해 부여한 ID
...
purchased_at
...
O
...
Datetime
...
UTC 기준 상품이 팔린 datetime
...
purchase_requested_at
...
X
...
Datetime
...
UTC 기준 구매 요청이 발생한 datetime
...
reserved_at
...
X
...
Datetime
...
UTC 기준 예약이 발생한 datetime
...
reservation_requested_at
...
X
...
Datetime
...
UTC 기준 예약 요청이 발생한 datetime
...
sub_total
...
O
...
String
...
소수점 5자리까지 표현
depth_combination > travelers에 기입된 unit_selling_price 총합
...
discount_method
...
X
...
String
...
주문 전체에 적용된 할인 방법
...
discount
...
X
...
String
...
주문 전체에 적용된 할인가
...
total
...
O
...
String
...
최종가
소수점 5자리까지 표현
...
status
...
O
...
String
...
1, 2, 3, 4, 5, 6 중 하나의 값을 입력
실제 의미는 아래 매핑을 참고
Code Block {"1": "New"}, # 새 주문 {"2": "Supplier pending"}, # Supplier 대기 {"3": "Supplier confirm"}, # Supplier 확정 {"4": "Supplier reject"}, # Supplier 거절 {"5": "Traveler cancel"}, # 여행자 취소 {"6": "Unavoidable cancel"}# 불가피한 취소
...
is_voucher
...
O
...
Bool
...
voucher가 있는 상품 : true
voucher가 없는 상품 : false
...
comment
...
X
...
String
...
추가적으로 입력된 코멘트 입력
...
currency
...
O
...
String
...
상품이 팔린 화폐
1, 2 중 하나의 값을 입력
실제 의미는 아래 매핑을 참고
Code Block {"1": "KRW"}, # 원화 {"2": "USD"} # 미국 달러
2) Depth Combination
위 API에서 상품의 하나의 옵션에 대응되는 객체
비정형 데이터인 다양한 카테고리의 다양한 상품을 유연하게 모두 지원하기 위한 구조
...
Name
...
Required
...
Type
...
Description
...
channel_product_mapping_id
...
O
...
String
...
채널과 상품을 매핑한 table의 id.
...
dc_id
...
O
...
String
...
depth combination의 id
...
quantity
...
O
...
Int
...
옵션 판매량
...
use_date
...
O
...
Datetime
...
팔린 상품의 use date를 datetime으로 표현한 값
depth combination의 특정 날짜의 인벤토리를 특정하기 위해 필요.
...
unit_selling_price
...
O
...
String
...
판매단가
소수점 5자리까지 표현
...
discount
...
X
...
String
...
할인가
소수점 5자리까지 표현
...
discount_method
...
X
...
String
...
할인 방법
...
amount_price
...
O
...
String
...
최종가
소수점 5자리까지 표현
...
travelers
...
O
...
List[Traveler]
...
여행자 목록
Type > Traveler 참고
3) Purchaser
상품을 구매한 구매자의 정보를 가진다.
...
Name
...
Required
...
Type
...
Description
...
is_required_more_information
...
O
...
Bool
...
추가적으로 더 입력받을 정보가 있다면 true
추가적으로 더 입력받을 정보가 없다면 false
...
name
...
O
...
String
...
구매자 이름
...
national_code
...
O
...
String
...
여행자 전화번호 국가번호 dial
...
phone
...
O
...
String
...
여행자 핸드폰 번호
...
...
O
...
String
...
여행자 이메일
...
additional
...
X
...
Dict
...
Supplier가 요구하는 추가 정보
...
extra
...
O
...
String
...
여행자가 작성한 기타 정보
4) Traveler
위 API에서 하나의 옵션 quantity에 대응되는 객체
여행자의 정보를 가진다.
별도의 여행자 정보가 없다면 구매자의 정보로 대신한다.
...
Name
...
Required
...
Type
...
Description
...
name
...
O
...
String
...
여행자 이름
...
national_code
...
O
...
String
...
여행자 전화번호 국가번호 dial
...
phone
...
O
...
String
...
여행자 핸드폰 번호
...
...
O
...
String
...
여행자 이메일
...
additional
...
X
...
Dict
...
Supplier가 요구하는 추가 정보
...
extra
...
X
...
String
...
여행자가 작성한 기타 정보
...