장바구니

장바구니 옵션변경

put

기능설명

  • 선택한 상품의 옵션을 변경합니다.


상세설명

  • 파라미터로 넘어온 장바구니 번호에 해당하는 데이터를 변경

  • 단품번호, 수량을 업데이트

  • 이미 담겨있는 단품으로 변경하면 이미 담겨있는 단품은 삭제하고 그 수량을 더해 업데이트

  • 호출 시, 검증이 수행 되는데 실패 시 변경 불가

  • 상품 판매 상태, 구매 가능 수량, 장바구니 최대 담기 개수 초과 확인


수정 번호

  • Release v2.00_240711: 정기주문, 선물하기 사용 설정을 체크

Header parameters
AuthorizationanyOptional

Access Token

Body

장바구니 등록 요청 DTO

bsketNointeger · int64Required

장바구니번호

Example: 100000001
bsketInfGbCdstring · enumRequired

OM042(장바구니 유입 구분 코드) 10: BASKET_BUY(장바구니구매) ,20: NOW_BUY(바로구매) ,30: WISH_BUY(위시리스트구매)

Example: 10Possible values:
bsketGbCdstring · enumRequired

OM001(장바구니 구분 코드) 10: HDEL(택배) 20: STORE_PICK_UP(매장수령) 30: QUICK_DELIVERY(퀵배송) 40: REGULAR_DELIVERY(정기주문)

Example: 10Possible values:
chlNostringRequired

채널번호

Example: 1
chlDtlNostringRequired

채널상세번호

Example: 1
infDispCtgNoGbCdstring · enumRequired

OM041(유입전시카테고리번호구분코드) 01: DISPLAY_STORE(전시매장) ,02: EXHIBITIONS(기획전) ,06: SEARCH_SALES(검색매출) ,07: SEARCH_AD_BANNER(검색광고배너) ,08: FLOATING_BANNER(플로팅배너) ,09: WISHLIST(위시리스트) ,10: NONE(유입전시번호없음)

Example: 10Possible values:
infDispCtgNostringRequired

유입전시카테고리번호

Example: 1
repDispCtgNostringRequired

대표전시카테고리번호

Example: 1
conrNostringOptional

코너번호

Example: 1
goodsNostringRequired

상품번호

Example: 100000001
itmNostringRequired

단품번호

Example: 001
bsketQtyinteger · int32 · min: 1Optional

장바구니 수량

Example: 1
ordGbCdstring · enumRequired

OM002(주문 구분 코드) 10: 일반주문 , 20: 선물하기 , 30: e-쿠폰 , 40: 제휴

Example: 10Possible values:
Responses
chevron-right
200

성공

*/*

장바구니 등록 응답 DTO

bsketNointeger · int64Optional

장바구니번호

Example: 100000001
put
/v1/basket/optionChange

장바구니 삭제

put

기능설명

  • 선택한 상품들을 장바구니에서 삭제합니다.


상세설명

  • 파라미터로 넘어온 장바구니 번호에 해당하는 데이터를 삭제

  • 주문완료여부를 'Y'로 업데이트


수정 번호

  • Release v2.00_240711: 정기주문, 선물하기 사용 설정을 체크

Header parameters
AuthorizationanyOptional

Access Token

Body

장바구니 조건 DTO

bsketGbCdstring · enumOptional

OM001(장바구니 구분 코드) 10: HDEL(택배) 20: STORE_PICK_UP(매장수령) 30: QUICK_DELIVERY(퀵배송) 40: REGULAR_DELIVERY(정기주문)

Example: 10Possible values:
goodsNostringOptional

상품번호

Example: 10212309
itmNostringOptional

단품번호

Example: 001
bsketNoListinteger · int64[]Required

장바구니번호리스트

Responses
chevron-right
200

성공

No content

put
/v1/basket/deleteBasket

No content

장바구니 상품 주문가능여부 체크

post

기능설명

  • 장바구니에서 바로구매 클릭 시, 주문서로 넘기기 전 선택한 장바구니 상품 데이터가 주문가능한지 검사합니다.


상세설명

  • 검증 실패 시, 주문서로 넘어가지 않고 장바구니에서 에러 메시지 노출

    • 상품: 상품 판매 상태, 구매 가능 수량, 재고, 예약상품 예약가능 일시, 비회원 성인상품 구매 불가, 성인상품 인증 여부

    • 주문자: 구매제한회원 확인, 연령 확인


수정번호

  • Release v2.00_240401 : 정기배송신청서 진입 시의 자동결제카드 체크 제거

  • Release v2.00_240711: 정기주문, 선물하기 사용 설정을 체크

  • Release v2.00_240729: 티켓 상품에 대한 유효성 검증 추가

Header parameters
AuthorizationanyOptional

Access Token

Body
ordGbCdstring · enumRequired

OM002(주문 구분 코드) 10: 일반주문 , 20: 선물하기 , 30: e-쿠폰 , 40: 제휴

Example: 10Possible values:
bsketGbCdstring · enumRequired

OM001(장바구니 구분 코드) 10: HDEL(택배) 20: STORE_PICK_UP(매장수령) 30: QUICK_DELIVERY(퀵배송) 40: REGULAR_DELIVERY(정기주문)

Example: 10Possible values:
bsketNoListinteger · int64[]Required

장바구니번호리스트

Responses
chevron-right
200

성공

No content

post
/v1/basket/validateBasket

No content

장바구니 등록

post

기능설명

  • 선택한 상품을 장바구니에 등록합니다.


상세설명

  • 비회원은 최초 등록 시, 세션번호를 생성하여 쿠키에 저장

  • 바로구매, 장바구니 담기 수행 시, 호출

  • 호출 시, 검증이 수행 되는데 실패 시 등록 불가

    • 공통: 상품 판매 상태, 구매 가능 수량

    • 바로구매: 상품 재고, 예약 상품 예약 가능 일시, 비회원 성인 상품 구매 불가, 성인 상품 인증 여부, 배송비 정책 존재 여부, 주문자 구매제한회원 여부/연령

    • 장바구니 담기: 배송비 정책 존재 여부, 장바구니 최대 담기 개수 초과 확인


특이사항

  • 바로구매거나 장바구니 담기 케이스에서 새로운 상품이 INSERT되었을 때, INSERT된 ROW의 장바구니 번호(BSKET_NO) 리턴(기존 상품 수량 UPDATE일 때는 NULL 리턴)

  • 장바구니에 담을 수 있는 최대 수량은 공통코드 ST002, 코드"10"의 참조1값입니다.

  • 등록된 장바구니의 보관기간은 공통코드 ST003, 코드"10"의 참조1값입니다. 보관기간이 지나면 배치로 삭제됩니다.


수정 번호

  • Release v2.00_240711: 정기주문, 선물하기 사용 설정을 체크

  • Release v2.00_240729: 티켓 상품에 대한 유효성 검증 추가

Header parameters
AuthorizationanyOptional

Access Token

Body

장바구니 등록 요청 DTO

bsketNointeger · int64Required

장바구니번호

Example: 100000001
bsketInfGbCdstring · enumRequired

OM042(장바구니 유입 구분 코드) 10: BASKET_BUY(장바구니구매) ,20: NOW_BUY(바로구매) ,30: WISH_BUY(위시리스트구매)

Example: 10Possible values:
bsketGbCdstring · enumRequired

OM001(장바구니 구분 코드) 10: HDEL(택배) 20: STORE_PICK_UP(매장수령) 30: QUICK_DELIVERY(퀵배송) 40: REGULAR_DELIVERY(정기주문)

Example: 10Possible values:
chlNostringRequired

채널번호

Example: 1
chlDtlNostringRequired

채널상세번호

Example: 1
infDispCtgNoGbCdstring · enumRequired

OM041(유입전시카테고리번호구분코드) 01: DISPLAY_STORE(전시매장) ,02: EXHIBITIONS(기획전) ,06: SEARCH_SALES(검색매출) ,07: SEARCH_AD_BANNER(검색광고배너) ,08: FLOATING_BANNER(플로팅배너) ,09: WISHLIST(위시리스트) ,10: NONE(유입전시번호없음)

Example: 10Possible values:
infDispCtgNostringRequired

유입전시카테고리번호

Example: 1
repDispCtgNostringRequired

대표전시카테고리번호

Example: 1
conrNostringOptional

코너번호

Example: 1
goodsNostringRequired

상품번호

Example: 100000001
itmNostringRequired

단품번호

Example: 001
bsketQtyinteger · int32 · min: 1Optional

장바구니 수량

Example: 1
ordGbCdstring · enumRequired

OM002(주문 구분 코드) 10: 일반주문 , 20: 선물하기 , 30: e-쿠폰 , 40: 제휴

Example: 10Possible values:
Responses
chevron-right
200

성공

*/*

