1. REST API for Oracle Commerce Cloud 21D
  2. Tasks
  3. Store
  4. Orders
  5. Current
  6. Shipping Groups

Get all shipping groups

get

/ccstore/v1/orders/current/shippingGroups

This API is used by the CX Commerce OSF Storefront. This API is currently not used by CX Commerce Classic Storefront but may be used in the future. It may be used in applications outside of CX Commerce Storefront.

Get all the shipping groups from the cart. This operation will fetch all the shipping groups in the cart.

This endpoint is part of a group of APIs used in conjunction with each other to perform granular actions on the cart (current incomplete order).

The X-CCVisitorId must be used if accessing shipping group(s) before any items have been added to the cart.

Request

Supported Media Types
Query Parameters
  • Specifies the predefined filter key ID that can be used to filter the shipping groups data in the response.'shippingGroupsData' is the currently available filter key for this and the pre configured values to be filtered with can be modified via CCM.
  • Return a list of all the shipping group ids in the response output.
  • Specifies the number of shipping groups to be retrieved starting from offset. In case this is not present, all the shipping groups in the current order is returned.
  • Starting index.
Header Parameters
Back to Top

Response

Supported Media Types

200 Response

The model being returned when the GET operation succeeds. It contains the list of all shipping group items in the current order.
Body ()
Root Schema : getShippingGroups_response
Type: object
List of the shipping groups
Show Source
  • items
    Shipping group information for order. Note the shippng groups will be one type hardgoodShippingGroup and/or instorePickUpShippingGroup.
