Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

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

 비회원 장바구니 조회
{
    "time": "2021-06-21T05:09:08.002+0000",
    "result": "200",
    "resultMessage": "성공",
    "items": {
        "id": "479167145",
        "customer": "0",  //<---- 비회원
        "totalPriceSummary": {
            "totalSalePrice": 849000,
            "totalDeliveryPrice": 2500,
            "totalDiscountPrice": 0,
            "totalOrderPrice": 851500
        },
        "items": [
            {
                "deliveryBundleGroup": {
                    "id": 104,
                    "name": "묶음 그룹에서 가장 작은 배송비로 부과",
                    "baseGroup": true,
                    "enable": true,
                    "deliveryFeeChargeMethodType": "min",
                    "deliveryAreaType": "area3",
                    "area2extraFee": 2500,
                    "area3extraFee": 5000
                },
                "totalSalePrice": 849000,
                "deliveryPrice": 2500,
                "totalOrderPrice": 851500,
                "cartProducts": [
                    {
                        "id": "361507079",
                        "siteProduct": {
                            "id": "460191482",
                            "name": "윈도우핏 에어컨 (17 ㎡)",
                            "saleStatus": "selling",
                            "images": null
                        },
                        "seller": {
                            "id": "1200000000",
                            "name": "[seller] SAMSUNG"
                        },
                        "price": {
                            "quantity": 1,
                            "salePrice": 849000,
                            "immediateDiscountSalePrice": 849000,
                            "totalSalePrice": 849000,
                            "totalOrderPrice": 849000
                        },
                        "existOption": false
                    }
                ]
            }
        ]
    }
}

장바구니 담기

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
}

  • No labels