장바구니 등록 응답 DTO

bsketNointeger · int64Optional

장바구니번호

Example: 100000001
post
/v1/basket/registerBasket

장바구니 병합

post

기능설명

  • 로그인 시에, 비회원일 때 담았던 장바구니 상품들을 로그인한 회원 장바구니로 합칩니다.


상세설명

  • 쿠키에 저장된 세션번호로 비회원 장바구니 상품 조회

  • 장바구니유입구분코드(OM042)가 바로구매인 데이터들은 로그인한 회원번호로 업데이트

  • 장바구니유입구분코드(OM042)가 장바구니 담기, 위시리스트인 데이터들은 기존 데이터 삭제 후 로그인 한 회원 데이터로 새로 생성

Header parameters
AuthorizationanyOptional

Access Token

Responses
chevron-right
200

성공

No content

post
/v1/basket/combineBasket

No content

장바구니 총 수량 조회

get

기능설명

  • 비회원 혹은 현재 로그인 한 회원의 장바구니 총 수량을 조회합니다.


상세설명

  • 회원은 회원번호로 조회

  • 비회원은 쿠키에 저장되어 있는 세션번호로 조회


수정번호

  • Release v2.00_240425: 장바구니 총 수량 조회 조건에 사이트 번호 추가

Header parameters
AuthorizationanyOptional

Access Token

Responses
chevron-right
200

성공

*/*
integer · int32Optional
get
/v1/basket/totBsketCnt

가장 최근에 담은 장바구니 구분(OM001) 조회

get

기능설명

  • 가장 최근에 담은 장바구니 구분(OM001)을 조회합니다.


상세설명

  • 비회원은 장바구니가 구분되어 있지 않아 해당하지 않으며 회원의 경우는 회원번호로 조회

  • 주문완료여부가 'N', 장바구니유입구분코드(OM042)가 [장바구니 담기, 위시리스트]인 장바구니 데이터

Header parameters
AuthorizationanyOptional

Access Token

Responses
chevron-right
200

성공

*/*
stringOptional
get
/v1/basket/getRecentBasketType

장바구니 조회

get

기능설명

  • 장바구니에 담겨있는 상품을 조회합니다.


상세설명

  • 회원은 회원번호로 조회

  • 비회원은 쿠키에 저장되어 있는 세션번호로 조회

  • 주문완료여부가 'N', 장바구니유입구분코드(OM042)가 [장바구니 담기, 위시리스트]인 장바구니 데이터

  • 배송그룹으로 묶여서 조회

  • 상품은 1. 배송처리방법이 센터배송 2. 장바구니 담은 최신 순으로 정렬 우선 순위를 갖고 우선 순위가 높은 상품이 포함된 배송그룹 순으로 정렬

  • 같은 배송정책번호의 상품 중 선택 여부에 따라 조건부무료 배송비 계산하기 위해 배송비금액(dlexAmt) 가공하지 않는다


수정번호

  • Release v2.00_240425: 장바구니 조회 조건 사이트 번호 추가

  • Release v2.00_241025: 조건부무료 상품의 조건충족에 따른 배송비 계산하지 않도록 수정

Query parameters
Header parameters
AuthorizationanyOptional

Access Token

Responses
chevron-right
200

성공

*/*

장바구니 조회 응답 DTO

get
/v1/basket/getBasket

Last updated