Versions Compared

Key

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

...

Name

Type

Description

status_code

Integer

  • 정상 처리 시 201

data

Object

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

channel_order_code

String

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

channel_order_status

String

  • 생성된 주문의 상태

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

    • {"1New" : "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 측에서 생성된 주문의 상태

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

    • {"1New" : "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

  • 생성된 티켓의 상태

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

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

Expand
titleStatus Code : 201 Response: AX Cloud 에 생성된 주문
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": "1New",
      "quantity": "2",
      "tickets": [
        {
          "ticket_code": "827c0381-f41c-492b-bb0b-88229ff4d2ee",
          "ticket_status": "1New"
        },
        {
          "ticket_code": "827c9283-f41c-492b-bb0b-88102ff4d8ee",
          "ticket_status": "1New"
        }
      ]
    },
    {
      "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": "1New",
      "tickets": [
        {
          "ticket_code": "087c2263-f41c-492b-bb0b-87263ff4d2ee",
          "ticket_status": "1New"
        },
        {
          "ticket_code": "829c9283-f41c-492b-bb0b-65738ff4d8fe",
          "ticket_status": "1New"
        }
      ]
    },
  ]
}

4) Error Spec

...

Code Block
curl -X 'POST' \
  'https://prod.ax-cloud.com/v1/channel/orders/day-ticket' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Token api_key_secret" \
  -H "Channel: Code code_secret" \
  -d '{
  "depth_combinations": [
    {
      "channel_product_mapping_code": "af01c7c4-1637-46fb-b289-a090a9be0397",
      "dc_code": "d96b2ed4-12c5-4fb5-ae94-4f39b11ee980",
      "quantity": 2,
      "use_date": "2022-01-21T10:41:25.409Z",
      "unit_selling_price": 2222,
      "discount": 22,
      "discount_method": "쿠폰 할인",
      "amount_price": "2200",
      "tickets": [
        {
          "name": "first last",
          "national_code": "82",
          "phone": "01012345678",
          "email": "user@example.com",
          "additional": {
            "english_name": "first last",
            "korean_name": "성 이름"
          },
          "extra": "폐쇄 공포증이 있습니다."
        }
      ]
    }
  ],
  "order": {
    "channel_order_code": "d96b3ed4-12c5-4fb5-ae22-4f39b11ee980",
    "purchased_at": "2022-01-21T10:41:25.409Z",
    "purchase_requested_at": "2022-01-21T10:41:25.409Z",
    "reserved_at": "2022-01-21T10:41:25.409Z",
    "reservation_requested_at": "2022-01-21T10:41:25.409Z",
    "sub_total": "4444",
    "discount_method": "주문 전체 10% 할인",
    "discount": "444",
    "total": "4000",
    "status": "2Supplier pending",
    "is_voucher": true,
    "comment": "string",
    "currency": "1KRW"
  },
  "purchaser": {
    "is_required_more_information": true,
    "name": "first last",
    "national_code": "82",
    "phone": "01012345678",
    "email": "user@example.com",
    "additional": {
      "english_name": "first last",
      "korean_name": "성이름"
    },
    "extra": "폐쇄 공포증이 있습니다."
  },
  "representative": {
    "name": "first last",
    "national_code": "82",
    "phone": "01012345678",
    "email": "user@example.com",
    "additional": {
      "english_name": "first last",
      "korean_name": "성이름"
    },
    "extra": "폐쇄 공포증이 있습니다."
  }
}'

...

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

  • 주문의 상태

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

is_voucher

O

Boolean

  • True

    • voucher가 있는 상품

  • False

    • voucher가 없는 상품

comment

X

String

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

currency

O

String

  • 상품이 팔린 화폐

  • {"1KRW" : "KRW"}, # 원화
    {"2USD" : "USD"} # 미국 달러

2) Depth Combination

...