| Page Tree |
|---|
1. Structure
...
Detail
...
Order
...
하나의 주문에 대응되는 객체
주문 생성에 필요한 정보를 포함
...
Depth Combination
...
하나의 주문에 여러 개 생성되는 객체
채널에서 옵션 정보가 여기에 대응
...
Purchaser
...
하나의 주문에 대한 한 명의 구매자의 정보
...
Traveler
...
하나의 Depth Combination 의 Quantity 에 대응되는 객체
여행자의 정보를 포함
별도의 여행자 정보가 없다면 구매자 정보로 대체
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
...
Ticket 들의 Amount 총 합
소수점 5자리
depth_combination > travelers에 기입된 unit_selling_price 총합
...
discount_method
...
X
...
String
...
주문 전체에 적용된 할인 방법
...
discount
...
X
...
String
...
주문 전체에 적용된 할인가
소수점 5자리
...
total
...
O
...
String
...
최종 결제 가격
소수점 5자리
...
status
...
O
...
String
...
주문의 상태
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
...
True
voucher가 있는 상품
False
voucher가 없는 상품
...
comment
...
X
...
String
...
추가적으로 입력된 코멘트 입력
...
currency
...
O
...
String
...
상품이 팔린 화폐
Code Block {"1": "KRW"}, # 원화 {"2": "USD"} # 미국 달러
2) Depth Combination
...
Name
...
Required
...
Type
...
Description
...
channel_product_mapping_code
...
O
...
String
...
채널에 등록된 상품 옵션과 AX Cloud 의 상품 옵션을 매핑한 테이블의 고유 식별자
...
dc_code
...
O
...
String
...
팔린 상품의 옵션에 해당하는 Depth Combination의 고유 식별자
...
quantity
...
O
...
Int
...
각 옵션 판매량
...
use_date
...
O
...
Datetime
...
팔린 상품의 사용 일자를 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
...
여행자가 작성한 기타 정보
2. Enum
1) 주문 상태
주문은 다음과 같은 상태를 정의하고 사용합니다.
예시) 주문 상태 “1”번은 새 주문을 뜻합니다.
| Code Block |
|---|
{"1": "New"}, # 새 주문
{"2": "Supplier pending"}, # Supplier 대기
{"3": "Supplier confirm"}, # Supplier 확정
{"4": "Supplier reject"}, # Supplier 거절
{"5": "Traveler cancel"}, # 여행자 취소
{"6": "Unavoidable cancel"} # 불가피한 취소 |
2) 화폐
화폐는 다음과 같이 정의하고 사용합니다.
예시) 화폐 “1”번은 원화를 뜻합니다.
| Code Block |
|---|
{"1": "KRW"}, # 원화
{"2": "USD"} # 미국 달러 |
...