> For the complete documentation index, see [llms.txt](https://tech.x2bee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tech.x2bee.com/api/store-front-api/order-api/undefined-2.md).
# 장바구니
## 장바구니 옵션변경
> \## 기능설명\
> \* 선택한 상품의 옵션을 변경합니다.\
> \---\
> \## 상세설명\
> \* 파라미터로 넘어온 \*\*장바구니 번호\*\*에 해당하는 데이터를 변경\
> \* 단품번호, 수량을 업데이트\
> \* 이미 담겨있는 단품으로 변경하면 이미 담겨있는 단품은 삭제하고 그 수량을 더해 업데이트\
> \* 호출 시, 검증이 수행 되는데 실패 시 변경 불가\
> \* 상품 판매 상태, 구매 가능 수량, 장바구니 최대 담기 개수 초과 확인\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240711: 정기주문, 선물하기 사용 설정을 체크
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/basket/optionChange":{"put":{"tags":["장바구니"],"summary":"장바구니 옵션변경","description":" ## 기능설명\n * 선택한 상품의 옵션을 변경합니다.\n ---\n ## 상세설명\n * 파라미터로 넘어온 **장바구니 번호**에 해당하는 데이터를 변경\n * 단품번호, 수량을 업데이트\n * 이미 담겨있는 단품으로 변경하면 이미 담겨있는 단품은 삭제하고 그 수량을 더해 업데이트\n * 호출 시, 검증이 수행 되는데 실패 시 변경 불가\n * 상품 판매 상태, 구매 가능 수량, 장바구니 최대 담기 개수 초과 확인\n---\n ## 수정 번호\n * Release v2.00_240711: 정기주문, 선물하기 사용 설정을 체크\n","operationId":"optionChangeBasket","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterBasketRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RegisterBasketResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RegisterBasketRequest":{"required":["bsketGbCd","bsketInfGbCd","bsketNo","chlDtlNo","chlNo","goodsNo","infDispCtgNo","infDispCtgNoGbCd","itmNo","ordGbCd","repDispCtgNo"],"type":"object","properties":{"bsketNo":{"type":"integer","description":"장바구니번호","format":"int64"},"bsketInfGbCd":{"type":"string","description":"OM042(장바구니 유입 구분 코드)\n 10: BASKET_BUY(장바구니구매)\n,20: NOW_BUY(바로구매)\n,30: WISH_BUY(위시리스트구매)\n","enum":["BASKET_BUY","NOW_BUY","WISH_BUY"]},"bsketGbCd":{"type":"string","description":"OM001(장바구니 구분 코드)\n 10: HDEL(택배)\n 20: STORE_PICK_UP(매장수령)\n 30: QUICK_DELIVERY(퀵배송)\n 40: REGULAR_DELIVERY(정기주문)\n","enum":["HDEL","STORE_PICK_UP","QUICK_DELIVERY","REGULAR_DELIVERY"]},"chlNo":{"type":"string","description":"채널번호"},"chlDtlNo":{"type":"string","description":"채널상세번호"},"infDispCtgNoGbCd":{"type":"string","description":"OM041(유입전시카테고리번호구분코드)\n 01: DISPLAY_STORE(전시매장)\n,02: EXHIBITIONS(기획전)\n,06: SEARCH_SALES(검색매출)\n,07: SEARCH_AD_BANNER(검색광고배너)\n,08: FLOATING_BANNER(플로팅배너)\n,09: WISHLIST(위시리스트)\n,10: NONE(유입전시번호없음)\n","enum":["DISPLAY_STORE","EXHIBITIONS","SEARCH_SALES","SEARCH_AD_BANNER","FLOATING_BANNER","WISHLIST","NONE"]},"infDispCtgNo":{"type":"string","description":"유입전시카테고리번호"},"repDispCtgNo":{"type":"string","description":"대표전시카테고리번호"},"conrNo":{"type":"string","description":"코너번호"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"bsketQty":{"minimum":1,"type":"integer","description":"장바구니 수량","format":"int32"},"ordGbCd":{"type":"string","description":"OM002(주문 구분 코드)\n 10: 일반주문\n , 20: 선물하기\n , 30: e-쿠폰\n , 40: 제휴\n","enum":["GENERAL_ORDER","GIVE_GIFT_ORDER","E_COUPON","SUBSCRIBE_ORDER"]}},"description":"장바구니 등록 요청 DTO"},"RegisterBasketResponse":{"type":"object","properties":{"bsketNo":{"type":"integer","description":"장바구니번호","format":"int64"}},"description":"장바구니 등록 응답 DTO"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
## 장바구니 삭제
> \## 기능설명\
> \* 선택한 상품들을 장바구니에서 삭제합니다.\
> \---\
> \## 상세설명\
> \* 파라미터로 넘어온 \*\*장바구니 번호\*\*에 해당하는 데이터를 삭제\
> \* 주문완료여부를 'Y'로 업데이트\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240711: 정기주문, 선물하기 사용 설정을 체크
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/basket/deleteBasket":{"put":{"tags":["장바구니"],"summary":"장바구니 삭제","description":" ## 기능설명\n * 선택한 상품들을 장바구니에서 삭제합니다.\n ---\n ## 상세설명\n * 파라미터로 넘어온 **장바구니 번호**에 해당하는 데이터를 삭제\n * 주문완료여부를 'Y'로 업데이트\n ---\n ## 수정 번호\n * Release v2.00_240711: 정기주문, 선물하기 사용 설정을 체크\n","operationId":"deleteBasket","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BasketRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"BasketRequest":{"required":["bsketNoList"],"type":"object","properties":{"bsketGbCd":{"type":"string","description":"OM001(장바구니 구분 코드)\n 10: HDEL(택배)\n 20: STORE_PICK_UP(매장수령)\n 30: QUICK_DELIVERY(퀵배송)\n 40: REGULAR_DELIVERY(정기주문)\n","enum":["HDEL","STORE_PICK_UP","QUICK_DELIVERY","REGULAR_DELIVERY"]},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"bsketNoList":{"type":"array","description":"장바구니번호리스트","items":{"type":"integer","description":"장바구니번호리스트","format":"int64"}}},"description":"장바구니 조건 DTO"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
## 장바구니 상품 주문가능여부 체크
> \## 기능설명\
> \* 장바구니에서 바로구매 클릭 시, 주문서로 넘기기 전 선택한 장바구니 상품 데이터가 주문가능한지 검사합니다.\
> \---\
> \## 상세설명\
> \* 검증 실패 시, 주문서로 넘어가지 않고 장바구니에서 에러 메시지 노출\
> \* 상품: 상품 판매 상태, 구매 가능 수량, 재고, 예약상품 예약가능 일시, 비회원 성인상품 구매 불가, 성인상품 인증 여부\
> \* 주문자: 구매제한회원 확인, 연령 확인\
> \---\
> \## 수정번호\
> \* Release v2.00\_240401 : 정기배송신청서 진입 시의 자동결제카드 체크 제거\
> \* Release v2.00\_240711: 정기주문, 선물하기 사용 설정을 체크\
> \* Release v2.00\_240729: 티켓 상품에 대한 유효성 검증 추가
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/basket/validateBasket":{"post":{"tags":["장바구니"],"summary":"장바구니 상품 주문가능여부 체크","description":" ## 기능설명\n * 장바구니에서 바로구매 클릭 시, 주문서로 넘기기 전 선택한 장바구니 상품 데이터가 주문가능한지 검사합니다.\n ---\n ## 상세설명\n * 검증 실패 시, 주문서로 넘어가지 않고 장바구니에서 에러 메시지 노출\n * 상품: 상품 판매 상태, 구매 가능 수량, 재고, 예약상품 예약가능 일시, 비회원 성인상품 구매 불가, 성인상품 인증 여부\n * 주문자: 구매제한회원 확인, 연령 확인\n ---\n ## 수정번호\n * Release v2.00_240401 : 정기배송신청서 진입 시의 자동결제카드 체크 제거\n * Release v2.00_240711: 정기주문, 선물하기 사용 설정을 체크\n * Release v2.00_240729: 티켓 상품에 대한 유효성 검증 추가\n","operationId":"validateBasket","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateBasketRequest"}}},"required":true},"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"ValidateBasketRequest":{"required":["bsketGbCd","bsketNoList","ordGbCd"],"type":"object","properties":{"ordGbCd":{"type":"string","description":"OM002(주문 구분 코드)\n 10: 일반주문\n , 20: 선물하기\n , 30: e-쿠폰\n , 40: 제휴\n","enum":["GENERAL_ORDER","GIVE_GIFT_ORDER","E_COUPON","SUBSCRIBE_ORDER"]},"bsketGbCd":{"type":"string","description":"OM001(장바구니 구분 코드)\n 10: HDEL(택배)\n 20: STORE_PICK_UP(매장수령)\n 30: QUICK_DELIVERY(퀵배송)\n 40: REGULAR_DELIVERY(정기주문)\n","enum":["HDEL","STORE_PICK_UP","QUICK_DELIVERY","REGULAR_DELIVERY"]},"bsketNoList":{"type":"array","description":"장바구니번호리스트","items":{"type":"integer","description":"장바구니번호리스트","format":"int64"}}}},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
## 장바구니 등록
> \## 기능설명\
> \* 선택한 상품을 장바구니에 등록합니다.\
> \---\
> \## 상세설명\
> \* 비회원은 최초 등록 시, 세션번호를 생성하여 쿠키에 저장\
> \* 바로구매, 장바구니 담기 수행 시, 호출\
> \* 호출 시, 검증이 수행 되는데 실패 시 등록 불가\
> \* 공통: 상품 판매 상태, 구매 가능 수량\
> \* 바로구매: 상품 재고, 예약 상품 예약 가능 일시, 비회원 성인 상품 구매 불가, 성인 상품 인증 여부, 배송비 정책 존재 여부, 주문자 구매제한회원 여부/연령\
> \* 장바구니 담기: 배송비 정책 존재 여부, 장바구니 최대 담기 개수 초과 확인\
> \---\
> \## 특이사항\
> \* 바로구매거나 장바구니 담기 케이스에서 새로운 상품이 INSERT되었을 때, INSERT된 ROW의 \*\*장바구니 번호(BSKET\_NO)\*\* 리턴(기존 상품 수량 UPDATE일 때는 NULL 리턴)\
> \* 장바구니에 담을 수 있는 최대 수량은 공통코드 ST002, 코드"10"의 참조1값입니다.\
> \* 등록된 장바구니의 보관기간은 공통코드 ST003, 코드"10"의 참조1값입니다. 보관기간이 지나면 배치로 삭제됩니다.\
> \---\
> \## 수정 번호\
> \* Release v2.00\_240711: 정기주문, 선물하기 사용 설정을 체크\
> \* Release v2.00\_240729: 티켓 상품에 대한 유효성 검증 추가
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/basket/registerBasket":{"post":{"tags":["장바구니"],"summary":"장바구니 등록","description":" ## 기능설명\n * 선택한 상품을 장바구니에 등록합니다.\n ---\n ## 상세설명\n * 비회원은 최초 등록 시, 세션번호를 생성하여 쿠키에 저장\n * 바로구매, 장바구니 담기 수행 시, 호출\n * 호출 시, 검증이 수행 되는데 실패 시 등록 불가\n * 공통: 상품 판매 상태, 구매 가능 수량\n * 바로구매: 상품 재고, 예약 상품 예약 가능 일시, 비회원 성인 상품 구매 불가, 성인 상품 인증 여부, 배송비 정책 존재 여부, 주문자 구매제한회원 여부/연령\n * 장바구니 담기: 배송비 정책 존재 여부, 장바구니 최대 담기 개수 초과 확인\n ---\n ## 특이사항\n * 바로구매거나 장바구니 담기 케이스에서 새로운 상품이 INSERT되었을 때, INSERT된 ROW의 **장바구니 번호(BSKET_NO)** 리턴(기존 상품 수량 UPDATE일 때는 NULL 리턴)\n * 장바구니에 담을 수 있는 최대 수량은 공통코드 ST002, 코드\"10\"의 참조1값입니다.\n * 등록된 장바구니의 보관기간은 공통코드 ST003, 코드\"10\"의 참조1값입니다. 보관기간이 지나면 배치로 삭제됩니다.\n ---\n ## 수정 번호\n * Release v2.00_240711: 정기주문, 선물하기 사용 설정을 체크\n * Release v2.00_240729: 티켓 상품에 대한 유효성 검증 추가\n","operationId":"registerBasket","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterBasketRequest"}}},"required":true},"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RegisterBasketResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"RegisterBasketRequest":{"required":["bsketGbCd","bsketInfGbCd","bsketNo","chlDtlNo","chlNo","goodsNo","infDispCtgNo","infDispCtgNoGbCd","itmNo","ordGbCd","repDispCtgNo"],"type":"object","properties":{"bsketNo":{"type":"integer","description":"장바구니번호","format":"int64"},"bsketInfGbCd":{"type":"string","description":"OM042(장바구니 유입 구분 코드)\n 10: BASKET_BUY(장바구니구매)\n,20: NOW_BUY(바로구매)\n,30: WISH_BUY(위시리스트구매)\n","enum":["BASKET_BUY","NOW_BUY","WISH_BUY"]},"bsketGbCd":{"type":"string","description":"OM001(장바구니 구분 코드)\n 10: HDEL(택배)\n 20: STORE_PICK_UP(매장수령)\n 30: QUICK_DELIVERY(퀵배송)\n 40: REGULAR_DELIVERY(정기주문)\n","enum":["HDEL","STORE_PICK_UP","QUICK_DELIVERY","REGULAR_DELIVERY"]},"chlNo":{"type":"string","description":"채널번호"},"chlDtlNo":{"type":"string","description":"채널상세번호"},"infDispCtgNoGbCd":{"type":"string","description":"OM041(유입전시카테고리번호구분코드)\n 01: DISPLAY_STORE(전시매장)\n,02: EXHIBITIONS(기획전)\n,06: SEARCH_SALES(검색매출)\n,07: SEARCH_AD_BANNER(검색광고배너)\n,08: FLOATING_BANNER(플로팅배너)\n,09: WISHLIST(위시리스트)\n,10: NONE(유입전시번호없음)\n","enum":["DISPLAY_STORE","EXHIBITIONS","SEARCH_SALES","SEARCH_AD_BANNER","FLOATING_BANNER","WISHLIST","NONE"]},"infDispCtgNo":{"type":"string","description":"유입전시카테고리번호"},"repDispCtgNo":{"type":"string","description":"대표전시카테고리번호"},"conrNo":{"type":"string","description":"코너번호"},"goodsNo":{"type":"string","description":"상품번호"},"itmNo":{"type":"string","description":"단품번호"},"bsketQty":{"minimum":1,"type":"integer","description":"장바구니 수량","format":"int32"},"ordGbCd":{"type":"string","description":"OM002(주문 구분 코드)\n 10: 일반주문\n , 20: 선물하기\n , 30: e-쿠폰\n , 40: 제휴\n","enum":["GENERAL_ORDER","GIVE_GIFT_ORDER","E_COUPON","SUBSCRIBE_ORDER"]}},"description":"장바구니 등록 요청 DTO"},"RegisterBasketResponse":{"type":"object","properties":{"bsketNo":{"type":"integer","description":"장바구니번호","format":"int64"}},"description":"장바구니 등록 응답 DTO"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
## 장바구니 병합
> \## 기능설명\
> \* 로그인 시에, 비회원일 때 담았던 장바구니 상품들을 로그인한 회원 장바구니로 합칩니다.\
> \---\
> \## 상세설명\
> \* 쿠키에 저장된 세션번호로 비회원 장바구니 상품 조회\
> \* 장바구니유입구분코드(OM042)가 바로구매인 데이터들은 로그인한 회원번호로 업데이트\
> \* 장바구니유입구분코드(OM042)가 장바구니 담기, 위시리스트인 데이터들은 기존 데이터 삭제 후 로그인 한 회원 데이터로 새로 생성
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/basket/combineBasket":{"post":{"tags":["장바구니"],"summary":"장바구니 병합","description":" ## 기능설명\n * 로그인 시에, 비회원일 때 담았던 장바구니 상품들을 로그인한 회원 장바구니로 합칩니다.\n ---\n ## 상세설명\n * 쿠키에 저장된 세션번호로 비회원 장바구니 상품 조회\n * 장바구니유입구분코드(OM042)가 바로구매인 데이터들은 로그인한 회원번호로 업데이트\n * 장바구니유입구분코드(OM042)가 장바구니 담기, 위시리스트인 데이터들은 기존 데이터 삭제 후 로그인 한 회원 데이터로 새로 생성\n","operationId":"combineBsket","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공"},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
## 장바구니 총 수량 조회
> \## 기능설명\
> \* 비회원 혹은 현재 로그인 한 회원의 장바구니 총 수량을 조회합니다.\
> \---\
> \## 상세설명\
> \* 회원은 \*\*회원번호\*\*로 조회\
> \* 비회원은 쿠키에 저장되어 있는 \*\*세션번호\*\*로 조회\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425: 장바구니 총 수량 조회 조건에 사이트 번호 추가
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/basket/totBsketCnt":{"get":{"tags":["장바구니"],"summary":"장바구니 총 수량 조회","description":" ## 기능설명\n * 비회원 혹은 현재 로그인 한 회원의 장바구니 총 수량을 조회합니다.\n ---\n ## 상세설명\n * 회원은 **회원번호**로 조회\n * 비회원은 쿠키에 저장되어 있는 **세션번호**로 조회\n ---\n ## 수정번호\n * Release v2.00_240425: 장바구니 총 수량 조회 조건에 사이트 번호 추가\n","operationId":"getBasketTotalCount","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"integer","format":"int32"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
## 가장 최근에 담은 장바구니 구분(OM001) 조회
> \## 기능설명\
> \* 가장 최근에 담은 장바구니 구분(OM001)을 조회합니다.\
> \---\
> \## 상세설명\
> \* 비회원은 장바구니가 구분되어 있지 않아 해당하지 않으며 회원의 경우는 \*\*회원번호\*\*로 조회\
> \* 주문완료여부가 'N', 장바구니유입구분코드(OM042)가 \[장바구니 담기, 위시리스트]인 장바구니 데이터
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/basket/getRecentBasketType":{"get":{"tags":["장바구니"],"summary":"가장 최근에 담은 장바구니 구분(OM001) 조회","description":" ## 기능설명\n * 가장 최근에 담은 장바구니 구분(OM001)을 조회합니다.\n ---\n ## 상세설명\n * 비회원은 장바구니가 구분되어 있지 않아 해당하지 않으며 회원의 경우는 **회원번호**로 조회\n * 주문완료여부가 'N', 장바구니유입구분코드(OM042)가 [장바구니 담기, 위시리스트]인 장바구니 데이터\n","operationId":"getRecentBasketType","parameters":[{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"type":"string"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```
## 장바구니 조회
> \## 기능설명\
> \* 장바구니에 담겨있는 상품을 조회합니다.\
> \---\
> \## 상세설명\
> \* 회원은 \*\*회원번호\*\*로 조회\
> \* 비회원은 쿠키에 저장되어 있는 \*\*세션번호\*\*로 조회\
> \* 주문완료여부가 'N', 장바구니유입구분코드(OM042)가 \[장바구니 담기, 위시리스트]인 장바구니 데이터\
> \* 배송그룹으로 묶여서 조회\
> \* 상품은 \*\*1. 배송처리방법이 센터배송 2. 장바구니 담은 최신 순\*\*으로 정렬 우선 순위를 갖고 우선 순위가 높은 상품이 포함된 배송그룹 순으로 정렬\
> \* 같은 배송정책번호의 상품 중 선택 여부에 따라 조건부무료 배송비 계산하기 위해 배송비금액(dlexAmt) 가공하지 않는다\
> \---\
> \## 수정번호\
> \* Release v2.00\_240425: 장바구니 조회 조건 사이트 번호 추가\
> \* Release v2.00\_241025: 조건부무료 상품의 조건충족에 따른 배송비 계산하지 않도록 수정
```json
{"openapi":"3.0.1","info":{"title":"X2BEE Order API","version":"v1"},"servers":[{"url":"https://api-order.x2bee.com/api/order/","description":"prd"}],"paths":{"/v1/basket/getBasket":{"get":{"tags":["장바구니"],"summary":"장바구니 조회","description":" ## 기능설명\n * 장바구니에 담겨있는 상품을 조회합니다.\n ---\n ## 상세설명\n * 회원은 **회원번호**로 조회\n * 비회원은 쿠키에 저장되어 있는 **세션번호**로 조회\n * 주문완료여부가 'N', 장바구니유입구분코드(OM042)가 [장바구니 담기, 위시리스트]인 장바구니 데이터\n * 배송그룹으로 묶여서 조회\n * 상품은 **1. 배송처리방법이 센터배송 2. 장바구니 담은 최신 순**으로 정렬 우선 순위를 갖고 우선 순위가 높은 상품이 포함된 배송그룹 순으로 정렬\n * 같은 배송정책번호의 상품 중 선택 여부에 따라 조건부무료 배송비 계산하기 위해 배송비금액(dlexAmt) 가공하지 않는다\n ---\n ## 수정번호\n * Release v2.00_240425: 장바구니 조회 조건 사이트 번호 추가\n * Release v2.00_241025: 조건부무료 상품의 조건충족에 따른 배송비 계산하지 않도록 수정\n","operationId":"getBasket","parameters":[{"name":"request","in":"query","required":true,"schema":{"$ref":"#/components/schemas/GetBasketRequest"}},{"name":"Authorization","in":"header","description":"Access Token","required":false}],"responses":{"200":{"description":"성공","content":{"*/*":{"schema":{"$ref":"#/components/schemas/BasketResponse"}}}},"900":{"description":"업무처리 오류 내용","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Response"}}}}}}}},"components":{"schemas":{"GetBasketRequest":{"required":["bsketGbCd"],"type":"object","properties":{"ordMediaCd":{"type":"string","description":"주문매체코드"},"bsketGbCd":{"type":"string","description":"장바구니구분코드"}}},"BasketResponse":{"type":"object","properties":{"groupList":{"type":"array","description":"배송그룹 리스트","items":{"$ref":"#/components/schemas/DlvGrpInfo"}},"countList":{"type":"array","description":"택배 장바구니 수량","items":{"$ref":"#/components/schemas/BasketCount"}}},"description":"장바구니 조회 응답 DTO"},"DlvGrpInfo":{"required":["basketGoodsList","deliKindCd","deliMethodCd","deliNo","deliProcTypCd","dlvAmtInfoList"],"type":"object","properties":{"dlvpSeq":{"type":"string","description":"배송지순번"},"deliNo":{"type":"string","description":"합배송번호"},"deliKindCd":{"type":"string","description":"LO009(배송종류코드)\n 10: NORMAL_DELIVERY(일반배송)\n,20: RESERVATION_DELIVERY(예약배송)\n","enum":["NORMAL_DELIVERY","RESERVATION_DELIVERY"]},"deliProcTypCd":{"type":"string","description":"PR008(배송처리유형코드)\n 10: CNTR_DLV(센터배송)\n,20: CORP_DLV(업체배송)\n,30: E_COUPON_DLV(e-쿠폰배송)\n","enum":["CNTR_DLV","CORP_DLV","E_COUPON_DLV"]},"deliMethodCd":{"type":"string","description":" LO010(배송방법코드)\n * 10 : 택배배송\n * 30 : 매장수령\n * 40 : 퀵배송\n * 50 : 해외배송\n * 60 : 무배송\n","enum":["COURIER_DELIVERY","FOUR_PM","STORE_PICK_UP","QUICK_DELIVERY","OVERSEAS_DELIVERY","NON_DELIVERY"]},"basketGoodsList":{"type":"array","description":"장바구니상품정보","items":{"$ref":"#/components/schemas/BasketGoods"}},"dlvAmtInfoList":{"type":"array","description":"배송비정보","items":{"$ref":"#/components/schemas/DlvAmtInfo"}}},"description":"배송그룹정보 DTO"},"BasketGoods":{"type":"object","properties":{"goodsNo":{"type":"string","description":"상품번호"},"deliProcTypCd":{"type":"string","description":"PR008(배송처리유형코드)\n 10: CNTR_DLV(센터배송)\n,20: CORP_DLV(업체배송)\n,30: E_COUPON_DLV(e-쿠폰배송)\n","enum":["CNTR_DLV","CORP_DLV","E_COUPON_DLV"]},"deliPolcNo":{"type":"string","description":"배송정책번호"},"deliNo":{"type":"string","description":"배송번호"},"entrNo":{"type":"string","description":"협력사번호"},"ordQty":{"type":"integer","description":"주문수량","format":"int32"},"salePrc":{"type":"integer","description":"판매가","format":"int64"},"dcAmt":{"type":"integer","description":"할인가","format":"int64"},"sysModDtm":{"type":"string","description":"시스템수정시간","format":"date-time"},"itmNo":{"type":"string","description":"단품번호"},"bsketNo":{"type":"integer","description":"장바구니번호","format":"int64"},"chlNo":{"type":"string","description":"채널번호"},"chlDtlNo":{"type":"string","description":"채널상세번호"},"infDispCtgNoGbCd":{"type":"string","description":"유입전시카테고리번호구분코드(OM041)"},"infDispCtgNo":{"type":"string","description":"유입전시카테고리번호"},"repDispCtgNo":{"type":"string","description":"대표전시카테고리번호"},"conrNo":{"type":"string","description":"코너번호"},"bsketQty":{"type":"integer","description":"장바구니 수량","format":"int32"},"goodsNm":{"type":"string","description":"상품명"},"stdCtgNo":{"type":"string","description":"표준카테고리번호"},"goodsCompCd":{"type":"string","description":"상품구성코드(PR001)"},"goodsTypCd":{"type":"string","description":"상품유형코드(PR002)"},"saleMethCd":{"type":"string","description":"판매방식코드(PR003)"},"brandNo":{"type":"string","description":"브랜드번호"},"brandNm":{"type":"string","description":"브랜드명"},"buyrAgeLmtCd":{"type":"string","description":"구매연령제한코드"},"dispYn":{"type":"string","description":"전시여부"},"saleStatCd":{"type":"string","description":"판매상태코드(PR005)"},"saleStrDtm":{"type":"string","description":"판매시작일시","format":"date-time"},"saleEndDtm":{"type":"string","description":"판매종료일시","format":"date-time"},"buyTypCd":{"type":"string","description":"매입유형코드(PR006)"},"taxGbCd":{"type":"string","description":"과면세구분코드(PR007)"},"stkMgrYn":{"type":"string","description":"재고관리여부"},"buyQtyLmtYn":{"type":"string","description":"구매수량제한여부"},"minLmtQty":{"type":"integer","description":"최소제한수량","format":"int32"},"maxLmtQty":{"type":"integer","description":"최대제한수량","format":"int32"},"safeStkNotiYn":{"type":"string","description":"안전재고알림여부"},"deliGoodsGbCd":{"type":"string","description":"배송상품구분코드(PR010)"},"deliWayCd":{"type":"string","description":"배송수단코드(PR009)"},"deliPsbRgnCd":{"type":"string","description":"배송가능지역코드(PR030)"},"deliDday":{"type":"integer","description":"배송기일","format":"int64"},"bpckPsbYn":{"type":"string","description":"합포장가능여부"},"rtnPsbYn":{"type":"string","description":"반품가능여부"},"exchPsbYn":{"type":"string","description":"교환가능여부"},"supPcost":{"type":"integer","description":"공급원가","format":"int64"},"norPrc":{"type":"integer","description":"정상가","format":"int64"},"preSalePrc":{"type":"integer","description":"종전판매가","format":"int64"},"mrgnRate":{"type":"number","description":"마진율","format":"double"},"payMeanInfo":{"type":"string","description":"결제수단"},"itmNm":{"type":"string","description":"단품명"},"stkQty":{"type":"integer","description":"단품수량","format":"int64"},"prestNm":{"type":"string","description":"증정품명"},"rsvStrtDtm":{"type":"string","description":"예약시작일시","format":"date-time"},"rsvEndDtm":{"type":"string","description":"예약종료일시","format":"date-time"},"fwdidcPrarDy":{"type":"string","description":"출고지시예정일자","format":"date"},"hsCd":{"type":"string","description":"품목분류코드"},"wishYn":{"type":"string","description":"위시리스트 여부"},"maxDcAmt":{"type":"integer","description":"최대혜택금액","format":"int64"},"goodsImg":{"type":"string","description":"상품이미지"},"itmSaleStatCd":{"type":"string","description":"단품판매상태코드(PR005)"},"gvgfPsbYn":{"type":"string","description":"선물하기가능여부"},"rglrDeliGoodsYn":{"type":"string","description":"정기배송상품여부"},"sngGoodsYn":{"type":"string","description":"단일상품여부"},"marketingDisplayNo":{"type":"string","description":"기획전번호"},"entrGoodsNo":{"type":"string","description":"협력사상품번호"},"entrItmNo":{"type":"string","description":"협력사단품번호"},"ordCnclPsbYn":{"type":"string","description":"주문취소가능여부"},"wthdYn":{"type":"string","description":"회수여부"},"frgnDirPurGoodsYn":{"type":"string","description":"해외직구상품여부"}},"description":"장바구니 상품 DTO"},"DlvAmtInfo":{"required":["aplyAdtnAmt","deliPolcNo","dlexAmt","dlexTypCd","entrNo","ordCostGbCd","stdAdtnAmt"],"type":"object","properties":{"ordCostGbCd":{"type":"string","description":"OM043(주문비용구분코드)\n 10: 배송비\n , 20: 회수반품비\n , 30: 교환배송비\n , 40: 추가배송비\n","enum":["DELIVERY_FEE","RETURN_FEE","EXCHANGE_FEE","EXTRA_FEE"]},"dlexTypCd":{"type":"string","description":"배송비유형코드(VD005)","enum":["FREE","CHARGED","CONDITIONAL_FREE"]},"stdAdtnAmt":{"type":"integer","description":"기준부가비용금액","format":"int64"},"dlexAmt":{"type":"integer","description":"배송비금액","format":"int64"},"aplyAdtnAmt":{"type":"integer","description":"적용부가비용금액","format":"int64"},"trdTypCd":{"type":"string","description":"거래유형코드(VD002)"},"entrNo":{"type":"string","description":"협력사번호"},"deliPolcNo":{"type":"string","description":"배송정책번호"},"dlvBenefitInfo":{"$ref":"#/components/schemas/DlvBenefitInfo"}},"description":"배송비정보 DTO"},"DlvBenefitInfo":{"required":["cpnIsuNo","entrChrgRate","ourChrgRate","promoNm","promoNo","promoTypCd"],"type":"object","properties":{"promoNo":{"type":"string","description":"프로모션번호"},"promoNm":{"type":"string","description":"프로모션명"},"promoTypCd":{"type":"string","description":"프로모션 유형 코드(MK002)\n 11 : 상품할인쿠폰\n , 12 : 장바구니쿠폰\n , 13 : 중복할인쿠폰\n , 14 : 무료배송쿠폰\n , 15 : 무료반품쿠폰\n , 20 : 임직원할인\n , 21 : 상품즉시할인\n , 40 : 상품마일리지\n","enum":["11","12","13","14","15","20","21","40"]},"ourChrgRate":{"type":"integer","description":"자사분담률","format":"int32"},"entrChrgRate":{"type":"integer","description":"협력사분담률","format":"int32"},"cpnIsuNo":{"type":"string","description":"쿠폰발급번호"},"ordCostGbCd":{"type":"string","description":"비용구분코드(OM043)"}},"description":"배송혜택정보","nullable":true},"BasketCount":{"type":"object","properties":{"bsketGbCd":{"type":"string"},"count":{"type":"integer","format":"int32"}},"description":"택배 장바구니 수량"},"Response":{"type":"object","properties":{"timestamp":{"type":"string","description":"result time","format":"date-time"},"code":{"type":"string","description":"result code"},"message":{"type":"string","description":"result message"},"isProcess":{"type":"boolean","description":"process check"},"payload":{"type":"object","description":"payload"},"error":{"type":"boolean","description":"is error"},"errors":{"type":"array","description":"validation error list","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string","description":"field"},"message":{"type":"string","description":"field message"}},"description":"validation error list"}}}}
```