Endpoint	product environment: https://prod.ax-cloud.com/v1/channel/orders/tour test environment: https://test.ax-cloud.com/v1/channel/orders/tour
Method	POST
Description	새 주문 등록
Content-Type	application/json
Headers > Authorization	Token {api_key}

2) Body Parameter

(1) Parameter

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

...

(2) Type

Order

Name	Required	Type	Description

status_code

Integer

정상 처리 시 201

data

Object

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

channel_order_

code

id

O

String

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

channel_order_status

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

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

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	여행자가 작성한 기타 정보

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	여행자가 작성한 기타 정보

3) Response

Name				Type	Description	Example
status_code				Integer	201: 정상처리 403: 404:	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" : Supplier 거절 "Traveler cancel" : 여행자 취소 "Unavoidable cancel" : 불가피한 취소
	depth_combinations			List[Object]
		dc_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 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” canceled : 여행자 취소 "Supplier canceled " : supplier 취소	“New“ “Used” "Traveler canceled” "Supplier canceled"

Expand

title	Status Code : 201 Response: AX Cloud 에 생성된 주문

Code Block

{
  "channel_order_code": "915c1218-f41c-492b-bb0b-96177ff4d2ee",
  "channel_order_status": "New",
  "depth_combinations": [
    {
      "dc_code": "d96b2ed4-12c5-4fb5-ae94-4f39b11ee980",
      "inventory_at": "2017-05-23 23:30:00",
      "ax_order_code": "b9872ed4-12c5-4fb5-ae18-4f39b11ee912",
      "ax_order_status": "New",
      "quantity": "2",
      "tickets": [
        {
          "ax_ticket_code": "827c0381-f41c-492b-bb0b-88229ff4d2ee",
          "ax_ticket_status": "New"
        },
        {
          "ax_ticket_code": "827c9283-f41c-492b-bb0b-88102ff4d8ee",
          "ax_ticket_status": "New"
        }
      ]
    },
    {
      "dc_code": "d96b2ed4-12c5-4fb5-ae94-4f39b11ee981",
      "inventory_at": "2017-05-23 23:30:00",
      "ax_order_code": "b9872ed4-12c5-4fb5-ae18-4f39b11ee913",
      "ax_order_status": "New",
      "tickets": [
        {
          "ax_ticket_code": "087c2263-f41c-492b-bb0b-87263ff4d2ee",
          "ax_ticket_status": "New"
        },
        {
          "ax_ticket_code": "829c9283-f41c-492b-bb0b-65738ff4d8fe",
          "ax_ticket_status": "New"
        }
      ]
    },
  ]
}

...

Code Block

curl -X 'POST' \
  'https://test.ax-cloud.com/v1/channel/orders/tour' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Token api_key_secret" \
  -d '{
  "depth_combinations": [
    {
      "channel_product_mapping_code": "af01c7c4-1637-46fb-b289-a090a9be0397",
      "dc_code": "d96b2ed4-12c5-4fb5-ae94-4f39b11ee980",
      "quantity": 2,
      "inventory_at": "2017-05-23 23:30:00",
      "unit_selling_price": 2222,
      "discount": 22,
      "discount_method": "쿠폰 할인",
      "amount_price": "2200",
      "tickets": [
        {
          "channel_code": "d96b2td4-15c5-4fb5-ae94-4f36667ee980",
          "name": "first last",
          "national_code": "82",
          "phone": "01012345678",
          "email": "user@example.com",
          "additional": {
            "english_name": "first last",
            "korean_name": "성 이름"
          },
          "extra": "소라 알레르기가 있습니다."
        }, {
          "channel_code": "d96b2td4-15c5-4fb5-ae94-4f36667ee981",
          "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": "2017-05-23 23:30:00",
    "purchase_requested_at": "2017-05-23 23:30:00",
    "reserved_at": "2017-05-23 23:30:00",
    "reservation_requested_at": "2017-05-23 23:30:00",
    "sub_total": "4444",
    "discount_method": "주문 전체 10% 할인",
    "discount": "444",
    "total": "4000",
    "status": "New",
    "is_voucher": true,
    "comment": "string",
    "currency": "KRW"
  },
  "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": "폐쇄 공포증이 있습니다."
  }
}'

4. Type

1) 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" : 미국 달러

2) 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

3) 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	여행자가 작성한 기타 정보

4) 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	여행자가 작성한 기타 정보

Version	Old Version 72	New Version 73
Changes made by	송훈일Neil	김상효Mike (Unlicensed)
Saved on	Apr 06, 2023	Apr 06, 2023

Versions Compared

Key

2) Body Parameter

(1) Parameter

(2) Type

3) Response

4. Type

1) Order

2) Depth Combination

3) Purchaser

4) Ticket

Content Comparison

Versions Compared

Key

2) Body Parameter

(1) Parameter

(2) Type

3) Response

4. Type

1) Order

2) Depth Combination

3) Purchaser

4) Ticket