장바구니

장바구니 옵션변경

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

200

성공

*/*

장바구니 등록 응답 DTO

bsketNointeger · int64Optional

장바구니번호

Example: 100000001

900

업무처리 오류 내용

*/*

put

/v1/basket/optionChange

PUT /api/order/v1/basket/optionChange HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 224

{
  "bsketNo": 100000001,
  "bsketInfGbCd": "10",
  "bsketGbCd": "10",
  "chlNo": "1",
  "chlDtlNo": "1",
  "infDispCtgNoGbCd": "10",
  "infDispCtgNo": "1",
  "repDispCtgNo": "1",
  "conrNo": "1",
  "goodsNo": "100000001",
  "itmNo": "001",
  "bsketQty": 1,
  "ordGbCd": "10"
}

{
  "bsketNo": 100000001
}

장바구니 삭제

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

200

성공

No content

900

업무처리 오류 내용

*/*

put

/v1/basket/deleteBasket

PUT /api/order/v1/basket/deleteBasket HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "bsketGbCd": "10",
  "goodsNo": "10212309",
  "itmNo": "001",
  "bsketNoList": [
    1
  ]
}

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

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/basket/validateBasket

POST /api/order/v1/basket/validateBasket HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "ordGbCd": "10",
  "bsketGbCd": "10",
  "bsketNoList": [
    1
  ]
}

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

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

200

성공

*/*

장바구니 등록 응답 DTO

bsketNointeger · int64Optional

장바구니번호

Example: 100000001

900

업무처리 오류 내용

*/*

post

/v1/basket/registerBasket

POST /api/order/v1/basket/registerBasket HTTP/1.1
Host: localhost:8092/
Content-Type: application/json
Accept: */*
Content-Length: 224

{
  "bsketNo": 100000001,
  "bsketInfGbCd": "10",
  "bsketGbCd": "10",
  "chlNo": "1",
  "chlDtlNo": "1",
  "infDispCtgNoGbCd": "10",
  "infDispCtgNo": "1",
  "repDispCtgNo": "1",
  "conrNo": "1",
  "goodsNo": "100000001",
  "itmNo": "001",
  "bsketQty": 1,
  "ordGbCd": "10"
}

{
  "bsketNo": 100000001
}

장바구니 병합

post

기능설명

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

상세설명

쿠키에 저장된 세션번호로 비회원 장바구니 상품 조회
장바구니유입구분코드(OM042)가 바로구매인 데이터들은 로그인한 회원번호로 업데이트
장바구니유입구분코드(OM042)가 장바구니 담기, 위시리스트인 데이터들은 기존 데이터 삭제 후 로그인 한 회원 데이터로 새로 생성

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

No content

900

업무처리 오류 내용

*/*

post

/v1/basket/combineBasket

POST /api/order/v1/basket/combineBasket HTTP/1.1
Host: localhost:8092/
Accept: */*

No content

장바구니 총 수량 조회

get

기능설명

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

상세설명

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

수정번호

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

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

integer · int32Optional

900

업무처리 오류 내용

*/*

get

/v1/basket/totBsketCnt

GET /api/order/v1/basket/totBsketCnt HTTP/1.1
Host: localhost:8092/
Accept: */*

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

get

기능설명

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

상세설명

비회원은 장바구니가 구분되어 있지 않아 해당하지 않으며 회원의 경우는 회원번호로 조회
주문완료여부가 'N', 장바구니유입구분코드(OM042)가 [장바구니 담기, 위시리스트]인 장바구니 데이터

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

stringOptional

900

업무처리 오류 내용

*/*

get

/v1/basket/getRecentBasketType

GET /api/order/v1/basket/getRecentBasketType HTTP/1.1
Host: localhost:8092/
Accept: */*

text

장바구니 조회

get

기능설명

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

상세설명

회원은 회원번호로 조회
비회원은 쿠키에 저장되어 있는 세션번호로 조회
주문완료여부가 'N', 장바구니유입구분코드(OM042)가 [장바구니 담기, 위시리스트]인 장바구니 데이터
배송그룹으로 묶여서 조회
상품은 1. 배송처리방법이 센터배송 2. 장바구니 담은 최신 순으로 정렬 우선 순위를 갖고 우선 순위가 높은 상품이 포함된 배송그룹 순으로 정렬
같은 배송정책번호의 상품 중 선택 여부에 따라 조건부무료 배송비 계산하기 위해 배송비금액(dlexAmt) 가공하지 않는다

수정번호

Release v2.00_240425: 장바구니 조회 조건 사이트 번호 추가
Release v2.00_241025: 조건부무료 상품의 조건충족에 따른 배송비 계산하지 않도록 수정

Query parameters

Header parameters

AuthorizationanyOptional

Access Token

Responses

200

성공

*/*

장바구니 조회 응답 DTO

900

업무처리 오류 내용

*/*

get

/v1/basket/getBasket

