주문서 API

주문서는 다음과 같이 구분됩니다. (주문 기준: 일반, 선물하기 주문서, 회원 기준 : 회원, 비회원 주문서)

최초 주문서 진입 시 주문서 검증 API 를 호출하여 다음 정보를 검증합니다.

(요청 정보, 주문자 나이, 선물하기 주문 시 회원 여부, 비회원 주문 시 인증 여부)

검증된 요청에 대해 주문서 조회 API 를 호출하여 다음 정보를 조회합니다. (회원, 결제수단, 주문상품, 배송, 프로모션, 적립 정보)

회원 주문서는 사은행사 조회 API 를 호출하여 사은행사 정보를 조회하고 사은행사가 존재한다면, 결제 전에 사은행사 팝업을 노출합니다.

쿠폰 및 혜택 팝업 노출 시 혜택정보조회 API 를 호출하여 사용 가능한 혜택정보와 최대혜택정보를 조회합니다.

주문서에서 주문배송지 정보가 변경될 때마다 배송비 조회 API 를 호출하여 배송비를 재조회합니다.

회원 주문서는 혜택정보가 변경될 때마다 적립정보 API 를 호출하여 적립정보를 재조회합니다.

주문 시 주문생성에 필요한 필수 값들을 검증하고, 주문번호 채번 API 를 호출하여 주문번호를 채번합니다.

채번 완료 후 결제정보 생성에 필요한 결제 API 들을 호출합니다.

결제에 필요한 인증 작업이 끝나면 주문 생성 API 를 호출하여 주문을 생성합니다.

주문에 성공하면 주문완료 페이지에서 주문완료정보 조회 API 를 호출하여 주문정보를 사용자에게 노출합니다.

주요 기능

주문서는 상품 상세, 장바구니 화면에서 진입 가능합니다.
주문서는 15세 이상 회원이나 인증을 통과한 비회원만 진입 가능합니다.
주문서는 주문 기준으로 일반 주문과 선물하기 주문서, 회원 정보 기준으로는 회원 주문, 비회원 주문서로 구분됩니다.
주문서는 주문 상품 별 사용 가능한 결제수단 중 중복된 수단을 분류 후에 해당 결제수단에 필요한 정보를 조회하고 노출합니다.
상품 별 배송정보에 따라 배송그룹을 나뉘어 배송비를 조회합니다.
배송비는 배송지의 도서산간 여부에 따라 추가 배송비가 부과될 수 있습니다.
주문서는 회원 주문이고, 사은행사가 존재할 때 결제 전 사은행사 팝업을 노출합니다.

프로세스 정의

번호	구분	설명
1

API 기능 목록

API	설명	Server	매소드	비고
주문서 진입 검증	주문서 진입 시 사용자 검증을 진행합니다.	Order	POST	Swqgger API
주문서 조회	주문서 정보를 조회합니다. 주문서 정보에는 회원, 결제수단, 주문상품, 배송, 프로모션, 적립 정보들이 포함됩니다.	Order	POST	Swqgger API 1)회원 정보 조회 /api/member/v1/front/memberInfo 2)비회원 정보 조회 /api/member/v1/front/nonMemberInfo 3)회원 기본배송지 조회 /api/member/v1/front/dlvpInfo 4)상품별 사용가능 결제수단 조회 /api/goods/v1/detail/goodsPayMeanList
주문서 사은행사 조회	주문 상품 정보를 이용하여 사은행사를 조회합니다. 사은 행사가 존재할 경우, 결제하기 이전에 해당 사은 행사 정보를 포함하는 팝업을 노출합니다.	Order	POST	Swqgger API
주문서 배송비 조회	주문 정보에 대한 배송비를 조회합니다.	Order	POST	Swqgger API
주문서 적립정보 조회	주문 정보에 대한 적립 정보를 조회합니다.	Order	POST	Swqgger API
주문번호 채번	주문 생성 정보에 필요한 주문번호를 채번합니다.	Order	GET	Swqgger API
주문하기	주문을 생성합니다. 주문에 성공하면 주문자에게 알림톡과 메일을 발송합니다.	Order	POST	Swqgger API 1)회원 정보 조회 /api/member/v1/front/memberInfo 2)임직원할인한도 업데이트 /api/member/v1/staff/dcLimIncDec 3)상품 재고 업데이트 /api/goods/v1/order/stockUpdate
주문완료정보 조회	주문 성공 후 주문완료 정보를 조회합니다. 조회 요청한 주문에 클레임이 진행되었다면 예외가 발생합니다.	Order	POST	Swqgger API

용어 정의

명칭

설명

비고

배송그룹

상품의 상품번호, 합배송 가능여부, 협력사번호, 배송정책번호, 판매방식, 배송방식, 배송예약일시, 출고예정일시 등 정보를 기준으로 함께 배송이 가능한 상품의 집합입니다.

이 집합 별로 배송비를 계산합니다.

합배송

주문서 내의 여러 개의 상품을 배송그룹 별로 배송하는 방식

기타 참고사항

배송비를 조회하기 전 상품 별 상세 정보를 이용하여 배송 그룹을 생성합니다.
(합배송 가능여부, 협력사번호, 배송정책번호, 판매방식, 배송방식, 상품번호, 배송예약일시, 출고예정일시)
주문완료정보 조회 API 요청 시 비회원 주문의 경우 비회원 로그인 처리 API를 통해 생성된 쿠키 값을 필수로 전달해야 합니다.