Cart

Owned by Hannah
Last updated: Jun 21, 2021
3 min read

Schema

  • cart schema

  • cartProduct schema

 

API

  • 장바구니 조회

  • 장바구니 담기

  • 장바구니 상품 수량 변경

  • 장바구니 옵션 변경

  • 장바구니 상품 삭제

 

Definition

  • 회원 / 비회원 장바구니

  • 장바구니 아이디

    • 장바구니 상품 담기 시 세션에서 장바구니를 조회할 수 없을 때 cartId 생성

  • 비회원 → 회원 로그인 시

    • 비회원 장바구니를 회원 장바구니에 병합

  • 장바구니는 상품 아이디, 상품 옵션, 수량 만 갖음.

    • 장바구니 조회 시 최신 상품 정보를 조회하여 판매 금액, 판매 상태를 계산

  • 장바구니에서 쿠폰 적용 불가

 

장바구니 조회

  • 세션의 장바구니 아이디로 장바구니 조회 SessionHelper.getCartId()

  • 내 장바구니 상품의 판매상태를 확인하여 조회 리스트 필터

  • 합배송 기준에 따라 장바구니 상품 리스트를 그룹화

    배송유형 (일반배송, 정기배송) : deliveryType 셀러 : seller 묶음배송 : deliveryBundleGroup 배송비유형 (무료,유료,수량별, 구간별, 조건부 무료) : deliveryFeeType

  • 장바구니 조회 시 최신 상품 정보를 조회하여 판매 금액, 판매 상태를 계산

 

GET {{protocol}}://{{hostname}}:{{port}}/svc/cart/read?_siteId=samsung

Response:

{ "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 } } ] } ] } }

 

 

장바구니 담기

  • 세션에서 장바구니를 조회할 수 없을 때 cartId 생성 후 장바구니 담기

  • 동일 상품을 장바구니담기 할 때 수량 증가

 

POST {{protocol}}://{{hostname}}:{{port}}/svc/cart/addProducts

Parameters:

  • products : 장바구니에 담을 상품 정보

    • 상품 옵션 타입 : none

      [ { "id": 460191482, "quantity": 1 } ]

    • 상품 옵션 타입 : single

    • 상품 옵션 타입 : mix

Response:

 

 

장바구니 상품 수량 변경

PUT {{protocol}}://{{hostname}}:{{port}}/svc/cartProduct/changeQuantity

Parameters:

  • id : 장바구니 상품 ID

  • quantity : 변경할 상품 수량

Response:

 

 

장바구니 옵션 변경

Parameters:

  • id : 장바구니 상품 ID

  • productOption : 변경할 상품 옵션 ID

Response:

 

장바구니 상품 삭제

Parameters:

  • ids : 장바구니 상품 ID

Response: