Versions Compared

Key

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

...

Endpoint

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

Method

POST

Description

새 주문 등록

Content-Type

application/json

Headers > Authorization

Token {api_key}

Headers > Channel

Code {channel_code}

...

Name

Required

Type

Description

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 정보로 값을 채웁니다.

3) Response

Name

Type

Description

status_code

Integer

  • 정상 처리 시 201

data

Object

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

channel_order_code

String

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

channel_order_status

String

  • 생성된 주문의 상태

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

    • {"1": "New"}, # 새 주문
      {"2": "Supplier pending"}, # Supplier 대기
      {"3": "Supplier confirm"}, # Supplier 확정
      {"4": "Supplier reject"}, # Supplier 거절
      {"5": "Traveler cancel"}, # 여행자 취소
      {"6": "Unavoidable cancel"} # 불가피한 취소

depth_combinations

list[Object]

dc_code

string

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

use_date

datetime

  • UTC 기준 옵션의 Use date

ax_order_code

string

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

ax_order_status

string

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

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

    • {"1": "New"}, # 새 주문
      {"2": "Supplier pending"}, # Supplier 대기
      {"3": "Supplier confirm"}, # Supplier 확정
      {"4": "Supplier reject"}, # Supplier 거절
      {"5": "Traveler cancel"}, # 여행자 취소
      {"6": "Unavoidable cancel"} # 불가피한 취소

quantity

Integer

  • 수량

tickets

list[Object]

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

ticket_code

String

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

ticket_status

String

  • 생성된 티켓의 상태

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

    • {"1": "New"}, # Not used
      {"2": "Used"}, # 사용 처리됨
      {"3": "Traveler canceled”}, # 여행자 취소
      {"4": "Supplier canceled"} # supplier 취소

Expand
titleStatus Code : 201 Response: AX Cloud 에 생성된 주문의 식별자 Code주문
Code Block
{
  "channel_order_code": "915c1218-f41c-492b-bb0b-96177ff4d2ee",
  "channel_order_status": "1",
  "depth_combinations": [
    {
      "dc_code": "d96b2ed4-12c5-4fb5-ae94-4f39b11ee980",
      "use_date": "2022-01-21T10:00:00.000Z",
      "ax_order_code": "b9872ed4-12c5-4fb5-ae18-4f39b11ee912",
      "ax_order_status": "1",
      "quantity": "2",
      "tickets": [
        {
          "ticket_code": "827c0381-f41c-492b-bb0b-88229ff4d2ee",
          "ticket_status": "1"
        },
        {
          "ticket_code": "827c9283-f41c-492b-bb0b-88102ff4d8ee",
          "ticket_status": "1"
        }
      ]
    },
    {
      "dc_code": "d96b2ed4-12c5-4fb5-ae94-4f39b11ee981",
      "use_date": "2022-01-21T10:00:00.000Z",
      "ax_order_code": "b9872ed4-12c5-4fb5-ae18-4f39b11ee913",
      "ax_order_status": "1",
      "tickets": [
        {
          "ticket_code": "087c2263-f41c-492b-bb0b-87263ff4d2ee",
          "ticket_status": "1"
        },
        {
          "ticket_code": "829c9283-f41c-492b-bb0b-65738ff4d8fe",
          "ticket_status": "1"
        }
      ]
    },
  ]
}

4) Error Spec

Expand
titleStatus Code : 400 Cause: 유효하지 않은 요청 값
Code Block
{'depth_combinations': '이 필드는 null일 수 없습니다.'}

...