Example:
{
    "itemIds":{
        "description":"A list of all the shipping group ids in the current order. This payload section will be included in the response only when the getForUpdate query parameter is set to true.",
        "type":"array",
        "items":{
            "type":"string"
        }
    },
    "items":[
        {
            "priceInfo":{
                "amount":179,
                "total":204.06,
                "lkpValExcludingFreeShip":204.06,
                "shipping":6.5,
                "shippingSurchargeValue":0,
                "tax":18.56,
                "subTotal":179,
                "currencyCode":"USD",
                "totalWithoutTax":185.5
            },
            "discountInfo":{
                "orderDiscount":44.67,
                "shippingDiscount":22.99,
                "discountDescList":[
                    {
                    }
                ]
            },
            "shipOnDate":"2019-12-04T10:40:17.794Z",
            "actualShipDate":"2019-12-04T10:40:17.794Z",
            "trackingInfo":[
                {
                    "trackingUrl":"tracking.url",
                    "trackingNumber":"TRN000001"
                }
            ],
            "shippingMethod":{
                "secondaryCurrencyTaxAmount":0,
                "shippingTax":0,
                "cost":0,
                "taxIncluded":true,
                "taxCode":"TAXCODE1",
                "value":"ground",
                "shippingMethodDescription":"Ground"
            },
            "shippingGroupId":"SG0000001",
            "shippingAddress":{
                "firstName":"Wilson",
                "lastName":"Anderson",
                "phoneNumber":"098233456764",
                "address1":"Main Street",
                "postCode":"01887",
                "state":"MA",
                "email":"wilson.anderson@example.com"
            },
            "type":"hardgoodShippingGroup",
            "submittedDate":"2019-12-04T10:40:17.794Z",
            "items":[
                {
                    "availablePickupDate":"string",
                    "primaryThumbImageURL":"/ccstore/v1/images/?source=/file/v7023553219093550939/products/Samsung_F90BN_LARGE.jpg&height=100&width=100",
                    "inventoryLocationId":"location001",
                    "rawTotalPrice":699.99,
                    "dynamicProperties":[
                        {
                            "id":"DYNPROP001",
                            "label":"Dynamic property label",
                            "value":"Dynamic property value"
                        }
                    ],
                    "displayName":"Samsung - F90BN HD Flash Memory Camcorder",
                    "shippingSurchargeValue":0,
                    "availabilityDate":"2019-12-04T10:40:17.794Z",
                    "discountAmount":0,
                    "externalData":[
                        {
                            "values":{
                                "dynamic_property_key":"property_key_1"
                            },
                            "name":"property name",
                            "actionCode":"action_code"
                        }
                    ],
                    "preOrderQuantity":0,
                    "variant":[
                        {
                            "optionValue":"Neon",
                            "optionName":"color"
                        }
                    ],
                    "onSale":true,
                    "primaryImageAltText":"Samsung - F90BN HD Flash Memory Camcorder",
                    "unitPrice":597,
                    "primaryImageTitle":"Samsung - F90BN HD Flash Memory Camcorder",
                    "quantity":1,
                    "pointOfNoRevision":false,
                    "productId":"camcorder_1",
                    "salePrice":597,
                    "detailedItemPriceInfo":{
                        "discounted":true,
                        "amount":597,
                        "quantity":1,
                        "tax":0,
                        "orderDiscountShare":0,
                        "detailedUnitPrice":597,
                        "currencyCode":"USD"
                    },
                    "preferredPickupDate":"2019-12-04T10:40:17.794Z",
                    "active":true,
                    "catRefId":"camcordersku_1_3",
                    "skuProperties":[
                        {
                            "propertyType":"sku-base",
                            "name":"Not Returnable",
                            "id":"nonreturnable",
                            "value":false
                        }
                    ],
                    "route":"/samsung-f90bn-hd-flash-memory-camcorder/product/camcorder_1",
                    "siteId":"siteUS",
                    "backOrderQuantity":0,
                    "listPrice":699.99,
                    "status":"INITIAL"
                }
            ],
            "shippingGroupClassType":"hardgoodShippingGroup"
        }
    ]
}
Nested Schema : items
Type: array
Shipping group information for order. Note the shippng groups will be one type hardgoodShippingGroup and/or instorePickUpShippingGroup.
Show Source
Nested Schema : model_hardgoodShippingGroup
Hardgood shipping group.
Match All
Show Source
Example:
{
    "priceInfo":{
        "amount":179,
        "total":204.06,
        "lkpValExcludingFreeShip":204.06,
        "shipping":6.5,
        "shippingSurchargeValue":0,
        "tax":18.56,
        "subTotal":179,
        "currencyCode":"USD",
        "totalWithoutTax":185.5
    },
    "discountInfo":{
        "orderDiscount":44.67,
        "shippingDiscount":22.99,
        "discountDescList":[
            {
            }
        ]
    },
    "shipOnDate":"2019-12-04T10:40:17.794Z",
    "actualShipDate":"2019-12-04T10:40:17.794Z",
    "trackingInfo":[
        {
            "trackingUrl":"tracking.url",
            "trackingNumber":"TRN000001"
        }
    ],
    "shippingMethod":{
        "value":"ground"
    },
    "shippingGroupId":"SG0000001",
    "shippingAddress":{
        "firstName":"Wilson",
        "lastName":"Anderson",
        "phoneNumber":"098233456764",
        "address1":"Main Street",
        "postCode":"01887",
        "state":"MA",
        "email":"wilson.anderson@example.com"
    },
    "type":"hardgoodShippingGroup",
    "submittedDate":"2019-12-04T10:40:17.794Z",
    "items":[
        {
            "availablePickupDate":"string",
            "primaryThumbImageURL":"/ccstore/v1/images/?source=/file/v7023553219093550939/products/Samsung_F90BN_LARGE.jpg&height=100&width=100",
            "inventoryLocationId":"location001",
            "rawTotalPrice":699.99,
            "dynamicProperties":[
                {
                    "id":"DYNPROP001",
                    "label":"Dynamic property label",
                    "value":"Dynamic property value"
                }
            ],
            "displayName":"Samsung - F90BN HD Flash Memory Camcorder",
            "shippingSurchargeValue":0,
            "availabilityDate":"2019-12-04T10:40:17.794Z",
            "discountAmount":0,
            "externalData":[
                {
                    "values":{
                        "dynamic_property_key":"property_key_1"
                    },
                    "name":"property name",
                    "actionCode":"action_code"
                }
            ],
            "preOrderQuantity":0,
            "variant":[
                {
                    "optionValue":"Neon",
                    "optionName":"color"
                }
            ],
            "onSale":true,
            "primaryImageAltText":"Samsung - F90BN HD Flash Memory Camcorder",
            "unitPrice":597,
            "primaryImageTitle":"Samsung - F90BN HD Flash Memory Camcorder",
            "quantity":1,
            "pointOfNoRevision":false,
            "productId":"camcorder_1",
            "salePrice":597,
            "detailedItemPriceInfo":{
                "discounted":true,
                "amount":597,
                "quantity":1,
                "tax":0,
                "orderDiscountShare":0,
                "detailedUnitPrice":597,
                "currencyCode":"USD"
            },
            "preferredPickupDate":"2019-12-04T10:40:17.794Z",
            "active":true,
            "catRefId":"camcordersku_1_3",
            "skuProperties":[
                {
                    "propertyType":"sku-base",
                    "name":"Not Returnable",
                    "id":"nonreturnable",
                    "value":false
                }
            ],
            "route":"/samsung-f90bn-hd-flash-memory-camcorder/product/camcorder_1",
            "siteId":"siteUS",
            "backOrderQuantity":0,
            "listPrice":699.99,
            "status":"INITIAL"
        }
    ],
    "shippingGroupClassType":"hardgoodShippingGroup"
}
Nested Schema : model_shippingGroup
Type: object
Discriminator: shippingGroupClassType
Base shipping group.
Show Source
Nested Schema : model_hardgoodShippingGroup-allOf[1]
Type: object
Show Source
Nested Schema : shippingAddress
Type: object
Shipping address. Note the shipping address can contain dynamic properties.
Show Source
Nested Schema : trackingInfo
Type: array
Tracking information for shipping group.
Show Source
Nested Schema : items
Type: object
Show Source

400 Response

The error response (which alternates to the default response depending on error reason).
Body ()
Root Schema : errorModelSingleError
Type: object
Show Source

Default Response

The error response.
Body ()
Root Schema : errorModelMultiErrors
Type: object
Show Source
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top