Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Page Tree

...

1. Structure

Detail

Order

  • 하나의 주문에 대응되는 객체

  • 주문 생성에 필요한 정보를 포함

Depth Combination

  • 하나의 주문에 여러 개 생성되는 객체

  • 채널에서 옵션 정보가 여기에 대응

Purchaser

  • 하나의 주문에 대한 한 명의 구매자의 정보

Traveler

  • 하나의 Depth Combination 의 Quantity 에 대응되는 객체

  • 여행자의 정보를 포함

  • 별도의 여행자 정보가 없다면 구매자 정보로 대체

1) Order

Name

Required

Type

Description

channel_order_id

O

String

  • 채널에서 주문을 식별하기 위해 부여한 아이디

purchased_at

O

Datetime

  • UTC 기준 상품이 팔린 일시

purchase_requested_at

X

Datetime

  • UTC 기준 구매 요청이 발생한 일시

reserved_at

X

Datetime

  • UTC 기준 예약이 발생한 일시

reservation_requested_at

X

Datetime

  • UTC 기준 예약 요청이 발생한 일시

sub_total

O

String

  • 티켓들의 Amount 총 합

  • 소수점 5자리

  • depth_combination > travelers에 기입된 unit_selling_price 총합

discount_method

X

String

  • 주문 전체에 적용된 할인 방법

discount

X

String

  • 주문 전체에 적용된 할인가

  • 소수점 5자리

total

O

String

  • 최종 결제 가격

  • 소수점 5자리

status

O

String

  • 주문의 상태

  • {"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

  • 상품이 팔린 화폐

  • {"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]

3) Purchaser

Name

Required

Type

Description

is_required_more_information

O

Bool

  • True

    • 추가적으로 더 입력받을 정보가 있다.

  • False

    • 추가적으로 더 입력받을 정보가 없다.

name

O

String

  • 구매자 이름

national_code

O

String

  • 여행자 전화번호 국가번호

phone

O

String

  • 여행자 핸드폰 번호

email

O

String

  • 여행자 이메일

additional

X

Dict

  • Supplier가 요구하는 추가 정보

extra

O

String

  • 여행자가 작성한 기타 정보

4) Traveler

Name

Required

Type

Description

name

O

String

  • 여행자 이름

national_code

O

String

  • 여행자 전화번호 국가 번호

phone

O

String

  • 여행자 핸드폰 번호

email

O

String

  • 여행자 이메일

additional

X

Dict

  • Supplier가 요구하는 추가 정보

extra

X

String

  • 여행자가 작성한 기타 정보