장바구니

장바구니 옵션변경

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: api-order.x2bee.com/
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: api-order.x2bee.com/
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: api-order.x2bee.com/
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: api-order.x2bee.com/
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: api-order.x2bee.com/
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: api-order.x2bee.com/
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: api-order.x2bee.com/
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: api-order.x2bee.com/
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-01-01T00:00:00.000Z",
          "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-01-01T00:00:00.000Z",
          "saleEndDtm": "2026-01-01T00:00:00.000Z",
          "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-01-01T00:00:00.000Z",
          "rsvEndDtm": "2026-01-01T00:00:00.000Z",
          "fwdidcPrarDy": "2026-01-01",
          "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
    }
  ]
}

이전공지사항 FAQ

다음자동결제카드관리

마지막 업데이트 4개월 전