product environment: https://prod.ax-cloud.com/v1/channel/orders/day-ticket

test environment: https://test.ax-cloud.com/v1/channel/orders/day-ticket

POST

새 주문 등록

application/json

Token {api_key}

options

O

List[Option]

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

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

• 타입 정의 주문 - 날짜지정형 입장권 주문 생성 | (3) Type Option

order

O

Order

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

• 타입 정의 주문 - 날짜지정형 입장권 주문 생성 | (2) Type Order

purchaser

O

Purchaser

• 구매자에 대한 정보

• 타입 정의 주문 - 날짜지정형 입장권 주문 생성 | (4) Type Purchaser

representative

O

Traveler

• 대표 여행자에 대한 정보

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

• 타입 정의 주문 - 날짜지정형 입장권 주문 생성 | (5) Type Ticket

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자리

• option > 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" : 미국 달러

channel_product_mapping_code

O

String

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

option_code

O

String

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

quantity

O

Integer

• 각 옵션 판매량

inventory_at

O

Datetime

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

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

unit_selling_price

O

String

• 옵션 당 판매 단가

• 소수점 5자리

discount

X

String

• 옵션 당 할인가

• 소수점 5자리

discount_method

X

String

• 옵션 당 할인 방법

amount_price

O

String

• 옵션 당 최종가격

• 소수점 5자리

tickets

O

List[Ticket]

• Option > quantity 하나에 대응되는 Entity

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

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

channel_code

O

String

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

name

O

String

• 여행자 이름

national_code

O

String

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

phone

O

String

• 여행자 핸드폰 번호

email

O

String

• 여행자 이메일

additional

X

Object

• Supplier가 요구하는 추가 정보

extra

X

String

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

status_code

Integer

• 201: 정상처리

• 403: 유효하지 않은 요청 값

• 404: 유효하지 않은 API Key

• 201

• 403

• 404

data

Object

• 채널측 주문 생성 요청에 대한 AX 주문 생성 값

channel_order_code

String

• 채널측에서 생성한 주문의 식별자

channel_order_status

String

• 생성된 주문의 상태

• 주문 상태는 다음과 같습니다.

  • New : 새 주문
    Supplier pending : Supplier 대기
    Supplier confirm : Supplier 확정
    Supplier reject : Supplier 거절
    Traveler cancel : 여행자 취소
    Unavoidable cancel : 불가피한 취소

• “New”

• "Supplier pending"

• "Supplier confirm"

• ”Supplier reject"

• "Traveler cancel"

• "Unavoidable cancel"

options

List[Object]

option_code

string

• 팔린 고유한 옵션에 대한 식별자

inventory_at

datetime

• RFC 3339 형식의 UTC 기준 옵션의 Use date

ax_order_code

string

• 팔린 고유한 옵션에 대해 AX 측에서 대응되도록 생성한 주문의 식별자

ax_order_status

string

• AX 측에서 생성된 주문의 상태

• 주문 상태는 다음과 같습니다.

  • New : 새 주문
    Supplier pending : Supplier 대기
    Supplier confirm : Supplier 확정
    Supplier reject : Supplier 거절
    Traveler cancel : 여행자 취소
    Unavoidable cancel : 불가피한 취소

• “New“

• “Supplier pending“

• “Supplier confirm”

• “Supplier reject”

• “Traveler cancel”

• “Unavoidable cancel”

quantity

Integer

• 수량

tickets

List[Object]

• quantity 하나에 대응되어 생성되는 티켓의 목록

ax_ticket_code

String

• quantity 하나에 대응되어 생성되는 티켓의 식별자

ax_ticket_status

String

• 생성된 티켓의 상태

• 티켓의 상태는 다음과 같습니다.

  • New : Not used
    Used : 사용 처리됨
    Traveler canceled : 여행자 취소
    Supplier canceled : supplier 취소

• “New“

• “Used”

• "Traveler canceled”

• "Supplier canceled"