Versions Compared

Version Old Version 48 New Version 49
Changes made by

송훈일Neil

송훈일Neil

Saved on

Key

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

...

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"} # 불가피한 취소

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",
    },
    {
      "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",
    },
  ]
}

4) Error Spec

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

...

Code Block
curl -X 'POST' \
  'https://prod.ax-cloud.com/v1/channel/orders/tour' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'X-CSRFTOKEN: gVNVnmaKfzEovZJFYXnxVkZsluzfXFWJDDj9lyq1WuSHuKPpBdgv1bVTiAVrgNqu' \
  -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:4100:2500.409Z000Z",
      "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": "1",
    "is_voucher": true,
    "comment": "string",
    "currency": "1"
  },
  "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": "폐쇄 공포증이 있습니다."
  }
}'

...