Update shipping groups
/ccstore/v1/orders/current/shippingGroups
Update/Add/Remove one or more shipping groups.
When patching multiple shipping groups usage of the ID property defines the following actions:
Create - no ID property is specified but other properties are
Update - ID and other properties are specified
Delete - no ID property specified for an existing collection entry
Retain - the ID property only (An alternative is use 'update' with ID and properties unchanged)
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).
Request
- application/json
-
filterKey(optional): string
Specifies the predefined filter key ID that can be used to filter the embedded order data in the response.'embeddedOrderData' is the currently available filter key for this and the pre configured values to be filtered with can be modified via CCM.
-
X-CCOrganization(optional): string
Current organization context of the logged in user
-
X-CCVisitorId(optional): string
ID provided by the Oracle Commerce Visit Service to uniquely identify the current visitor. It is required for every request to enable full endpoint capabilities for all shopper types.
object
{
"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":{
"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",
"backOrderQuantity":0,
"listPrice":699.99,
"status":"INITIAL"
}
],
"shippingGroupClassType":"hardgoodShippingGroup"
}
]
}
array
-
Array of:
model_hardgoodShippingGroup
Hardgood shipping group.
-
object
model_shippingGroup
Discriminator:
shippingGroupClassType
Base shipping group. -
object
model_hardgoodShippingGroup-allOf[1]
{
"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"
}
object
shippingGroupClassType
-
actualShipDate(optional):
string(datetime)
Actual date items where shipped.Example:
2019-12-04T10:40:17.794Z
-
discountInfo(optional):
object discountInfo
Shipping group discount information.
-
items(optional):
array items
List of items related to the shipping group.
-
priceInfo(optional):
object priceInfo
Price information of the shipping group.
-
shipOnDate(optional):
string(datetime)
Date items are to be shipped.Example:
2019-12-04T10:40:17.794Z
-
shippingGroupClassType:
string
Example:
hardgoodShippingGroup
-
shippingGroupId(optional):
string
Shipping group ID.Example:
SG0000001
-
shippingMethod(optional):
object model_shippingMethod
The shipping method details for the shipping group.
-
submittedDate(optional):
string(datetime)
Shipping group submitted date.Example:
2019-12-04T10:40:17.794Z
-
type(optional):
string
The shipping group type.Example:
hardgoodShippingGroup
object
-
shippingAddress(optional):
object shippingAddress
Shipping address. Note the shipping address can contain dynamic properties.
-
trackingInfo(optional):
array trackingInfo
Tracking information for shipping group.
object
-
address1(optional):
string
The address line one (required POST).Example:
Main Street
-
country(optional):
The address country.
-
email(optional):
string
The contact email address.Example:
wilson.anderson@example.com
-
firstName(optional):
string
The contact's first name (required POST).Example:
Wilson
-
lastName(optional):
string
The contact's last name (required POST).Example:
Anderson
-
phoneNumber(optional):
string
Pattern:
[0-9()+ -]+$
The contact phone number (optional POST|PATCH).Example:098233456764
-
postCode(optional):
string
The addess postcode (required POST, optional PATCH).Example:
01887
-
state(optional):
string
The address state (required POST, optional PATCH).Example:
MA
object
-
trackingNumber(optional):
string
Tracking numberExample:
TRN000001
-
trackingUrl(optional):
string
Tracking URL for shipping group.Example:
tracking.url
Response
- application/json
200 Response
A successful operation will produce an array of shipping groups, these shipping groups can be a combination of type hardgoodShippingGroup and instorePickUpShippingGroup.
See below for property definition/example for each shipping group type.
Hardgood Shipping Group
{
"description": "Hardgood shipping group description.",
"type": "object",
"properties": {
"shippingAddress": {
"description": "Shipping address.",
"type": "object",
"properties": {
"firstName": {
"description": "First name.",
"type": "string",
"example": "Wilson"
},
"lastName": {
"description": "Last name.",
"type": "string",
"example": "Anderson"
},
"id": {
"description": "Shipping group ID.",
"example": "SG0000001",
"type": "string"
},
"shipOnDate": {
"description": "Date items where shipped.",
"type": "string",
"format": "date",
"example": "22/02/2018"
},
"shippingMethod": {
"type": "string"
}
}
}
}
}
Electronic Shipping Group
{
"description": "Electronic shipping group.",
"type": "object",
"properties": {
"emailAddress": {
"description": "Email address.",
"type": "string",
"example": "wilson.anderson@oracle.com"
},
"id": {
"description": "Shipping group ID.",
"example": "SG0000001",
"type": "string"
},
"shipOnDate": {
"description": "Date items where shipped.",
"type": "string",
"format": "date",
"example": "22/02/2018"
},
"shippingMethod": {
"type": "string"
},
}
}
-
object
model_collectionPagination
Pagination details.
-
object
shippingGroupsCollectionWithEmbeddedOrder_response-allOf[1]
{
"totalResults":"4",
"offset":"0",
"hasMore":"false",
"limit":"250",
"links":[
{
"method":"GET",
"rel":"last",
"href":"http://localhost:8080/ccstoreui/v1/orders/currents"
}
],
"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"
}
],
"embedded":{
"order":{
"shippingGroups":{
"priceInfo":{
"amount":179,
"total":204.06,
"shipping":6.5,
"primaryCurrencyTotal":204.06,
"shippingSurchargeValue":0,
"tax":18.56,
"subTotal":179,
"currencyCode":"USD",
"totalWithoutTax":185.5
},
"discountInfo":{
"orderDiscount":0,
"shippingDiscount":0,
"discountDescList":[
{
"promotionName":"Free Tattoo",
"external":false,
"promotionLevel":"item",
"coupon":"FREETATTOO",
"promotionDesc":"Explicit Item Discount - FREETATTOO",
"promotionId":"explicitItemFreeDiscount"
}
],
"orderImplicitDiscountList":[
{
"external":false,
"promotionLevel":"item",
"promotionDesc":"Implicit Item Discount - 3PercentOff",
"promotionId":"implicitItemPercentDiscount"
}
]
},
"shippingMethod":{
"shippingTax":0.46,
"cost":6.5,
"taxIncluded":true,
"taxCode":"PC00300",
"value":"ground",
"shippingMethodDescription":"Ground"
},
"shippingGroupId":"sg10032",
"shippingAddress":{
"lastName":"Smith",
"country":"US",
"address3":"Florida",
"address2":"Florida",
"city":"Orlando",
"prefix":"Mr",
"address1":"76 Palm Drive",
"postalCode":32002,
"jobTitle":"Doctor",
"companyName":"Doctor's Place",
"county":"Florida",
"suffix":"John Smith",
"selectedCountry":"US",
"firstName":"John",
"phoneNumber":"09345456345",
"alias":"Address03#",
"faxNumber":330193316,
"middleName":"Joe",
"state":"FL",
"email":"john@email.com"
},
"type":"hardgoodShippingGroup",
"items":[
{
"availablePickupDate":"2020-06-30",
"inventoryLocationId":"SiteUS-GlenAllen187",
"rawTotalPrice":29.99,
"returnedQuantity":0,
"dynamicProperties":[
{
"id":"dynamicPropertyMode",
"label":"Mode",
"value":"pickup"
}
],
"shippingSurchargeValue":0,
"availabilityDate":"2020-06-30",
"discountAmount":0,
"preOrderQuantity":0,
"commerceItemId":"ci3000411",
"variant":[
{
"optionValue":"red",
"optionName":"color"
}
],
"onSale":false,
"state":"SUBMITTED",
"unitPrice":29.99,
"quantity":5,
"pointOfNoRevision":false,
"relationshipType":"string",
"productId":"Product_18Cxi",
"salePrice":0,
"preferredPickupDate":"2020-06-30",
"catRefId":"Sku_18Cxi",
"skuProperties":[
{
"propertyType":"sku-base",
"name":"UPC Code",
"id":"upcCode",
"value":12345
}
],
"siteId":"siteUS",
"asset":false,
"backOrderQuantity":0
}
]
},
"orderId":"o10003",
"creationSiteId":"siteUS",
"dynamicProperties":[
{
"id":"giftWrapMessage123",
"label":"Gift Wrap Message123",
"value":"newGSMessage45600"
}
],
"payments":[
{
"paymentGroupId":"pg70048",
"savedCardId":"sc1234",
"amount":170,
"balance":100,
"gatewayName":"chaseGiftCard",
"giftCardNumber":6.0483478347347343E18,
"paymentMethod":"creditCard",
"uiIntervention":null,
"isAmountRemaining":true,
"paymentState":"INITIAL",
"maskedCardNumber":"xxxxxxxxxxxxxxxxxx1234"
}
],
"shippingMethod":{
"shippingTax":0.46,
"cost":6.5,
"value":"ground"
},
"shoppingCart":{
"numberOfItems":1,
"items":[
{
"primaryThumbImageURL":"ccstore/v1/images/?source=/file/v7023553219093550939/products/Book.jpg&height=100&width=100",
"rawTotalPrice":179,
"displayName":"Dora The Explorer",
"dynamicProperties":[
{
"id":"giftWrapMessage123",
"label":"Gift Wrap Message123",
"value":"newGSMessage45600"
}
],
"shippingSurchargeValue":0,
"discountAmount":0,
"externalData":[
{
"values":{
"dynamic_property_key":"string"
},
"name":"string",
"actionCode":"string"
}
],
"isItemValid":true,
"commerceItemId":"ci3000411",
"price":21.99,
"variant":[
{
"optionValue":"red",
"optionName":"color"
}
],
"primaryImageAltText":"Dora The Explorer",
"actionCode":"Add",
"state":"SUBMITTED",
"id":"ci3000415",
"primaryImageTitle":"Dora The Explorer",
"childSKUs":[
{
"primaryThumbImageURL":null
}
],
"quantity":5,
"productId":"Product_18Cxi",
"pointOfNoRevision":true,
"giftWithPurchaseCommerceItemMarkers":[
{
"remainingQuantity":0,
"selectedQuantity":0,
"data":"-123345466",
"automaticQuantity":0,
"value":"promo10002",
"targetedQuantity":0,
"key":"atg.gwp"
}
],
"originalCommerceItemId":"ci3000411",
"catRefId":"Sku_18Cxi",
"skuProperties":[
{
"propertyType":"sku-base",
"name":"name",
"id":"displayName",
"value":"Sku_18Cxi"
}
],
"route":"/dora-the-explorer/product/Sku_18Cxi",
"siteId":"siteUS",
"shopperInput":{
"additionalProp1":"string",
"additionalProp3":"string",
"additionalProp2":"string"
},
"asset":false
}
]
},
"giftWithPurchaseInfo":[
{
"giftWithPurchaseQuantityAvailableForSelection":1,
"giftWithPurchaseType":1,
"giftWithPurchaseDetail":"Product_6Dxyi",
"promotionId":"promo40001",
"giftWithPurchaseIdentifier":-2.3234234355E10
}
],
"priceListGroup":{
"deleted":false,
"isTaxIncluded":false,
"endDate":null,
"displayName":"Default Price Group",
"repositoryId":"defaultPriceGroup",
"active":true,
"currency":{
"symbol":"$",
"displayName":"US Dollar",
"repositoryId":"currency",
"fractionalDigits":2,
"currencyCode":"USD",
"numericCode":840
},
"locale":"en_US",
"shippingSurchargePriceList":{
"repositoryId":"shippingSurchargePrices"
}
},
"siteId":"siteUS",
"giftWithPurchaseOrderMarkers":[
{
"quantity":1,
"selectedQuantity":0,
"removedQuantity":1,
"data":-2.4564678912E10,
"autoRemove":true,
"giftDetail":"Product_6Dxyi",
"automaticQuantity":0,
"giftType":"product",
"failedQuantity":0,
"value":"promo40001",
"targetedQuantity":0,
"key":"atg.gwp"
}
],
"orderAction":"order"
}
}
}
object
-
hasMore(optional):
string
Flag indicating whether more results exist.Example:
false
-
limit(optional):
string
Max number of results returned per response.Example:
250
-
links(optional):
array links
Collection of links indicating operations possible upon resource/subresource.
-
offset(optional):
string
Page offset currently.Example:
0
-
totalResults(optional):
string
Total number of items in collection.Example:
4
object
-
embedded(optional):
object embedded
Placeholder for additional information
-
items(optional):
array items
Shipping group information for order. Note the shippng groups will be one type hardgoodShippingGroup and/or instorePickUpShippingGroup.
array
object
-
href(optional):
string
href specifying link's destination.Example:
http://localhost:8080/ccstoreui/v1/orders/currents
-
method(optional):
string
HTTP method type.Example:
GET
-
rel(optional):
string
Allowed Values:
[ "first", "last", "self", "cononical" ]
Attribute specifying link between current response and linked destination.Example:last
array
-
Array of:
model_hardgoodShippingGroup
Hardgood shipping group.
object
-
creationSiteId(optional):
string
The ID of the site on which the order was created. This may differ to siteId value if the site is part of a cart sharing group.
-
dynamicProperties(optional):
array dynamicProperties
Read-only list of dynamic properties for the order along with meta-data.
-
giftWithPurchaseInfo(optional):
array giftWithPurchaseInfo
The gift information.
-
giftWithPurchaseOrderMarkers(optional):
array giftWithPurchaseOrderMarkers
giftWithPurchaseOrderMarker information.
-
orderAction(optional):
string
The action performed on the order.Example:
order
-
orderId(optional):
string
Order ID of the order.Example:
o10003
-
payments(optional):
array payments
Payment details for the order, including additional properties specific to the payment type.
-
priceListGroup(optional):
object priceListGroup
The price list group object.
-
shippingGroups(optional):
object shippingGroups
The shipping groups in the order.
-
shippingMethod(optional):
object shippingMethod
Shipping Method information of the order.
-
shoppingCart(optional):
object shoppingCart
Shopping cart information.
-
siteId(optional):
string
The ID of the site in which the order was createdExample:
siteUS
array
array
array
object
-
active(optional):
boolean
Active status of the price list group.Example:
true
-
currency(optional):
object currency
The currency object.
-
deleted(optional):
boolean
Property to determine existence of the price list group.Example:
false
-
displayName(optional):
string
Display name of the price list group.Example:
Default Price Group
-
endDate(optional):
string
end dateExample:
oracle.doceng.json.BetterJsonNull@64c24030
-
isTaxIncluded(optional):
boolean
Whether tax is included.Example:
false
-
locale(optional):
string
Locale of the price list group.Example:
en_US
-
repositoryId(optional):
string
Repository ID of the price list group.Example:
defaultPriceGroup
-
shippingSurchargePriceList(optional):
object shippingSurchargePriceList
Shipping Surcharge PriceList object.
object
-
discountInfo(optional):
object discountInfo
Discount Information
-
items(optional):
array items
The array of products in the shipping group.
-
priceInfo(optional):
object priceInfo
Price information of the order.
-
shippingAddress(optional):
object shippingAddress
The shipping address details.
-
shippingGroupId(optional):
string
The ID of the shipping group.Example:
sg10032
-
shippingMethod(optional):
object shippingMethod
The shipping method details for the order.
-
type(optional):
string
The type of shipping group e.g. hardgoodShippingGroup, inStorePickupShippingGroup, inStoreTakeWithShippingGroupExample:
hardgoodShippingGroup
object
-
cost(optional):
number
Cost of shipping method.Example:
6.5
-
shippingTax(optional):
number
The shipping tax.Example:
0.46
-
value(optional):
string
Shipping method value.Example:
ground
object
-
items(optional):
array items
Items in the cart.
-
numberOfItems(optional):
integer
Number of items in the cart.Example:
1
object
-
id(optional):
string
The ID of the dynamic property.Example:
giftWrapMessage123
-
label(optional):
string
The label of the dynamic property.Example:
Gift Wrap Message123
-
value(optional):
string
The value of the dynamic property.Example:
newGSMessage45600
object
-
giftWithPurchaseDetail(optional):
string
String identifying the free gift, usually the repository ID of the gift type.Example:
Product_6Dxyi
-
giftWithPurchaseIdentifier(optional):
integer
An identifier used to track which gift selection in the promotion this is. It allows the commerce item marker to link to this one.Example:
-2.3234234355E10
-
giftWithPurchaseQuantityAvailableForSelection(optional):
number
gift quantity available for selectionExample:
1
-
giftWithPurchaseType(optional):
string
The type of the gift. (sku, product)Example:
1
-
promotionId(optional):
string
The gift with purchase promotion IDExample:
promo40001
object
-
automaticQuantity(optional):
number
The quantity of free sku for this gift selection that has already been auto added to the order.Example:
0
-
autoRemove(optional):
boolean
Flag to indicate whether free gifts should be auto removed if the promotion no longer qualifies.Example:
true
-
data(optional):
integer
Identifier to track which gift selection in the promotion this is. It allows the commerce item marker to link to this one.Example:
-2.4564678912E10
-
failedQuantity(optional):
number
The amount of automatic free quantity that failed to be added to the cart due to some pricing error, e.g. invalid site.Example:
0
-
giftDetail(optional):
string
String identifying the free gift, usually the repository ID of the gift type.Example:
Product_6Dxyi
-
giftType(optional):
string
The type of the gift. (sku, product)Example:
product
-
key(optional):
string
atg.gwpExample:
atg.gwp
-
quantity(optional):
number
The total quantity of sku for this gift selection.Example:
1
-
removedQuantity(optional):
number
The amount of free quantity that has since been manually removed by a Shopper.Example:
1
-
selectedQuantity(optional):
integer
The quantity of free sku for this gift selection that has already been selected by the Shopper and added to the order.Example:
0
-
targetedQuantity(optional):
number
The quantity of free sku for this gift selection that has already been targeted and made free by the calculator in the order.
-
value(optional):
string
The gift with purchase promotion IDExample:
promo40001
object
-
amount(optional):
number
Amount authorized from the payment group.Example:
170
-
balance(optional):
number
Total available balance on the gift card.Example:
100
-
gatewayName(optional):
string
Payment gateway name. e.g. chaseCreditCard.Example:
chaseGiftCard
-
giftCardNumber(optional):
string
Gift card number.Example:
6.0483478347347343E18
-
isAmountRemaining(optional):
boolean
A boolean to decide if more payment can be made from this payment group.Example:
true
-
maskedCardNumber(optional):
string
Masked gift card number.Example:
xxxxxxxxxxxxxxxxxx1234
-
paymentGroupId(optional):
string
Payment group ID.Example:
pg70048
-
paymentMethod(optional):
string
Payment method. e.g. physicalGiftCard/ creditCard.Example:
creditCard
-
paymentState(optional):
string
The state of the payment group. e.g. AUTHORIZED.Example:
INITIAL
-
savedCardId(optional):
string
ID of the saved card associated with the payment group.Example:
sc1234
-
uiIntervention(optional):
string
This decides whether the client has to do some intervention for payment. e.g. SOP.Example:
oracle.doceng.json.BetterJsonNull@566f79
object
-
currencyCode(optional):
string
The currency code.Example:
USD
-
displayName(optional):
string
Display name of the currency.Example:
US Dollar
-
fractionalDigits(optional):
integer
Number of fractional digits for the currency.Example:
2
-
numericCode(optional):
string
Numeric code of the currency.Example:
840
-
repositoryId(optional):
string
Repository ID of the currency.Example:
currency
-
symbol(optional):
string
The currency symbol.Example:
$
object
-
repositoryId(optional):
string
Repository ID of the shipping surcharge price list.Example:
shippingSurchargePrices
object
-
discountDescList(optional):
array discountDescList
The list of all the order discounts.
-
orderDiscount(optional):
number
Order DiscountExample:
0
-
orderImplicitDiscountList(optional):
array orderImplicitDiscountList
Implicit Promotions for the order
-
shippingDiscount(optional):
number
Shipping DiscountExample:
0
object
-
amount(optional):
number
Amount of order.Example:
179
-
currencyCode(optional):
string
Currency code for currency being used.Example:
USD
-
primaryCurrencyTotal(optional):
number
The current total in loyalty points in case of multi currencyExample:
204.06
-
shipping(optional):
number
Shipping price of order.Example:
6.5
-
shippingSurchargeValue(optional):
number
Extra handling costs for shipping the products.Example:
0
-
subTotal(optional):
number
Sub total.Example:
179
-
tax(optional):
number
Tax.Example:
18.56
-
total(optional):
number
Total amount of order.Example:
204.06
-
totalWithoutTax(optional):
string
The total without including tax.Example:
185.5
object
-
address1(optional):
string
Address snippet.Example:
76 Palm Drive
-
address2(optional):
string
Address snippet.Example:
Florida
-
address3(optional):
string
Address snippet.Example:
Florida
-
alias(optional):
string
Address alias.Example:
Address03#
-
city(optional):
string
City.Example:
Orlando
-
companyName(optional):
string
Company name.Example:
Doctor's Place
-
country(optional):
string
Country.Example:
US
-
county(optional):
string
County.Example:
Florida
-
email(optional):
string
Email address.Example:
john@email.com
-
faxNumber(optional):
string
Fax number.Example:
330193316
-
firstName(optional):
string
First name.Example:
John
-
jobTitle(optional):
string
Job title.Example:
Doctor
-
lastName(optional):
string
Last name.Example:
Smith
-
middleName(optional):
string
Middle name.Example:
Joe
-
phoneNumber(optional):
string
Phone number.Example:
09345456345
-
postalCode(optional):
string
Postal code.Example:
32002
-
prefix(optional):
string
Name prefix.Example:
Mr
-
selectedCountry(optional):
string
Country code.Example:
US
-
state(optional):
string
State.Example:
FL
-
suffix(optional):
string
Name suffix.Example:
John Smith
object
-
cost(optional):
number
The total cost of shipping.Example:
6.5
-
shippingMethodDescription(optional):
string
The description of the shipping method.Example:
Ground
-
shippingTax(optional):
number
The shipping tax.Example:
0.46
-
taxCode(optional):
string
Tax Code.Example:
PC00300
-
taxIncluded(optional):
boolean
Whether tax is includedExample:
true
-
value(optional):
string
The shipping method applied to the order.Example:
ground
object
-
coupon(optional):
string
The coupon code.Example:
FREETATTOO
-
external(optional):
boolean
States whether this promotion was applied by an external system (only present on external promotions).Example:
false
-
promotionDesc(optional):
string
Description of the promotion. Retained for backward compatibility.Example:
Explicit Item Discount - FREETATTOO
-
promotionId(optional):
string
The promotion ID.Example:
explicitItemFreeDiscount
-
promotionLevel(optional):
string
The promotion level.Example:
item
-
promotionName(optional):
string
The display name of the promotion.Example:
Free Tattoo
object
-
external(optional):
boolean
States whether this promotion was applied by an external system (only present on external promotions).Example:
false
-
promotionDesc(optional):
string
Description of the promotion. Retained for backward compatibility.Example:
Implicit Item Discount - 3PercentOff
-
promotionId(optional):
string
The Id of the promotion.Example:
implicitItemPercentDiscount
-
promotionLevel(optional):
string
The promotion level.Example:
item
object
-
asset(optional):
boolean
The flag that determines if the current item is an asset or not.Example:
false
-
availabilityDate(optional):
string
The availability date of commerce Item.Example:
2020-06-30
-
availablePickupDate(optional):
string
The available date (in ISO format) for collection of items to be picked up in store (if shipping group type is inStorePickupShippingGroup).Example:
2020-06-30
-
backOrderQuantity(optional):
number
Back Order Quantity of the Items.Example:
0
-
catRefId(optional):
string
The product variant ID.Example:
Sku_18Cxi
-
commerceItemId(optional):
string
The ID of the commerce item.Example:
ci3000411
-
discountAmount(optional):
number
The value of the discount.Example:
0
-
dynamicProperties(optional):
array dynamicProperties
Array of custom properties at order line item level.
-
inventoryLocationId(optional):
string
Defines the inventory location that services the referenced commerce item.Example:
SiteUS-GlenAllen187
-
onSale(optional):
boolean
Whether the item is on sale or not.Example:
false
-
pointOfNoRevision(optional):
boolean
The boolean that indicates if the item has passed pointOfNoRevision.Example:
false
-
preferredPickupDate(optional):
string
The preferred date (in ISO format) for the items to be picked up in store (if shipping group type is inStorePickupShippingGroup).Example:
2020-06-30
-
preOrderQuantity(optional):
number
The pre order quantity of the items.Example:
0
-
productId(optional):
string
ID of the product in the cart.Example:
Product_18Cxi
-
quantity(optional):
integer
The quantity of the product in this shipping group.Example:
5
-
rawTotalPrice(optional):
integer
The raw price of the product.Example:
29.99
-
relationshipType(optional):
string
The type of this relationship. SHIPPINGQUANITY or SHIPPINGQUANTITYREMAINING.
-
returnedQuantity(optional):
integer
Number of referenced items that were returned.Example:
0
-
salePrice(optional):
string
Sale Price.Example:
0
-
shippingSurchargeValue(optional):
number
Extra handling costs for shipping the products.Example:
0
-
siteId(optional):
string
The ID of the site on which the item was added.Example:
siteUS
-
skuProperties(optional):
array skuProperties
Sku properties Information
-
state(optional):
string
state of the commerce ItemExample:
SUBMITTED
-
unitPrice(optional):
number
The price of the item.Example:
29.99
-
variant(optional):
array variant
List of variants for the product.
array
object
-
id(optional):
string
The ID of the dynamic property.Example:
dynamicPropertyMode
-
label(optional):
string
The label of the dynamic property.Example:
Mode
-
value(optional):
string
The value of the dynamic property.Example:
pickup
object
-
id(optional):
string
ID of the Dynamic SKU Property.Example:
upcCode
-
name(optional):
string
Name of the Dynamic SKU Property.Example:
UPC Code
-
propertyType(optional):
string
Type that indicates whether it is a base or a custom SKU property,Example:
sku-base
-
value(optional):
string
Value of the Dynamic SKU Property.Example:
12345
object
-
optionName(optional):
string
The variant option name.Example:
color
-
optionValue(optional):
string
The variant option value.Example:
red
object
-
actionCode(optional):
string
The action code that has been set on the item by the configurator system.Example:
Add
-
asset(optional):
boolean
The flag that determines if the current item is an asset or not.Example:
false
-
catRefId(optional):
string
Sku reference ID.Example:
Sku_18Cxi
-
childSkus(optional):
array childSkus
An array with single primary image url for this item's sku, or its default image.
-
commerceItemId(optional):
string
For stateless cart, can be used as a unique line item ID distinguisher.Example:
ci3000411
-
discountAmount(optional):
string
The discount amount.Example:
0
-
displayName(optional):
string
Display Name.Example:
Dora The Explorer
-
dynamicProperties(optional):
array dynamicProperties
Array of custom properties at order line item level.
-
externalData(optional):
array externalData
External data to be associated with a commerce item, provided by a configurator system.
-
giftWithPurchaseCommerceItemMarkers(optional):
array giftWithPurchaseCommerceItemMarkers
giftWithPurchaseCommerceItemMarker information.
-
id(optional):
string
Unique identifier for the line item.Example:
ci3000415
-
isItemValid(optional):
boolean
Whether item is valid or not.Example:
true
-
itemDiscountInfos(optional):
array itemDiscountInfos
Item discount infos
-
originalCommerceItemId(optional):
string
The Commerce Item ID associated with the original item from which item in cancel order is created.Example:
ci3000411
-
pointOfNoRevision(optional):
boolean
The boolean that indicates if the item has passed pointOfNoRevision.
-
price(optional):
number
Price of the items.Example:
21.99
-
primaryImageAltText(optional):
string
The product's primary image alternative text.
-
primaryImageTitle(optional):
string
The product's primary image title.Example:
Samsung - F90BN HD Flash Memory Camcorder
-
primaryThumbImageURL(optional):
string
Product's Primary Thumb Image URL.Example:
ccstore/v1/images/?source=/file/v7023553219093550939/products/Book.jpg&height=100&width=100
-
productId(optional):
string
ID of the product in the cart.Example:
Product_18Cxi
-
quantity(optional):
integer
Quantity of the items.Example:
5
-
rawTotalPrice(optional):
string
Raw Total Price.Example:
179
-
route(optional):
string
The UI route to display the product.
-
shippingSurchargeValue(optional):
number
shipping surcharge value.Example:
0
-
shopperInput(optional):
object shopperInput
Additional Properties Allowed: additionalPropertiesMap of shopper input keys to values
-
siteId(optional):
string
The ID of the site on which the item was added.
-
skuProperties(optional):
array skuProperties
Sku properties Information
-
state(optional):
string
state of the commerce ItemExample:
SUBMITTED
-
variant(optional):
array variant
List of variants for the product.
array
array
array
array
object
object
-
id(optional):
string
The ID of the dynamic property.Example:
giftWrapMessage123
-
label(optional):
string
The label of the dynamic property.Example:
Gift Wrap Message123
-
value(optional):
string
The value of the dynamic property.Example:
newGSMessage45600
object
-
actionCode(optional):
string
The action code that has been set on the externalData item by the configurator system.
-
name(optional):
string
The name to be associated with the externalData item.
-
values(optional):
object values
The array of values associated with an externalData item.
object
-
dynamic_property_key(optional):
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
object
-
automaticQuantity(optional):
number
The quantity of the free gift that this commerce item is making free and was auto added by pricing.Example:
0
-
data(optional):
integer
The gift hash code for this gift with purchase promotion.Example:
-123345466
-
key(optional):
string
atg.gwpExample:
atg.gwp
-
remainingQuantity(optional):
number
The quantity of the commerce item that is not affected by gift with purchase.Example:
0
-
selectedQuantity(optional):
number
The quantity of the free gift that this commerce item is making free and was selected by the shopper.Example:
0
-
targetedQuantity(optional):
number
The quantity of the free gift that this commerce item is making free and was targeted by pricing.Example:
0
-
value(optional):
string
The gift with purchase promotion ID.Example:
promo10002
object
-
amount(optional):
number
Discount amount for itemExample:
10
-
couponCodes(optional):
array couponCodes
Coupon codes applied to the items
-
promotionId(optional):
string
ID of the promotionExample:
promo1111
array
-
Array of:
string
Example:
TestCouponCode
object
-
id(optional):
string
ID of the Dynamic SKU Property.Example:
displayName
-
name(optional):
string
Name of the Dynamic SKU Property.Example:
name
-
propertyType(optional):
string
Type that indicates whether it is a base or a custom SKU property,Example:
sku-base
-
value(optional):
string
Value of the Dynamic SKU Property.Example:
Sku_18Cxi
object
-
optionName(optional):
string
The variant option name.Example:
color
-
optionValue(optional):
string
The variant option value.Example:
red
-
object
model_shippingGroup
Discriminator:
shippingGroupClassType
Base shipping group. -
object
model_hardgoodShippingGroup-allOf[1]
{
"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"
}
object
shippingGroupClassType
-
actualShipDate(optional):
string(datetime)
Actual date items where shipped.Example:
2019-12-04T10:40:17.794Z
-
discountInfo(optional):
object discountInfo
Shipping group discount information.
-
items(optional):
array items
List of items related to the shipping group.
-
priceInfo(optional):
object priceInfo
Price information of the shipping group.
-
shipOnDate(optional):
string(datetime)
Date items are to be shipped.Example:
2019-12-04T10:40:17.794Z
-
shippingGroupClassType:
string
Example:
hardgoodShippingGroup
-
shippingGroupId(optional):
string
Shipping group ID.Example:
SG0000001
-
shippingMethod(optional):
object model_shippingMethod
The shipping method details for the shipping group.
-
submittedDate(optional):
string(datetime)
Shipping group submitted date.Example:
2019-12-04T10:40:17.794Z
-
type(optional):
string
The shipping group type.Example:
hardgoodShippingGroup
object
-
shippingAddress(optional):
object shippingAddress
Shipping address. Note the shipping address can contain dynamic properties.
-
trackingInfo(optional):
array trackingInfo
Tracking information for shipping group.
object
-
address1(optional):
string
The address line one (required POST).Example:
Main Street
-
country(optional):
The address country.
-
email(optional):
string
The contact email address.Example:
wilson.anderson@example.com
-
firstName(optional):
string
The contact's first name (required POST).Example:
Wilson
-
lastName(optional):
string
The contact's last name (required POST).Example:
Anderson
-
phoneNumber(optional):
string
Pattern:
[0-9()+ -]+$
The contact phone number (optional POST|PATCH).Example:098233456764
-
postCode(optional):
string
The addess postcode (required POST, optional PATCH).Example:
01887
-
state(optional):
string
The address state (required POST, optional PATCH).Example:
MA
object
-
trackingNumber(optional):
string
Tracking numberExample:
TRN000001
-
trackingUrl(optional):
string
Tracking URL for shipping group.Example:
tracking.url
400 Response
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
errors(optional):
array errors
An optional list of errors if multiple errors were encountered
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code
-
type(optional):
string
The URI to the HTTP state code definition
array
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code