GET /api/order/v1/basket/getBasket?request=[object+Object] HTTP/1.1
Host: localhost:8092/
Accept: */*

{
  "groupList": [
    {
      "dlvpSeq": "1",
      "deliNo": "1",
      "deliKindCd": "10",
      "deliProcTypCd": "10",
      "deliMethodCd": "10",
      "basketGoodsList": [
        {
          "goodsNo": "100000001",
          "deliProcTypCd": "10",
          "deliPolcNo": "1",
          "deliNo": "100000021",
          "entrNo": "1000001",
          "ordQty": 1,
          "salePrc": 15000,
          "dcAmt": 3000,
          "sysModDtm": "2026-02-27T19:43:29.360Z",
          "itmNo": "001",
          "bsketNo": 100000001,
          "chlNo": "1",
          "chlDtlNo": "1",
          "infDispCtgNoGbCd": "01",
          "infDispCtgNo": "1",
          "repDispCtgNo": "1",
          "conrNo": "1",
          "bsketQty": 1,
          "goodsNm": "상품명",
          "stdCtgNo": "1",
          "goodsCompCd": "10",
          "goodsTypCd": "10",
          "saleMethCd": "10",
          "brandNo": "1",
          "brandNm": "브랜드명",
          "buyrAgeLmtCd": "0",
          "dispYn": "Y",
          "saleStatCd": "10",
          "saleStrDtm": "2026-02-27T19:43:29.360Z",
          "saleEndDtm": "2026-02-27T19:43:29.360Z",
          "buyTypCd": "10",
          "taxGbCd": "10",
          "stkMgrYn": "Y",
          "buyQtyLmtYn": "Y",
          "minLmtQty": 1,
          "maxLmtQty": 10,
          "safeStkNotiYn": "Y",
          "deliGoodsGbCd": "01",
          "deliWayCd": "01",
          "deliPsbRgnCd": "01",
          "deliDday": 1,
          "bpckPsbYn": "Y",
          "rtnPsbYn": "Y",
          "exchPsbYn": "Y",
          "supPcost": 10000,
          "norPrc": 20000,
          "preSalePrc": 20000,
          "mrgnRate": 4,
          "payMeanInfo": "11,12,32",
          "itmNm": "아이템명1>아이템명2>아이템명3",
          "stkQty": 999,
          "prestNm": "증정품명",
          "rsvStrtDtm": "2026-02-27T19:43:29.360Z",
          "rsvEndDtm": "2026-02-27T19:43:29.360Z",
          "fwdidcPrarDy": "2026-02-27",
          "hsCd": "1",
          "wishYn": "Y",
          "maxDcAmt": 1000,
          "goodsImg": "files/goods/2023/07/04/img",
          "itmSaleStatCd": "10",
          "gvgfPsbYn": "Y",
          "rglrDeliGoodsYn": "Y",
          "sngGoodsYn": "Y",
          "marketingDisplayNo": "1",
          "entrGoodsNo": "100042110583831",
          "entrItmNo": "100042110583831001",
          "ordCnclPsbYn": "N",
          "wthdYn": "N",
          "frgnDirPurGoodsYn": "text"
        }
      ],
      "dlvAmtInfoList": [
        {
          "ordCostGbCd": "10",
          "dlexTypCd": "10",
          "stdAdtnAmt": 20000,
          "dlexAmt": 3500,
          "aplyAdtnAmt": 20000,
          "trdTypCd": "text",
          "entrNo": "1000211",
          "deliPolcNo": "10000431",
          "dlvBenefitInfo": {
            "promoNo": "C1000000",
            "promoNm": "프로모션 명",
            "promoTypCd": "11",
            "ourChrgRate": 100,
            "entrChrgRate": 0,
            "cpnIsuNo": "100000",
            "ordCostGbCd": "10"
          }
        }
      ]
    }
  ],
  "countList": [
    {
      "bsketGbCd": "text",
      "count": 1
    }
  ]
}

Previous공지사항 FAQ Next자동결제카드관리

Last updated 1 day ago

hashtag장바구니 옵션변경

hashtag기능설명

hashtag상세설명

hashtag수정 번호

hashtag장바구니 삭제

hashtag기능설명

hashtag상세설명

hashtag수정 번호

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

hashtag기능설명

hashtag상세설명

hashtag수정번호

hashtag장바구니 등록

hashtag기능설명

hashtag상세설명

hashtag특이사항

hashtag수정 번호

hashtag장바구니 병합

hashtag기능설명

hashtag상세설명

hashtag장바구니 총 수량 조회

hashtag기능설명

hashtag상세설명

hashtag수정번호

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

hashtag기능설명

hashtag상세설명

hashtag장바구니 조회

hashtag기능설명

hashtag상세설명

hashtag수정번호

장바구니 옵션변경

기능설명

상세설명

수정 번호

장바구니 삭제

기능설명

상세설명

수정 번호

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

기능설명

상세설명

수정번호

장바구니 등록

기능설명

상세설명

특이사항

수정 번호

장바구니 병합

기능설명

상세설명

장바구니 총 수량 조회

기능설명

상세설명

수정번호

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

기능설명

상세설명

장바구니 조회

기능설명

상세설명

수정번호