Schema
cart schema
cartProduct schema
API
장바구니 조회
장바구니 담기
장바구니 상품 수량 변경
장바구니 옵션 변경
장바구니 상품 삭제
Definition
회원 / 비회원 장바구니
장바구니 아이디
장바구니 상품 담기 시 세션에서 장바구니를 조회할 수 없을 때
cartId생성
비회원 → 회원 로그인 시
비회원 장바구니를 회원 장바구니에 병합
장바구니는 상품 아이디, 상품 옵션, 수량 만 갖음.
장바구니 조회 시 최신 상품 정보를 조회하여 판매 금액, 판매 상태를 계산
장바구니에서 쿠폰 적용 불가
장바구니 조회
GET {{protocol}}://{{hostname}}:{{port}}/svc/cart/read?_siteId=samsung
세션의 장바구니 아이디로 장바구니 조회
SessionHelper.getCartId()내 장바구니 상품의 판매상태를 확인하여 조회 리스트 필터
합배송 기준에 따라 장바구니 상품 리스트를 그룹화
배송유형 (일반배송, 정기배송) : deliveryType 셀러 : seller 묶음배송 : deliveryBundleGroup 배송비유형 (무료,유료,수량별, 구간별, 조건부 무료) : deliveryFeeType
장바구니 조회 시 최신 상품 정보를 조회하여 판매 금액, 판매 상태를 계산
{
"time": "2021-06-21T04:19:11.146+0000",
"result": "200",
"resultMessage": "성공",
"items": {
"id": "914746866",
"customer": "233174265", //<---- 회원
"totalPriceSummary": {
"totalSalePrice": 6732000, //<- 총 판매금액
"totalDeliveryPrice": 0, //<- 총 배송금액
"totalDiscountPrice": 0, //<- 총 할인금액
"totalOrderPrice": 6732000 //<- 총 주문금액 = 총 할인판매금액 + 총 배송금액
},
"items": [
{
"deliveryBundleGroup": {
"id": 104,
"name": "묶음 그룹에서 가장 작은 배송비로 부과",
"baseGroup": true,
"enable": true,
"deliveryFeeChargeMethodType": "min",
"deliveryAreaType": "area3",
"area2extraFee": 2500,
"area3extraFee": 5000
},
"totalSalePrice": 6732000,
"deliveryPrice": 0,
"totalOrderPrice": 6732000,
"cartProducts": [
{
"id": "1685946069",
"siteProduct": {
"id": "460191482",
"name": "윈도우핏 에어컨 (17 ㎡)",
"saleStatus": "selling", //<---- 판매상태 : stop, selling, outOfStock
"images": null
},
"seller": {
"id": "1200000000",
"name": "[seller] SAMSUNG"
},
"price": {
"quantity": 2, //<- 장바구니 상품 수량
"salePrice": 849000, //<- 장바구니 상품 1개 판매 금액
"immediateDiscountSalePrice": 849000, //<- 장바구니 상품 1개 즉시할인 판매 금액
"totalSalePrice": 1698000, //<- 장바구니 상품 총 판매 금액
"totalOrderPrice": 1698000 //<- 장바구니 상품 총 주문 금액 (총즉시할인판매가에 쿠폰, 프로모션 적용가)
},
"existOption": false
},
{
"id": "411784177",
"siteProduct": {
"id": "1246838400",
"name": "무풍에어컨 갤러리 (56.9 ㎡ + 18.7 ㎡)",
"saleStatus": "selling",
"images": null
},
"seller": {
"id": "1200000000",
"name": "[seller] SAMSUNG"
},
"price": {
"quantity": 1,
"salePrice": 2449000,
"immediateDiscountSalePrice": 2449000,
"totalSalePrice": 2549000,
"totalOrderPrice": 2549000
},
"existOption": true,
"option": {
"id": "919202711",
"name": "화이트",
"optionPrice": 100000
}
},
{
"id": "1547472788",
"siteProduct": {
"id": "136475014",
"name": "BESPOKE 무풍에어컨 클래식 (56.9 ㎡)",
"saleStatus": "selling",
"images": null
},
"seller": {
"id": "1200000000",
"name": "[seller] SAMSUNG"
},
"price": {
"quantity": 1,
"salePrice": 2435000,
"immediateDiscountSalePrice": 2435000,
"totalSalePrice": 2485000,
"totalOrderPrice": 2485000
},
"existOption": true,
"option": {
"id": "919109916",
"name": "White 매립배관",
"optionPrice": 50000
}
}
]
}
]
}
}
장바구니 담기
POST {{protocol}}://{{hostname}}:{{port}}/svc/cart/addProducts
세션에서 장바구니를 조회할 수 없을 때
cartId생성 후 장바구니 담기동일 상품을 장바구니담기 할 때 수량 증가
Parameters:
products : 장바구니에 담을 상품 정보
상품 옵션 타입 : none
[ { "id": 460191482, "quantity": 1 } ]상품 옵션 타입 : single
[ { "id": 1246838400, "productOption": { "id": 919202711, "quantity": 1 } }]상품 옵션 타입 : mix
[ { "id": 136475014, "productOption": { "id": 919109915, "quantity": 1 } }, { "id": 136475014, "productOption": { "id": 919109916, "quantity": 1 } } ]
{
"time": "2021-06-21T04:48:07.898+0000",
"result": "200",
"resultMessage": "장바구니에 상품이 추가 되었습니다.",
"cart": "620772537"
}
장바구니 상품 수량 변경
PUT {{protocol}}://{{hostname}}:{{port}}/svc/cartProduct/changeQuantity
Parameters:
id : 장바구니 상품 ID
quantity : 변경할 상품 수량
{
"time": "2021-06-21T04:48:24.864+0000",
"result": "200",
"resultMessage": "성공"
}
장바구니 옵션 변경
PUT {{protocol}}://{{hostname}}:{{port}}/svc/cartProduct/changeOption
Parameters:
id : 장바구니 상품 ID
productOption : 변경할 상품 옵션 ID
{
"time": "2021-06-21T04:48:53.088+0000",
"result": "200",
"resultMessage": "성공"
}
장바구니 상품 삭제
DELETE {{protocol}}://{{hostname}}:{{port}}/svc/cartProduct/remove
Parameters:
ids : 장바구니 상품 ID
{
"time": "2021-06-21T04:49:25.144+0000",
"result": "200",
"resultMessage": "SUCCESS",
"executeCount": 1
}