| 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
팔린 상품의 하나의 옵션에 대응되는 객체입니다.
비정형 데이터인 다양한 카테고리의 다양한 상품을 유연하게 모두 지원하기 위한 구조입니다.
...
Name
...
Required
...
Type
...
Description
...
channel_product_mapping_code
...
O
...
String
...
채널과 상품의 옵션을 매핑한 table의 고유 식별자
...
dc_code
...
O
...
String
...
팔린 상품의 옵션에 해당하는 depth combination의 고유 식별자
...
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
하나의 옵션 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
...
여행자가 작성한 기타 정보
...