| Page Tree |
|---|
1. Structure
Order 도메인을 쉽게 이해하기 위해 Order, Depth Combination, Purchaser, Traveler에 대한 이해가 선행 되어야 합니다.
1) Order
하나의 주문에 대응되는 객체
하나의 주문 생성에 필요한 정보를 담습니다.
...
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
...
여행자가 작성한 기타 정보
...