Versions Compared

Key

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

...

Name

Required

Type

Description

Example

depth_combinations

O

List[Depth Combination]

  • 팔린 상품 옵션의 목록입니다.

  • 한 주문에 여러 옵션 구매가 가능하고 한 옵션에 대해 다수의 구매가 존재할 수 있기에 이를 대응하기 위한 구조입니다.

  • 하단 4) Type > Depth Combination 참고

order

O

Order

  • 팔린 상품 옵션에 대한 주문 정보

  • 하단 4) Type > Order 참고

purchaser

O

Purchaser

  • 구매자에 대한 정보

  • 하단 4) Type > Purchaser 참고

representative

O

Traveler

  • 대표 여행자에 대한 정보

  • 하단 4) Type > Traveler 참고

  • 대표 여행자가 없다면 purchaser 정보로 값을 채웁니다.

(2) Type

...

- Order

Name

Required

Type

Description

channel_order_id

O

String

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

purchased_at

O

Datetime

  • RFC 3339 형식의 UTC 기준 상품이 팔린 일시

purchase_requested_at

X

Datetime

  • RFC 3339 형식의 UTC 기준 구매 요청이 발생한 일시

reserved_at

X

Datetime

  • RFC 3339 형식의 UTC 기준 예약이 발생한 일시

reservation_requested_at

X

Datetime

  • RFC 3339 형식의 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

  • 주문의 상태
    "New" : 새 주문

is_voucher

O

Boolean

  • True

    • voucher가 있는 상품

  • False

    • voucher가 없는 상품

comment

X

String

  • 추가적으로 입력된 코멘트 입력

currency

O

String

  • 상품이 팔린 화폐

  • "KRW" : 원화
    "USD" : 미국 달러

(3) Type - Depth Combination

Name

Required

Type

Description

channel_product_mapping_code

O

String

  • 채널에 등록된 상품 옵션과 AX Cloud 의 상품 옵션을 매핑한 테이블의 고유 식별자

dc_code

O

String

  • 팔린 상품의 옵션에 해당하는 Depth Combination의 고유 식별자

quantity

O

Integer

  • 각 옵션 판매량

inventory_at

O

Datetime

  • 팔린 상품의 사용 일자를 RFC 3339 형식의 Datetime 표기

  • Depth Combination의 특정 날짜의 인벤토리를 특정하기 위해 필요.

unit_selling_price

O

String

  • 옵션 당 판매 단가

  • 소수점 5자리

discount

X

String

  • 옵션 당 할인가

  • 소수점 5자리

discount_method

X

String

  • 옵션 당 할인 방법

amount_price

O

String

  • 옵션 당 최종가격

  • 소수점 5자리

tickets

O

List[Ticket]

  • Depth Combination > quantity 하나에 대응되는 Entity

(4) Type - Purchaser

Name

Required

Type

Description

is_required_more_information

O

Boolean

  • True

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

  • False

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

name

O

String

  • 구매자 이름

national_code

O

String

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

phone

O

String

  • 여행자 핸드폰 번호

email

O

String

  • 여행자 이메일

additional

X

Object

  • Supplier가 요구하는 추가 정보

extra

O

String

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

(5) Type - Ticket

Name

Required

Type

Description

channel_code

O

String

  • Channel에서 DepthCombination > quantity > 하나의 Ticket에 대한 식별자

name

O

String

  • 여행자 이름

national_code

O

String

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

phone

O

String

  • 여행자 핸드폰 번호

email

O

String

  • 여행자 이메일

additional

X

Object

  • Supplier가 요구하는 추가 정보

extra

X

String

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

...