Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 5 Next »


1. Structure

  • Order 도메인을 쉽게 이해하기 위해 Order, Depth Combination, Purchaser, Traveler에 대한 이해도가 요구됩니다.

1) Order

  • 위 API에서 하나의 주문에 대응되는 객체

  • 하나의 주문 생성에 필요한 정보를 담습니다.

Name

Required

Type

Description

channel_order_id

O

String

  • 채널에서 주문을 식별하기 위해 부여한 ID

purchased_at

O

Datetime

  • UTC 기준 상품이 팔린 datetime

purchase_requested_at

X

Datetime

  • UTC 기준 구매 요청이 발생한 datetime

reserved_at

X

Datetime

  • UTC 기준 예약이 발생한 datetime

reservation_requested_at

X

Datetime

  • UTC 기준 예약 요청이 발생한 datetime

sub_total

O

String

  • 소수점 5자리까지 표현

  • depth_combination > travelers에 기입된 unit_selling_price 총합

discount_method

X

String

  • 주문 전체에 적용된 할인 방법

discount

X

String

  • 주문 전체에 적용된 할인가

total

O

String

  • 최종가

  • 소수점 5자리까지 표현

status

O

String

  • 1, 2, 3, 4, 5, 6 중 하나의 값을 입력

  • 실제 의미는 아래 매핑을 참고

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

is_voucher

O

Bool

  • voucher가 있는 상품 : true

  • voucher가 없는 상품 : false

comment

X

String

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

currency

O

String

  • 상품이 팔린 화폐

  • 1, 2 중 하나의 값을 입력

  • 실제 의미는 아래 매핑을 참고

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

2) Depth Combination

  • 위 API에서 상품의 하나의 옵션에 대응되는 객체

  • 비정형 데이터인 다양한 카테고리의 다양한 상품을 유연하게 모두 지원하기 위한 구조

Name

Required

Type

Description

channel_product_mapping_id

O

String

  • 채널과 상품을 매핑한 table의 id.

dc_id

O

String

  • depth combination의 id

quantity

O

Int

  • 옵션 판매량

use_date

O

Datetime

  • 팔린 상품의 use date를 datetime으로 표현한 값

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

unit_selling_price

O

String

  • 판매단가

  • 소수점 5자리까지 표현

discount

X

String

  • 할인가

  • 소수점 5자리까지 표현

discount_method

X

String

  • 할인 방법

amount_price

O

String

  • 최종가

  • 소수점 5자리까지 표현

travelers

O

List[Traveler]

  • 여행자 목록

  • Type > Traveler 참고

3) Purchaser

  • 상품을 구매한 구매자의 정보를 가진다.

Name

Required

Type

Description

is_required_more_information

O

Bool

  • 추가적으로 더 입력받을 정보가 있다면 true

  • 추가적으로 더 입력받을 정보가 없다면 false

name

O

String

  • 구매자 이름

national_code

O

String

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

phone

O

String

  • 여행자 핸드폰 번호

email

O

String

  • 여행자 이메일

additional

X

Dict

  • Supplier가 요구하는 추가 정보

extra

O

String

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

4) Traveler

  • 위 API에서 하나의 옵션 quantity에 대응되는 객체

  • 여행자의 정보를 가진다.

  • 별도의 여행자 정보가 없다면 구매자의 정보로 대신한다.

Name

Required

Type

Description

name

O

String

  • 여행자 이름

national_code

O

String

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

phone

O

String

  • 여행자 핸드폰 번호

email

O

String

  • 여행자 이메일

additional

X

Dict

  • Supplier가 요구하는 추가 정보

extra

X

String

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

  • No labels