Create an order
post
/ccstore/v1/orders
This endpoint is used to create an order for the current user i.e. when they navigate to an item and click "add to cart". The order, at this point, can be thought of as a shopping cart i.e. this is the container for all products the user may add, and is not a completed order - it is not in a submitted state at this point, rather, it is defined as "INCOMPLETE".
Dynamic Properties of order and order line items can be added in the the request using the key value pair structure ("dynamicPropertyKey" : "dynamicPropertyValue").
Dynamic Properties of order and order line items can be added in the the request using the key value pair structure ("dynamicPropertyKey" : "dynamicPropertyValue").
These property values can take the types of:
- boolean
- date
- float
- string
- timestamp
- enumerated
- big string
Note: The minimum required properties in the payload for this endpoint call (createOrder) to be successful are shippingGroup, shippingMethod and shoppingCart.
Request
Supported Media Types
- application/json
Header Parameters
-
X-CCOrganization: string
Current organization context of the logged in user
Root Schema : createOrder_request
Type:
Show Source
object
-
amountRemaining:
string
amount to authorize.
-
billingAddress:
object billingAddress
Billing address for the order
-
cartName:
string
Cart Name for this order. Related Endpoint operations - createNewCart, createOrder, priceOrder
-
combineLineItems:
string
Value to determine if line items are to be combined. Can be yes or no. Related Endpoint operations - createOrder, createNewCart, priceOrder, submitOrder
-
lastModifierId:
string
Profile id of the last contact to modify this cart.
-
op(required):
string
operation to be performed. Related Endpoint operations - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder, resendOrdersForFulfillment.
-
orderId:
string
Commerce id for this order. Related Endpoint operations - priceOrder, submitOrder, preAuthorizeOrder
-
orders:
array orders
Orders to be resubmitted. Related Endpoint operations - resendOrdersForFulfillment
-
payments:
object payments
List of payments
-
profileId(required):
string
profile id. Related Endpoint operations - createOrder, createNewCart, priceOrder, submitOrder
-
recurringChargePriceInfo:
object recurringChargePriceInfo
Detailed information of the recurring charges at the shipping groups level
-
requestChannel:
string
request Channel name. Possible values are 'agent' or 'asa'. Related Endpoint operations - createOrder, createNewCart, priceOrder, submitOrder
-
schedule:
object schedule
The details of the schedule order. Related Endpoint operations - createOrder, createNewCart
-
scheduleOnly:
boolean
This flag decides whether to only schedule the order. This flag should be sent when we schedule the order and when the schedule key is present in the request. Related Endpoint operations - createOrder, createNewCart
- sharedWithOrganization: boolean
-
shippingAddress(required):
object shippingAddress
Shipping address. Related Endpoint operations - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder
-
shippingGroups:
array shippingGroups
Shipping Groups. Related Endpoint operations - createOrder, createNewCart, priceOrder, submitOrder
-
shippingMethod(required):
object shippingMethod
shipping method. Related Endpoint operations - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder
-
shoppingCart(required):
object shoppingCart
Shopping cart information. Related Endpoint operations - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder
-
submittedBy:
string
Profile id of the user who submitted this order if its in submitted state.
Example:
{
"op":"createOrder",
"profileId":"se-570032",
"shippingMethod":{
"value":"standardShippingMethod"
},
"shoppingCart":{
"coupons":[
{
"code":"SAVE5PERCENTON100",
"level":"order",
"description":"Order Discount - SAVE5%ON100 - Coupon",
"id":"explicitOrderDiscount5on100",
"status":"unclaimed"
}
],
"items":[
{
"deactivationDate":"2018-06-27T12:59:59Z",
"billingProfileId":"billingProfile-123",
"billingAccountId":"billingAcc-123",
"childItems":[
{
"deactivationDate":"2018-06-27T12:59:59Z",
"addOnItem":false,
"displayName":"Laptop Parts 1",
"externalData":[
],
"billingProfileId":"billingProfile-123",
"billingAccountId":"billingAcc-123",
"childItems":[
{
"serviceAccountId":"serviceAcc-123",
"deactivationDate":"2018-06-27T12:59:59Z",
"quantity":"1",
"productId":"prod40001",
"displayName":"Laptop Parts 1",
"externalData":[
],
"parentAssetKey":"12345",
"billingProfileId":"billingProfile-123",
"currentPrice":"0",
"billingAccountId":"billingAcc-123",
"rootAssetKey":"12345",
"transactionDate":"2018-06-27T12:59:59Z",
"catRefId":"sku40009",
"assetKey":"23456",
"priceListGroupId":"defaultPriceGroup",
"customerAccountId":"customerAcc-123",
"invalid":false,
"stockStatus":true,
"actionCode":"Add",
"activationDate":"2017-06-27T15:30:00Z",
"serviceId":"service-123",
"asset":false
}
],
"assetKey":"12345",
"commerceItemId":"ci19000424",
"stockStatus":true,
"actionCode":"Add",
"serviceId":"service-123",
"serviceAccountId":"serviceAcc-123",
"quantity":"1",
"productId":"prod40001",
"parentAssetKey":null,
"currentPrice":"0",
"rootAssetKey":null,
"transactionDate":"2018-06-27T12:59:59Z",
"catRefId":"sku40001",
"priceListGroupId":"defaultPriceGroup",
"customerAccountId":"customerAcc-123",
"invalid":false,
"activationDate":"2017-06-27T15:30:00Z",
"asset":false
},
{
"commerceItemId":"ci19000424",
"configurationOptionId":"confO_12",
"addOnItem":true,
"quantity":"1",
"productId":"prod12344",
"displayName":"Gift Wrap",
"shopperInput":{
"color":"neon",
"message":"Happy Birthday My Friend",
"font":"courier"
},
"configurablePropertyId":"conf022",
"catRefId":"sku12344"
}
],
"configuratorId":"12343455",
"assetKey":"12345",
"externalPrice":"722.0",
"stockStatus":true,
"onSale":true,
"actionCode":"Add",
"serviceId":"service-123",
"serviceAccountId":"serviceAcc-123",
"quantity":"1",
"productId":"Product_18Cyii",
"externalRecurringCharge":"20",
"currentPrice":"0",
"parentAssetKey":null,
"rootAssetKey":null,
"externalPriceQuantity":"-1",
"externalRecurringChargeFrequency":"Monthly",
"transactionDate":"2018-06-27T12:59:59Z",
"catRefId":"Sku_18Dxy",
"externalRecurringChargeDuration":"12",
"customerAccountId":"customerAcc-123",
"activationDate":"2017-06-27T15:30:00Z",
"asset":false
}
]
},
"shippingAddress":{
"lastName":"Spencers",
"country":"US",
"address3":"",
"address2":"",
"city":"Montgomery",
"prefix":"",
"address1":"600 Dexter Avenue",
"postalCode":"36130",
"jobTitle":"",
"companyName":"",
"county":"",
"suffix":"",
"DEFAULT_POSTAL_CODE_PATTERN":"^[0-9a-zA-Z]{1,}([ -][0-9a-zA-Z]{1,})?$",
"selectedCountry":"US",
"firstName":"Mark",
"phoneNumber":"973-974-1234",
"faxNumber":"",
"middleName":"",
"state":"AL",
"email":"",
"selectedState":"AL",
"state_ISOCode":"US-AL"
},
"requestChannel":"agent",
"dynamicPropertyShippingInstructions":"Test Instructions"
}
Nested Schema : billingAddress
Type:
object
Billing address for the order
Show Source
-
address1(required):
string
Address line 1 for this billing address.
-
address2:
string
Address line 2 for this billing address.
-
address3:
string
Address line 3 for this billing address.
-
alias:
string
Nickname or alternate name for address like home/office.
-
city(required):
string
City for this billing address.
-
companyName:
string
Company name for this billing address.
-
country:
string
Country for this billing address.
-
email:
string
Email for this billing address.
-
faxNumber:
string
Fax Number for this billing address.
-
firstName(required):
string
First Name for this billing address.
-
isDefaultAddress:
boolean
Default value of the address.
-
jobTitle:
string
JOb Title for this billing address.
-
lastName(required):
string
Last Name for this billing address.
-
middleName:
string
Middle Name for this billing address.
-
phoneNumber:
string
Phone Number for this billing address.
-
postalCode(required):
string
Postal code for this billing address.
-
prefix:
string
Prefix for this billing address.
-
repositoryId:
string
Repository Id of the address.
-
selectedCountry(required):
string
The selected country of the shipping address.
-
selectedState(required):
string
The selected state of the shipping address.
-
state:
string
State for this billing address.
-
state_ISOCode:
string
The state ISON code of the shipping address.
-
suffix:
string
suffix for this billing address.
Nested Schema : orders
Type:
array
Orders to be resubmitted. Related Endpoint operations - resendOrdersForFulfillment
Show Source
Nested Schema : payments
Type:
object
List of payments
Show Source
-
amount:
number
Amount to be authorized from the gift card. Payment type:card, physicalGiftCard, paypalCheckout, payUWebLatamCheckout.
-
cardCVV:
string
Credit card CVV.
-
cardNumber:
string
Credit card Number
-
cardType:
string
Credit card type.
-
customProperties:
object customProperties
Additional Properties Allowed: additionalPropertiesCustom object with dynamic properties. This will be passed to the webhook request
-
endMonth:
string
Credit card expiry month
-
endYear:
integer
Credit card expiry year.
-
giftCardNumber:
string
Gift card number used for payment. Payment type: physicalGiftCard(this field should be used when giftcards are used).
-
giftCardPin:
string
Gift card pin. Payment type: physicalGiftCard(this field should be used when giftcards are used).
-
nameOnCard:
string
Name printed on credit card.
-
nickname:
string
card nickname
-
paymentGroupId:
string
Payment Group Id of the gift card payment group. Payment type: physicalGiftCard
-
PONumber:
string
Purchase order number for invoice payment. Payment type: invoice
-
saveCard:
boolean
Property that determines whether to save this card or not.
-
savedCardId:
string
Id of the saved card
-
seqNum:
string
Sequence Number of the payment. In multiple paymnets, there are can be any number of payments.
-
setAsDefault:
boolean
Property to set this card as default card.
-
token:
string
Token generated on the client-side for eg. in case of hosted or transparent payment processing.
-
type:
string
payment type. payULatamWebcheckout,paypalCheckout,card,invoice,physicalGiftCard.
Nested Schema : recurringChargePriceInfo
Type:
object
Detailed information of the recurring charges at the shipping groups level
Show Source
-
amount:
integer
amount
-
currencyCode:
string
Currency code
-
shipping:
integer
shipping charge
-
subtotal:
integer
sub total
-
subTotalByFrequency:
array subTotalByFrequency
subtotal of the item by frequency
-
tax:
integer
total tax
-
taxByFrequency:
array taxByFrequency
tax by frequency
-
total:
integer
total amount
-
totalWithoutTax:
integer
total without tax
Nested Schema : schedule
Type:
object
The details of the schedule order. Related Endpoint operations - createOrder, createNewCart
Show Source
-
endDate:
string
Scheduled order end date.
-
name:
string
Name of the Scheduled Order.
-
schedule(required):
object schedule
The schedule of the scheduled order
-
startDate(required):
string
Scheduled Order start date.
-
state:
string
The state of the scheduled order.
Nested Schema : shippingAddress
Type:
object
Shipping address. Related Endpoint operations - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder
Show Source
-
address1(required):
string
The address1 of the shipping address.
-
address2(required):
string
The address2 of the shipping address.
-
address3:
string
The address3 of the shipping address.
-
city(required):
string
The city of the shipping address.
-
companyName:
string
The companyName.
-
country(required):
string
The country of the shipping address.
-
county:
string
The county of the shipping address.
-
DEFAULT_POSTAL_CODE_PATTERN:
string
The default post code pattern of the shipping address.
-
email(required):
string
email of the shipping address.
-
faxNumber:
string
The faxNumber of the shipping address.
-
firstName(required):
string
The first name of the shipping address.
-
jobTitle:
string
The job title.
-
lastName(required):
string
The last name of the shipping address.
-
middleName:
string
The middle name of the shipping address.
-
phoneNumber(required):
string
The phone Number of the shipping address.
-
postalCode(required):
string
The postal Code of the shipping address.
-
prefix:
string
prefix of shipping address name.
-
selectedCountry(required):
string
The selected country of the shipping address.
-
selectedState(required):
string
The selected state of the shipping address.
-
state(required):
string
The state of the shipping address.
-
state_ISOCode(required):
string
The state ISON code of the shipping address.
-
suffix:
string
suffix of the shipping address name.
Nested Schema : shippingGroups
Type:
array
Shipping Groups. Related Endpoint operations - createOrder, createNewCart, priceOrder, submitOrder
Show Source
Nested Schema : shippingMethod
Type:
object
shipping method. Related Endpoint operations - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder
Show Source
-
value(required):
string
method type of shipment.
Nested Schema : shoppingCart
Type:
object
Shopping cart information. Related Endpoint operations - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder
Show Source
-
coupons:
array coupons
The array of coupons applied to the order.
-
items(required):
array items
Items in the cart.
Nested Schema : customProperties
Type:
object
Additional Properties Allowed
Show Source
-
string
Dynamic Properties if any
Custom object with dynamic properties. This will be passed to the webhook request
Show Source
-
membershipId:
string
memberShipId of customer. This property need to be sent if loyalty payment method is selected for payment
-
programId:
string
Unique id for loyalty program.This property need to be sent if loyalty payment method is selected for payment
Nested Schema : taxByFrequency
Type:
array
tax by frequency
Show Source
-
Array of:
integer
tax for each frequency
Nested Schema : items
Type:
Show Source
object
-
amount:
integer
amount
-
frequency:
string
frequency of the recurring charges
Nested Schema : schedule
Type:
object
The schedule of the scheduled order
Show Source
-
daysInMonth:
array daysInMonth
Days in a month this scheduled order has to be placed
-
daysOfWeek:
array daysOfWeek
Days in a week this scheduled order has to be placed
-
monthsInYear:
array monthsInYear
Months in a year this scheduled order has to be placed
-
occurrenceInDay:
integer
The number of times this scheduled order is placed in a day
-
weeksInMonth:
array weeksInMonth
Weeks in a month this scheduled order has to be placed
Nested Schema : daysInMonth
Type:
array
Days in a month this scheduled order has to be placed
Show Source
Nested Schema : daysOfWeek
Type:
array
Days in a week this scheduled order has to be placed
Show Source
Nested Schema : monthsInYear
Type:
array
Months in a year this scheduled order has to be placed
Show Source
Nested Schema : weeksInMonth
Type:
array
Weeks in a month this scheduled order has to be placed
Show Source
Nested Schema : items
Type:
Show Source
object
-
email:
string
The email address of the person picking up the items in store (if type is inStorePickupShippingGroup).
-
firstName:
string
The first name of the person picking up the items in store (if type is inStorePickupShippingGroup).
-
items(required):
array items
Items in the cart.
-
lastName:
string
The last name of the person picking up the items in store (if type is inStorePickupShippingGroup).
-
locationId:
string
The location id of the store from which items are to be picked up (if type is inStorePickupShippingGroup) or hardgoodShippingGroup location ID.
-
middleName:
string
The middle name of the person picking up the items in store (if type is inStorePickupShippingGroup).
-
phoneNumber:
string
The phone number of the person picking up the items in store (if type is inStorePickupShippingGroup).
-
recurringChargePriceInfo:
object recurringChargePriceInfo
Detailed information of the recurring charges at the shipping groups level
-
shippingAddress:
object shippingAddress
Shipping address.
-
shippingMethod:
object shippingMethod
shipping method
-
type:
string
The type of shipping group to create, e.g. hardgoodShippingGroup, inStorePickupShippingGroup, inStoreTakeWithShippingGroup, virtualShippingGroup
Nested Schema : recurringChargePriceInfo
Type:
object
Detailed information of the recurring charges at the shipping groups level
Show Source
-
amount:
integer
amount
-
currencyCode:
string
Currency code
-
shipping:
integer
shipping charge
-
subtotal:
integer
sub total
-
subTotalByFrequency:
array subTotalByFrequency
subtotal of the item by frequency
-
tax:
integer
total tax
-
taxByFrequency:
array taxByFrequency
tax by frequency
-
total:
integer
total amount
-
totalWithoutTax:
integer
total without tax
Nested Schema : shippingAddress
Type:
object
Shipping address.
Show Source
-
address1(required):
string
The address1 of the shipping address.
-
address2(required):
string
The address2 of the shipping address.
-
address3:
string
The address3 of the shipping address.
-
city(required):
string
The city of the shipping address.
-
companyName:
string
The companyName.
-
country(required):
string
The country of the shipping address.
-
county:
string
The county of the shipping address.
-
DEFAULT_POSTAL_CODE_PATTERN:
string
The default post code pattern of the shipping address.
-
email(required):
string
email of the shipping address.
-
faxNumber:
string
The faxNumber of the shipping address.
-
firstName(required):
string
The first name of the shipping address.
-
jobTitle:
string
The job title.
-
lastName(required):
string
The last name of the shipping address.
-
middleName:
string
The middle name of the shipping address.
-
phoneNumber(required):
string
The phone Number of the shipping address.
-
postalCode(required):
string
The postal Code of the shipping address.
-
prefix:
string
prefix of shipping address name.
-
selectedCountry(required):
string
The selected country of the shipping address.
-
selectedState(required):
string
The selected state of the shipping address.
-
state(required):
string
The state of the shipping address.
-
state_ISOCode(required):
string
The state ISON code of the shipping address.
-
store:
object store
Information about the Store that the items are being picked up from (if shipping group type is inStorePickupShippingGroup)
-
suffix:
string
suffix of the shipping address name.
-
type:
string
The type of shipping group to create, e.g. hardgoodShippingGroup, inStorePickupShippingGroup, inStoreTakeWithShippingGroup, virtualShippingGroup
Nested Schema : shippingMethod
Type:
object
shipping method
Show Source
-
value(required):
string
method type of shipment.
Nested Schema : items
Type:
Show Source
object
-
availablePickupDate:
string
The available date (in ISO format) for collection of items to be picked up in store (if shipping group type is inStorePickupShippingGroup).
-
catRefId(required):
string
catRefId of the product.
-
commerceItemId:
string
Unique id of the line item
-
configuratorId:
string
Configuration id of the configurable product
-
detailedRecurringChargeInfo:
array detailedRecurringChargeInfo
recurring charge information
-
externalRecurringCharge:
integer
recurring charge
-
externalRecurringChargeDuration:
integer
recurring charge duration
-
externalRecurringChargeFrequency:
string
recurring charge frequency
-
preferredPickupDate:
string
The preferred date (in ISO format) for the items to be picked up in store (if shipping group type is inStorePickupShippingGroup).
-
productId(required):
string
Id of the product.
-
quantity(required):
integer
quantity of the product.
-
recurringCharge:
integer
recurring charge
Nested Schema : items
Type:
Show Source
object
-
amount:
integer
total amount
-
currencyCode:
string
Currency code
-
detailedUnitPrice:
integer
detailed unit price
-
discounted:
boolean
whether the item is discounted or not
- orderDiscountShare: integer
-
quantity:
integer
quantity of the item
-
secondaryCurrencyTaxAmount:
integer
secondary currency Tax amount
-
tax:
integer
tax on the recurring charges
Nested Schema : taxByFrequency
Type:
array
tax by frequency
Show Source
-
Array of:
integer
tax for each frequency
Nested Schema : items
Type:
Show Source
object
-
amount:
integer
amount
-
frequency:
string
frequency of the recurring charges
Nested Schema : store
Type:
object
Information about the Store that the items are being picked up from (if shipping group type is inStorePickupShippingGroup)
Show Source
-
address1:
string
Address line 1 of the store.
-
address2:
string
Address line 2 of the store.
-
address3:
string
Address line 3 of the store.
-
city:
string
The city in which the store resides.
-
country:
string
The country in which the store resides.
-
county:
string
The county in which the store resides.
-
email:
string
The email address of the store.
-
faxNumber:
string
The fax number of the store.
-
hours:
string
The opening hours of the store.
-
locationId:
string
The location id of the store.
-
name:
string
Name of the store.
-
phoneNumber:
string
The phone number of the store.
-
postalCode:
string
The postal code of the store.
-
stateAddress:
string
The state in which the store resides.
Nested Schema : items
Type:
Show Source
object
-
code(required):
string
The coupon code.
-
description:
string
The coupon description.
-
id(required):
string
The coupon id.
-
level(required):
string
The level of the coupon (whether the coupon is item level, etc).
-
status(required):
string
The current status of the coupon.
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the item by the configurator system.
-
activationDate:
string
The activation date in ISO format.
-
asset:
boolean
The flag that determines if the current item is an asset or not.
-
assetKey:
string
The assetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
billingAccountId:
string
The billing account ID associated to the current item.
-
billingProfileId:
string
The billing profile ID associated to the current item.
-
catRefId(required):
string
catRefId of the product.
-
childItems:
array childItems
Child items of the commerce item
-
commerceItemId:
string
Unique id of the line item.
-
configuratorId:
string
Configuration id of the configurable product
-
currentPrice(required):
number
price of the product.
-
customerAccountId:
string
The customer account ID associated to the current item.
-
deactivationDate:
string
The deactivation date in ISO format.
-
externalData:
array externalData
External data to be associated with a commerce item, provided by a configurator system.
-
externalPrice:
integer
The Price of the product as per the external pricing system.
-
externalPriceQuantity:
integer
Quantity of the product, the customer is allowed to buy at the external price.
-
isPriceOverridden:
boolean
Indicates whether an item price is overridden. Should not be added when the operation is of type 'createOrder'
-
onSale(required):
boolean
indicates if product is on sale or not.
-
overriddenPrice:
number
overridden price of commerce item. Should not be added when the operation is of type 'createOrder'
-
parentAssetKey:
string
The parentAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
priceOverrideReason:
string
Price override reason. Should not be added when the operation is of type 'createOrder'
-
productId(required):
string
Id of the product.
-
quantity(required):
integer
quantity of the product.
-
rootAssetKey:
string
The rootAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
serviceAccountId:
string
The service account ID associated to the current item.
-
serviceId:
string
The service ID associated to the current item.
-
shopperInput:
object shopperInput
Additional Properties Allowed: additionalPropertiesMap of shopper input keys to values
-
stockStatus(required):
boolean
stockStatus of the product.
-
transactionDate:
string
ISO formatted Date on which the service action should be triggered.
Nested Schema : externalData
Type:
array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : shopperInput
Type:
object
Additional Properties Allowed
Show Source
Map of shopper input keys to values
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the item by the configurator system.
-
activationDate:
string
The activation date in ISO format.
-
addOnItem:
boolean
Whether the sub commerce item is an add-on (internally configured) or not (externally configured).
-
asset:
boolean
The flag that determines if the current item is an asset or not.
-
assetKey:
string
The assetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
billingAccountId:
string
The billing account ID associated to the current item.
-
billingProfileId:
string
The billing profile ID associated to the current item.
-
catRefId(required):
string
Sku Id of the child item
-
childItems:
array childItems
Child items of the commerce item
-
commerceItemId:
string
commerce item id of the child item
-
configurablePropertyId:
string
ID of the catalog's configurableProperty associated with this sub commerce item.
-
configurationOptionId:
string
ID of the catalog's configurationOption associated with this sub commerce item.
-
currentPrice:
number
Current price of the child item
-
customerAccountId:
string
The customer account ID associated to the current item.
-
deactivationDate:
string
The deactivation date in ISO format.
-
displayName:
string
Display name of the child item
-
externalData:
array externalData
External data to be associated with a commerce item, provided by a configurator system.
-
invalid:
boolean
Invalid state of the child item
-
parentAssetKey:
string
The parentAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
priceListGroupId:
string
price list group id of the child item
-
productId(required):
string
Product Id of the child item
-
quantity(required):
number
Quantity of the child item
-
rootAssetKey:
string
The rootAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
serviceAccountId:
string
The service account ID associated to the current item.
-
serviceId:
string
The service ID associated to the current item.
-
shopperInput:
object shopperInput
Additional Properties Allowed: additionalPropertiesMap of shopper input keys to values
-
stockStatus:
boolean
Stock status Id of the child item
-
transactionDate:
string
ISO formatted Date on which the service action should be triggered.
Nested Schema : externalData
Type:
array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : shopperInput
Type:
object
Additional Properties Allowed
Show Source
Map of shopper input keys to values
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the item by the configurator system.
-
activationDate:
string
The activation date in ISO format.
-
asset:
boolean
The flag that determines if the current item is an asset or not.
-
assetKey:
string
The assetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
billingAccountId:
string
The billing account ID associated to the current item.
-
billingProfileId:
string
The billing profile ID associated to the current item.
-
catRefId(required):
string
Sku Id of the child item
-
currentPrice:
number
Current price of the child item
-
customerAccountId:
string
The customer account ID associated to the current item.
-
deactivationDate:
string
The deactivation date in ISO format.
-
displayName:
string
Display name of the child item
-
externalData:
array externalData
External data to be associated with a commerce item, provided by a configurator system.
-
invalid:
boolean
Invalid state of the child item
-
parentAssetKey:
string
The parentAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
priceListGroupId:
string
price list group id of the child item
-
productId(required):
string
Product Id of the child item
-
quantity(required):
number
Quantity of the child item
-
rootAssetKey:
string
The rootAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
serviceAccountId:
string
The service account ID associated to the current item.
-
serviceId:
string
The service ID associated to the current item.
-
stockStatus:
boolean
Stock status Id of the child item
-
transactionDate:
string
ISO formatted Date on which the service action should be triggered.
Nested Schema : externalData
Type:
array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the externalData item by the configurator system.
-
name(required):
string
The name to be associated with the externalData item.
-
values(required):
object values
The array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
Show Source
-
dynamic_property_key(required):
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the externalData item by the configurator system.
-
name(required):
string
The name to be associated with the externalData item.
-
values(required):
object values
The array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
Show Source
-
dynamic_property_key(required):
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the externalData item by the configurator system.
-
detailedRecurringChargeInfo:
array detailedRecurringChargeInfo
recurring charge information
-
externalRecurringCharge:
integer
recurring charge
-
externalRecurringChargeDuration:
integer
recurring charge duration
-
externalRecurringChargeFrequency:
string
recurring charge frequency
-
name(required):
string
The name to be associated with the externalData item.
-
recurringCharge:
integer
recurring charge
-
values(required):
object values
The array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
Show Source
-
dynamic_property_key(required):
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
Show Source
object
-
amount:
integer
total amount
-
currencyCode:
string
Currency code
-
detailedUnitPrice:
integer
detailed unit price
-
discounted:
boolean
whether the item is discounted or not
- orderDiscountShare: integer
-
quantity:
integer
quantity of the item
-
secondaryCurrencyTaxAmount:
integer
secondary currency Tax amount
-
tax:
integer
tax on the recurring charges
Response
Supported Media Types
- application/json
200 Response
Returned when the operation succeeds.
Root Schema : createOrder_response
Type:
Show Source
object
-
billingMethod:
object billingMethod
Billing method information of the order. Related Endpoint operation - submitOrder.
-
cartName:
string
Cart Name for this order. If the value is passed for the cartName it will set else orderId will be set by default
-
creationDate:
string
Date on which the Order was created. Related Endpoint operation - submitOrder.
-
creationTime:
string
Order creation Time. Related Endpoint operation - submitOrder.
-
discountInfo:
object discountInfo
Discount information. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder.
-
dynamicProperties:
array dynamicProperties
Read-only list of dynamic properties for the order along with meta-data. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
-
giftWithPurchaseInfo:
array giftWithPurchaseInfo
Gift Selection Information. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
-
giftWithPurchaseOrderMarkers:
array giftWithPurchaseOrderMarkers
Gift With Purchase order markers information. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
-
isItemPriceOverrideAllowed:
boolean
Indicates whether an item price can be overridden. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
-
lastModifierId:
string
Profile id of the last contact to modify this cart.
-
markers:
array markers
Order markers
-
notSubmittedOrders:
array notSubmittedOrders
Orders not submitted for fulfillment. Related Endpoint operations - resendOrdersForFulfillment
-
orderAction:
string
The action performed on the order.
-
orderComments:
array orderComments
The list of all logged comments for the order.
-
orderId:
string
Id of newly created order. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder.
-
paymentGroup:
object paymentGroup
Payment Group for the order. Related Endpoint operation - submitOrder.
-
paymentGroups:
array paymentGroups
List of payment Groups for the order. Related Endpoint operations - submitOrder
-
priceInfo:
object priceInfo
Price information. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder.
-
pricingMessages:
object pricingMessages
The Pricing messages information. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
-
profile:
object profile
Profile Information for the order. Related Endpoint operations - submitOrder
-
returnRequests:
array returnRequests
The list of the requests raised for the order. Related Endpoint operations - submitOrder
-
scheduledOrderId:
string
The id of the scheduled order corresponding to this order, if the order is a template order. This is an optional key and will not be available if the order is not a template order. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
-
scheduledOrderName:
string
The name of the scheduled order corresponding to this order, if the order is a template order. This is an optional key and will not be available if the order is not a template order. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
- sharedWithOrganization: boolean
-
shippingAddress:
object shippingAddress
Shipping address. Related Endpoint operations - submitOrder
-
shippingGroups:
array shippingGroups
Shipping Groups. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
-
shippingMethod:
object shippingMethod
Shipping method information. Related Endpoint operation - priceOrder, submitOrder, preAuthorizeOrder.
-
shoppingCart:
object shoppingCart
Shopping cart information. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder.
-
siteId:
string
Site Id on which the order was placed. Related Endpoint operation - priceOrder, submitOrder, preAuthorizeOrder.
-
sourceSystem:
string
The system where the order originated. Related Endpoint operation - submitOrder.
-
state:
integer
The order state. Related Endpoint operation - submitOrder.
-
stateDetailsAsUser:
string
Order State description for this order. Incorporates changes made by merchant from admin UI, if any. Related Endpoint operation - submitOrder.
-
submittedBy:
string
Profile id of the user who submitted this order if its in submitted state.
-
submittedOrders:
array submittedOrders
Orders submitted for fulfillment. Related Endpoint operations - resendOrdersForFulfillment
-
taxPriceInfo:
object taxPriceInfo
The tax pricing details for the order. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
-
totalAmountAuthorized:
number
Total amount authorized for the order. Related Endpoint operation - submitOrder.
Nested Schema : billingMethod
Type:
object
Billing method information of the order. Related Endpoint operation - submitOrder.
Show Source
-
cost:
integer
Shipping cost.
-
displayName:
string
Billing method display name for this billing method.
-
value:
string
Method type of billing.
Nested Schema : discountInfo
Type:
object
Discount information. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder.
Show Source
-
claimedCouponMultiPromotions:
object claimedCouponMultiPromotions
The coupons that were claimed.
-
orderCouponsMap:
object orderCouponsMap
The coupons that were claimed.
-
orderDiscount:
number
Discount given on an order.
-
orderImplicitDiscountList:
array orderImplicitDiscountList
List of discounts.
-
secondaryCurrencyShippingDiscount:
number
The shipping discount in secondary currency in case of mix currency scenario.
-
shippingDiscount:
number
The shipping discount.
-
unclaimedCouponMultiPromotions:
object unclaimedCouponMultiPromotions
The coupons that were not claimed
-
unclaimedCouponsMap:
array unclaimedCouponsMap
Map of unclaimed coupons.
Nested Schema : dynamicProperties
Type:
array
Read-only list of dynamic properties for the order along with meta-data. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
Show Source
Nested Schema : giftWithPurchaseInfo
Type:
array
Gift Selection Information. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
Show Source
Nested Schema : giftWithPurchaseOrderMarkers
Type:
array
Gift With Purchase order markers information. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
Show Source
Nested Schema : notSubmittedOrders
Type:
array
Orders not submitted for fulfillment. Related Endpoint operations - resendOrdersForFulfillment
Show Source
Nested Schema : orderComments
Type:
array
The list of all logged comments for the order.
Show Source
Nested Schema : paymentGroup
Type:
object
Payment Group for the order. Related Endpoint operation - submitOrder.
Show Source
-
amount:
number
The amount associated with this Payment Group.
-
amountAuthorized:
number
The amount authorized with this Payment Group.
-
balance:
string
The gift card balance available.
-
billingAddress:
object billingAddress
Billing address for the order.
-
cardNumber:
string
The masked credit card number.
-
cardType:
string
The credit card type.
-
firstName:
string
First name associated with this Payment Group.
-
lastName:
string
Last name associated with this Payment Group.
-
paidAmount:
number
The amount that has been debited to-date for this Payment Group.
-
paymentGroupId:
integer
Id of this payment Group.
-
paymentState:
string
The Payment Group state.
-
paymentStateDetailsAsUser:
string
The payment state description as string.
-
paymentStatString:
string
The payment state as a key string.
-
PONumber:
string
Purchase order number for invoice payment. Payment type: invoice
-
refundAmount:
number
The amount that has been credited to-date for this Payment Group.
-
token:
string
Token associated with this Payment Group.
-
totalDue:
number
The current working total order price including all discounts, tax, and billing costs.
-
uiIntervention:
string
This decides whether the client has to do some intervention for payment. e.g. SOP
-
zero_value_auto_authorized:
string
The Payment Group is auto authorized without any payment details for zero amount. e.g. true
Nested Schema : paymentGroups
Type:
array
List of payment Groups for the order. Related Endpoint operations - submitOrder
Show Source
Nested Schema : priceInfo
Type:
object
Price information. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder.
Show Source
-
amount:
number
The raw number that represents the price.
-
currencyCode:
string
Indicates the currency of the price. For example, USD indicates that the price is in US dollars.
-
orderTotalBySite:
object orderTotalBySite
The map containing order totals by site for all sites in a given order.
-
primaryCurrencyTotal:
number
An order can be paid in points and monetary currency. This field represent order value which will be paid in points. It includes items amount, item discount, order discount. Prerequisites for the value in this Attribute: 1. PriceList configured for the site is in custom currency. 2. payTaxInSecondaryCurrency and payShippingInSecondaryCurrency flags are enabled.
-
secondaryCurrencyShippingAmount:
number
This field represents the shipping amount, shipping discount and shipping surcharge in monetary Currency. Prerequisites for the value in this Attribute: 1. PriceList configured for the site is in custom currency. 2. payTaxInSecondaryCurrency and payShippingInSecondaryCurrency flags are enabled.
-
secondaryCurrencyTaxAmount:
number
This field represents the total tax(Item Tax and Shipping Tax) of the order in Monetary Currency. Prerequisites for the value in this Attribute: Prerequisites for the value in this Attribute: 1. PriceList configured for the site is in custom currency. 2. payTaxInSecondaryCurrency and payShippingInSecondaryCurrency flags are enabled. 3. If the tax is included in the price of the item, then this value represents only shipping tax in monetary currency.
-
secondaryCurrencyTotal:
number
An order can be paid in points and monetary currency. This field represent order value which will be paid in monetary currency. It includes shipping charges, shipping surcharges, shipping discount and total tax in monetary currency. Prerequisites for the value in this Attribute: 1. PriceList configured for the site is in custom currency. 2. payTaxInSecondaryCurrency and payShippingInSecondaryCurrency flags are enabled. 3. If the tax is included in the price of the item, then this value represents only shipping tax in monetary currency.
-
shipping:
number
shipping amount
-
subTotal:
number
The subtotal of the order before applying order-level promotions.
-
tax:
number
The tax on the order.
-
total:
number
The current working total, including all promotions, tax, and billing costs.
Nested Schema : pricingMessages
Type:
object
The Pricing messages information. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
Show Source
-
GiftWithPurchaseMessages:
array GiftWithPurchaseMessages
The GWP messages information.
-
promotionUpsellMessages:
array promotionUpsellMessages
The promotion upsell messages.
Nested Schema : profile
Type:
object
Profile Information for the order. Related Endpoint operations - submitOrder
Show Source
-
email:
string
Email Address corresponding to the profile.
-
firstName:
string
First name of profile.
-
isAnonymous:
boolean
Indicates whether this profile is an anonymous profile. By default, it is false.
-
lastName:
string
Last name of profile.
-
middleName:
string
Middle name of profile.
-
organization:
object organization
The Organization associated with the B2B customer profile.
Nested Schema : returnRequests
Type:
array
The list of the requests raised for the order. Related Endpoint operations - submitOrder
Show Source
Nested Schema : shippingAddress
Type:
object
Shipping address. Related Endpoint operations - submitOrder
Show Source
-
address1:
string
The address1 of the shipping address.
-
address2:
string
The address2 of the shipping address.
-
address3:
string
The address3 of the shipping address.
-
city:
string
The city of the shipping address.
-
companyName:
string
The companyName.
-
country:
string
The country of the shipping address.
-
county:
string
The county of the shipping address.
-
DEFAULT_POSTAL_CODE_PATTERN:
string
The default post code pattern of the shipping address.
-
email:
string
email of the shipping address.
-
faxNumber:
string
The faxNumber of the shipping address.
-
firstName:
string
The first name of the shipping address.
-
jobTitle:
string
The job title.
-
lastName:
string
The last name of the shipping address.
-
middleName:
string
The middle name of the shipping address.
-
phoneNumber:
string
The phone Number of the shipping address.
-
postalCode:
string
The postal Code of the shipping address.
-
prefix:
string
prefix of shipping address name.
-
selectedCountry:
string
The selected country of the shipping address.
-
selectedState:
string
The selected state of the shipping address.
-
state:
string
The state of the shipping address.
-
state_ISOCode:
string
The state ISON code of the shipping address.
-
suffix:
string
suffix of the shipping address name.
Nested Schema : shippingGroups
Type:
array
Shipping Groups. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
Show Source
Nested Schema : shippingMethod
Type:
object
Shipping method information. Related Endpoint operation - priceOrder, submitOrder, preAuthorizeOrder.
Show Source
-
cost:
integer
Shipping cost.
-
secondaryCurrencyShippingAmount:
string
shipping amount in secondary currency.
-
secondaryCurrencyTaxAmount:
string
tax amount in secondary currency.
-
value:
string
Method type of shipment.
Nested Schema : shoppingCart
Type:
object
Shopping cart information. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder, preAuthorizeOrder.
Show Source
-
items:
array items
Items in the cart.
-
numberOfItems:
integer
number of items in an order.
Nested Schema : submittedOrders
Type:
array
Orders submitted for fulfillment. Related Endpoint operations - resendOrdersForFulfillment
Show Source
Nested Schema : taxPriceInfo
Type:
object
The tax pricing details for the order. Related Endpoint operation - createOrder, createNewCart, priceOrder, submitOrder.
Show Source
-
amount:
number
The monetary amount.
-
amountIsFinal:
boolean
Whether the amount is final.
-
cityTax:
number
The monetary amount of city tax.
-
countryTax:
number
The monetary amount of country tax.
-
countyTax:
number
The monetary amount of county tax.
-
currencyCode:
string
The three character currency code.
-
discounted:
boolean
Whether the price was discounted.
-
districtTax:
number
Tax amount for the district.
-
secondaryCurrencyTaxAmount:
number
The monetary total amount of tax.
-
stateTax:
number
Tax amount for the state.
Nested Schema : claimedCouponMultiPromotions
Type:
object
The coupons that were claimed.
Show Source
-
couponCode:
array couponCode
Coupon Code, corresponding to which promotions were applied
Nested Schema : orderCouponsMap
Type:
object
The coupons that were claimed.
Show Source
-
couponCode:
object couponCode
Coupon Code.
Nested Schema : unclaimedCouponMultiPromotions
Type:
object
The coupons that were not claimed
Show Source
-
couponCode:
array couponCode
Coupon Code, corresponding to which some promotions were not applied
Nested Schema : couponCode
Type:
array
Coupon Code, corresponding to which promotions were applied
Show Source
Nested Schema : items
Type:
Show Source
object
-
promotionDesc:
string
Promotion description.
-
promotionId:
string
The Id of the promotion.
-
promotionLevel:
string
The promotion level.
-
totalAdjustment:
number
Total adjustment caused by the promotion.
Nested Schema : couponCode
Type:
object
Coupon Code.
Show Source
-
external:
boolean
States whether this promotion was applied by an external system (only present on external promotions).
-
promotionDesc:
string
Description of the promotion. Retained for backward compatibility.
-
promotionId:
string
The Id of the promotion.
-
promotionLevel:
string
The promotion level.
-
promotionLongDesc:
string
The description of the promotion.
-
promotionName:
string
The display name of the promotion.
-
totalAdjustment:
number
Total adjustment caused by the promotion.
Nested Schema : items
Type:
Show Source
object
-
promotionDesc:
string
Description of the promotion.
-
promotionId:
string
Id of the promotion.
-
promotionLevel:
string
The promotion level.
-
totalAdjustment:
string
Total adjustment caused by the promotion.
Nested Schema : couponCode
Type:
array
Coupon Code, corresponding to which some promotions were not applied
Show Source
Nested Schema : items
Type:
Show Source
object
-
promotionDesc:
string
Promotion description.
-
promotionId:
string
The Id of the promotion.
-
promotionLevel:
string
The promotion level.
Nested Schema : items
Type:
Show Source
object
-
couponInfo:
array couponInfo
The coupon Info.
-
promotionValue:
string
The value for promotion.
Nested Schema : items
Type:
Show Source
object
-
promotionDesc:
string
Description of the promotion.
-
promotionId:
string
Id of the promotion.
-
promotionLevel:
string
The promotion level.
-
totalAdjustment:
string
Total adjustment caused by the promotion.
Nested Schema : items
Type:
Show Source
object
-
id:
string
The ID of the dynamic property.
-
value:
string
The value of the dynamic property.
Nested Schema : items
Type:
Show Source
object
-
giftHashCode:
string
The gift hash code for the promotion
-
giftWithPurchaseDetail:
string
String identifying the gift usually the repository ID of the gift type.
-
giftWithPurchaseIdentifier:
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.
-
giftWithPurchaseQuantityAvailableForSelection:
number
Quantity of gift that the shopper still needs to select.
-
giftWithPurchaseType:
string
The type of gift like sku, product, category, skuContentGroup or productContentGroup.
-
promotionDesc:
string
The promotion description.
-
promotionId:
string
The gift with purchase promotion id
Nested Schema : items
Type:
Show Source
object
-
automaticQuantity:
number
The quantity of free sku for this gift selection that has already been auto added to the order.
-
autoRemove:
boolean
Flag to indicate whether free gifts should be auto removed if the promotion no longer qualifies.
-
data:
string
Gift hash code to track which gift selection in the promotion this is. It allows the commerce item marker to link to this one.
-
failedQuantity:
number
The amount of automatic free quantity that failed to be added to the cart due to some pricing error, e.g. invalid site..
-
giftDetail:
string
String identifying the free gift, usually the repository id of the gift type.
-
giftType:
string
The type of gift like sku, product, category, skuContentGroup or productContentGroup.
-
key:
string
atg.gwp.
-
quantity:
number
The total quantity of sku for this gift selection.
-
removedQuantity:
number
The amount of free quantity that has since been manually removed by a Shopper.
-
repositoryId:
string
The repository id of the gwp order marker.
-
selectedQuantity:
number
The quantity of free sku for this gift selection that has already been selected by the Shopper and added to the order.
-
targetedQuantity:
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:
string
The GWP promotion id.
Nested Schema : items
Type:
Show Source
object
-
key:
string
Order marker key. In a marketing campaign marker, key signifies that it is a campaign marker and it also identifies the external marketing system that is the source of the campaign, e.g., campaign_eloqua
-
value:
string
Order marker value. In a marketing campaign marker, value holds the marketing system's unique campaign ID.
Nested Schema : items
Type:
Show Source
object
-
failureReason:
string
Failure Reason.
-
orderId:
string
Order Id of the order whose submission has failed.
Nested Schema : items
Type:
Show Source
object
-
comment:
string
The comment string.
-
creationDate:
string
Date on which the comment was created.
-
repositoryId:
string
The repository id of the comment record.
Nested Schema : billingAddress
Type:
object
Billing address for the order.
Show Source
-
address1:
string
Address line 1 for this billing address.
-
address2:
string
Address line 2 for this billing address.
-
address3:
string
Address line 3 for this billing address.
-
city:
string
City for this billing address.
-
companyName:
string
Company name for this billing address.
-
country:
string
Country for this billing address.
-
county:
string
County for this billing address.
-
email:
string
Email for this billing address.
-
faxNumber:
string
Fax number for this billing address.
-
firstName:
string
First name for this billing address.
-
jobTitle:
string
Job title for this billing address.
-
lastName:
string
Last name for this billing address.
-
middleName:
string
Middle name for this billing address.
-
phoneNumber:
string
Phone number for this billing address.
-
postalCode:
string
Postal code for this billing address.
-
prefix:
string
Prefix for this billing address.
-
selectedCountry:
string
The selected country of the shipping address.
-
selectedState:
string
The selected state of the shipping address.
-
state:
string
State for this billing address.
-
state_ISOCode:
string
The state ISON code of the shipping address.
-
suffix:
string
Suffix for this billing address.
Nested Schema : items
Type:
Show Source
object
-
amount:
number
The amount associated with this Payment Group.
-
amountAuthorized:
number
The amount authorized with this Payment Group.
-
billingAddress:
object billingAddress
Billing address for the order.
-
cardNumber:
string
The masked credit card number.
-
cardType:
string
Payment method e.g. physicalGiftCard/creditCard
-
firstName:
string
First name associated with this Payment Group.
-
IIN:
string
The issuer identification number (first 6 digits) of any IIN payment type card, e.g. credit card. This is normally used to allow any credit card type based promotions to be applied prior to final checkout.
-
lastName:
string
Last name associated with this Payment Group.
-
paidAmount:
number
The amount that has been debited to-date for this Payment Group.
-
paymentGroupId:
integer
Id of this payment Group.
-
paymentState:
string
The Payment Group state.
-
paymentStateDetailsAsUser:
string
The payment state description as string.
-
PONumber:
string
Purchase order number for invoice payment. Payment type: invoice
-
refundAmount:
number
The amount that has been credited to-date for this Payment Group.
-
seqNum:
string
Sequence Number of the payment. In multiple paymnets, there are can be any number of payments.
-
token:
string
Token associated with this Payment Group.
-
totalDue:
number
The current working total order price including all discounts, tax, and billing costs.
-
type(required):
string
Payment type e.g payULatamWebcheckout, paypalCheckout, card, invoice, physicalGiftCard
-
uiIntervention:
string
This decides whether the client has to do some intervention for payment. e.g. SOP
-
zero_value_auto_authorized:
string
The Payment Group is auto authorized without any payment details for zero amount. e.g. true
Nested Schema : billingAddress
Type:
object
Billing address for the order.
Show Source
-
address1:
string
Address line 1 for this billing address.
-
address2:
string
Address line 2 for this billing address.
-
address3:
string
Address line 3 for this billing address.
-
city:
string
City for this billing address.
-
companyName:
string
Company name for this billing address.
-
country:
string
Country for this billing address.
-
county:
string
County for this billing address.
-
email:
string
Email for this billing address.
-
faxNumber:
string
Fax number for this billing address.
-
firstName:
string
First name for this billing address.
-
jobTitle:
string
Job title for this billing address.
-
lastName:
string
Last name for this billing address.
-
middleName:
string
Middle name for this billing address.
-
phoneNumber:
string
Phone number for this billing address.
-
postalCode:
string
Postal code for this billing address.
-
prefix:
string
Prefix for this billing address.
-
selectedCountry:
string
The selected country of the shipping address.
-
selectedState:
string
The selected state of the shipping address.
-
state:
string
State for this billing address.
-
state_ISOCode:
string
The state ISON code of the shipping address.
-
suffix:
string
Suffix for this billing address.
Nested Schema : orderTotalBySite
Type:
object
The map containing order totals by site for all sites in a given order.
Nested Schema : items
Type:
Show Source
object
-
identifier:
string
The pricing message identifier.
-
params:
array params
The list of all message parameters.
-
priority:
integer
The pricing message priority.
-
summary:
string
The pricing message summary.
-
type:
string
The pricing message type.
Nested Schema : items
Type:
Show Source
object
-
tags:
array tags
The tags the promotion upsell message is associated with.
-
text:
string
The promotion upsell message.
Nested Schema : organization
Type:
object
The Organization associated with the B2B customer profile.
Show Source
-
id:
string
The id of the organization.
-
name:
string
The name of of the organization.
Nested Schema : items
Type:
Show Source
object
-
createdDate:
string
The creation date of the return request.
-
returnRequestId:
string
The return request id.
-
state:
string
The status of the return request.
-
stateKey:
string
State key for return request which is not localized
-
totalRefund:
number
The total amount to be refunded on return.
-
totalReturnQuantity:
integer
The total quantity for which return request has been raised.
Nested Schema : items
Type:
Show Source
object
-
items:
array items
Items in the cart.
-
shippingAddress:
object shippingAddress
shipping address for the order.
-
shippingMethod:
object shippingMethod
Shipping method information.
-
trackingInfo:
array trackingInfo
Tracking Information for the Order.
-
trackingNumber:
string
Shipping tracking number.
Nested Schema : shippingAddress
Type:
object
shipping address for the order.
Show Source
-
address1:
string
Address Line 1 for this shipping address.
-
address2:
string
Address Line 2 for this shipping address.
-
address3:
string
Address Line 3 for this shipping address.
-
city:
string
City for this shipping address.
-
companyName:
string
Company name for this shipping address.
-
country:
string
Country for this shipping address.
-
county:
string
County for this shipping address.
-
email:
string
Email for this shipping address.
-
faxNumber:
string
Fax number for this shipping address.
-
firstName:
string
First name for this shipping address.
-
jobTitle:
string
Job title for this shipping address.
-
lastName:
string
Last name for this shipping address.
-
middleName:
string
Middle name for this shipping address.
-
phoneNumber:
string
Phone number for this shipping address.
-
postalCode:
string
Postal code for this shipping address.
-
prefix:
string
Prefix for this shipping address.
-
selectedCountry:
string
The selected country of the shipping address.
-
selectedState:
string
The selected state of the shipping address.
-
state:
string
State for this shipping address.
-
state_ISOCode:
string
The state ISON code of the shipping address.
-
store:
object store
Information about the Store that the items are being picked up from (if shipping group type is inStorePickupShippingGroup)
-
suffix:
string
Suffix for this shipping address.
-
type:
string
The type of shipping group to create, e.g. hardgoodShippingGroup, inStorePickupShippingGroup, inStoreTakeWithShippingGroup, virtualShippingGroup
Nested Schema : shippingMethod
Type:
object
Shipping method information.
Show Source
-
cost:
number
shipping cost.
-
displayName:
string
Display Name of shipment.
-
secondaryCurrencyShippingAmount:
string
shipping amount in secondary currency.
-
secondaryCurrencyTaxAmount:
string
tax amount in secondary currency.
-
value:
string
method type of shipment.
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the item by the configurator system.
-
activationDate:
string
The activation date in ISO format.
-
asset:
boolean
The flag that determines if the current item is an asset or not.
-
assetKey:
string
The assetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
availabilityDate:
string
The Availability date of commerce Item.
-
availablePickupDate:
string
The available date (in ISO format) for collection of items to be picked up in store (if shipping group type is inStorePickupShippingGroup).
-
backOrderQuantity:
number
Back Order Quantity of the Items.
-
billingAccountId:
string
The billing account ID associated to the current item.
-
billingProfileId:
string
The billing profile ID associated to the current item.
-
catRefId:
string
Catalog Reference Id of commerce item.
-
childItems:
array childItems
Child items of the commerce item
-
commerceItemId:
string
commerce item id of the configurable product
-
configuratorId:
string
configurator id of the configurable product
-
customerAccountId:
string
The customer account ID associated to the current item.
-
deactivationDate:
string
The deactivation date in ISO format.
-
discountInfo:
object discountInfo
Discount information.
-
displayName:
string
Display name of commerce item.
-
dynamicProperties:
array dynamicProperties
Array of custom properties at order line item level.
-
externalData:
array externalData
External data to be associated with a commerce item, provided by a configurator system.
-
externalPrice:
number
The Price of the product as per the external pricing system.
-
externalPriceQuantity:
integer
Quantity of the product, the customer is allowed to buy at the external price.
-
imageInfo:
object imageInfo
Shipping method information.
-
locationInventoryInfoMap:
object locationInventoryInfoMap
Additional Properties Allowed: additionalPropertiesThis is a map displaying inventory breakdowns for multiple inventory locations, created when the item is fulfilled by multiple inventories. Each entry in the map is keyed by inventory location id
-
onSale:
boolean
indicates if product is on sale or not.
-
originalCommerceItemId:
boolean
The Commerce Item ID associated with the original item from which item in cancel order is created.
-
parentAssetKey:
string
The parentAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
preferredPickupDate:
string
The preferred date (in ISO format) for the items to be picked up in store (if shipping group type is inStorePickupShippingGroup).
-
preOrderQuantity:
number
Pre Order Quantity of the Items.
-
price:
number
The raw number that represents the price.
-
quantity:
number
Quantity of the items.
-
rawTotalPrice:
number
The raw total price.
-
returnedQuantity:
number
Quantity for which return request has been raised.
-
rootAssetKey:
string
The rootAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
serviceAccountId:
string
The service account ID associated to the current item.
-
serviceId:
string
The service ID associated to the current item.
-
siteId:
string
The ID of the site on which the item was added.
-
status:
integer
State of the commerce item.
-
subTotal:
number
The base price for the item, before any modifications. Calculated by multiplying the quantity by the listPrice.
-
tax:
number
The amount of tax paid for this item.
-
transactionDate:
string
ISO formatted Date on which the service action should be triggered.
-
unitPrice:
number
Sale price or list price of commerceItem.
-
variant:
array variant
Product Variant Information.
Nested Schema : discountInfo
Type:
object
Discount information.
Show Source
-
orderCouponsMap:
object orderCouponsMap
The coupons that were claimed.
-
orderDiscount:
number
Discount given on an order.
-
orderImplicitDiscountList:
array orderImplicitDiscountList
List of discounts.
-
unclaimedCouponsMap:
array unclaimedCouponsMap
Map of unclaimed coupons.
Nested Schema : dynamicProperties
Type:
array
Array of custom properties at order line item level.
Show Source
Nested Schema : externalData
Type:
array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : imageInfo
Type:
object
Shipping method information.
Show Source
-
primaryThumbImageURL:
string
ThumbNail Image URL
Nested Schema : locationInventoryInfoMap
Type:
object
Additional Properties Allowed
Show Source
This is a map displaying inventory breakdowns for multiple inventory locations, created when the item is fulfilled by multiple inventories. Each entry in the map is keyed by inventory location id
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the item by the configurator system.
-
activationDate:
string
The activation date in ISO format.
-
addOnItem:
boolean
Whether the sub commerce item is an add-on (internally configured) or not (externally configured).
-
asset:
boolean
The flag that determines if the current item is an asset or not.
-
assetKey:
string
The assetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
billingAccountId:
string
The billing account ID associated to the current item.
-
billingProfileId:
string
The billing profile ID associated to the current item.
-
catRefId:
string
Sku Id of the child item
-
childItems:
array childItems
Child items of the commerce item
-
commerceItemId:
string
commerce item id of the child item
-
configurablePropertyId:
string
ID of the catalog's configurableProperty associated with this sub commerce item.
-
configurationOptionId:
string
ID of the catalog's configurationOption associated with this sub commerce item.
-
customerAccountId:
string
The customer account ID associated to the current item.
-
deactivationDate:
string
The deactivation date in ISO format.
-
displayName:
string
Display name of the child product
-
externalData:
array externalData
External data to be associated with a commerce item, provided by a configurator system.
-
parentAssetKey:
string
The parentAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
productId:
string
Product Id of the child item
-
quantity:
number
Quantity of the child item
-
rootAssetKey:
string
The rootAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
route:
string
Image route
-
selectedOptions:
array selectedOptions
The array of variants of the child item.
-
serviceAccountId:
string
The service account ID associated to the current item.
-
serviceId:
string
The service ID associated to the current item.
-
shopperInput:
object shopperInput
Additional Properties Allowed: additionalPropertiesMap of shopper input keys to values
-
siteId:
string
The ID of the site on which the item was added.
-
transactionDate:
string
ISO formatted Date on which the service action should be triggered.
Nested Schema : externalData
Type:
array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : shopperInput
Type:
object
Additional Properties Allowed
Show Source
Map of shopper input keys to values
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the item by the configurator system.
-
activationDate:
string
The activation date in ISO format.
-
asset:
boolean
The flag that determines if the current item is an asset or not.
-
assetKey:
string
The assetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
billingAccountId:
string
The billing account ID associated to the current item.
-
billingProfileId:
string
The billing profile ID associated to the current item.
-
catRefId:
string
Sku Id of the child item
-
customerAccountId:
string
The customer account ID associated to the current item.
-
deactivationDate:
string
The deactivation date in ISO format.
-
displayName:
string
Display name of the child product
-
externalData:
array externalData
External data to be associated with a commerce item, provided by a configurator system.
-
parentAssetKey:
string
The parentAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
productId:
string
Product Id of the child item
-
quantity:
number
Quantity of the child item
-
rootAssetKey:
string
The rootAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
route:
string
Image route
-
selectedOptions:
array selectedOptions
The array of variants of the child item.
-
serviceAccountId:
string
The service account ID associated to the current item.
-
serviceId:
string
The service ID associated to the current item.
-
siteId:
string
The ID of the site on which the item was added.
-
transactionDate:
string
ISO formatted Date on which the service action should be triggered.
Nested Schema : externalData
Type:
array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the externalData item by the configurator system.
-
name:
string
The name to be associated with the externalData item.
-
values:
object values
The array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
Show Source
-
dynamic_property_key:
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
Show Source
object
-
optionName:
string
The varian option name.
-
optionValue:
string
The variant option value
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the externalData item by the configurator system.
-
name:
string
The name to be associated with the externalData item.
-
values:
object values
The array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
Show Source
-
dynamic_property_key:
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
Show Source
object
-
optionName:
string
The varian option name.
-
optionValue:
string
The variant option value
Nested Schema : orderCouponsMap
Type:
object
The coupons that were claimed.
Show Source
-
couponCode:
object couponCode
Coupon Code.
Nested Schema : couponCode
Type:
object
Coupon Code.
Show Source
-
external:
boolean
States whether this promotion was applied by an external system (only present on external promotions).
-
promotionDesc:
string
Description of the promotion. Retained for backward compatibility.
-
promotionId:
string
The Id of the promotion.
-
promotionLevel:
string
The promotion level.
-
promotionLongDesc:
string
The description of the promotion.
-
promotionName:
string
The display name of the promotion.
-
totalAdjustment:
number
Total adjustment caused by the promotion.
Nested Schema : items
Type:
Show Source
object
-
promotionDesc:
string
Description of the promotion.
-
promotionId:
string
Id of the promotion.
-
promotionLevel:
string
The promotion level.
-
totalAdjustment:
string
Total adjustment caused by the promotion.
Nested Schema : items
Type:
Show Source
object
-
couponInfo:
array couponInfo
The coupon Info.
-
promotionValue:
string
The value for promotion.
Nested Schema : items
Type:
Show Source
object
-
promotionDesc:
string
Description of the promotion.
-
promotionId:
string
Id of the promotion.
-
promotionLevel:
string
The promotion level.
-
totalAdjustment:
string
Total adjustment caused by the promotion.
Nested Schema : items
Type:
Show Source
object
-
id:
string
The ID of the dynamic property.
-
label:
string
The label of the dynamic property.
-
value:
string
The value of the dynamic property.
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the externalData item by the configurator system.
-
name:
string
The name to be associated with the externalData item.
-
values:
object values
The array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
Show Source
-
dynamic_property_key:
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : additionalProperties
Type:
Show Source
object
-
availabilityDate:
string
The availabilityDate for preordered/backordered quantity, for this inventory location
-
backOrderQuantity:
integer
The backordered quantity included, for this inventory location
-
inStockQuantity:
integer
The available quantity included that is 'in stock', for this inventory location
-
preOrderQuantity:
integer
The preordered quantity included, for this inventory location
Nested Schema : items
Type:
Show Source
object
-
optionName:
string
Name of the Dynamic attribute.
-
optionValue:
string
Value of the Dynamic attribute.
Nested Schema : store
Type:
object
Information about the Store that the items are being picked up from (if shipping group type is inStorePickupShippingGroup)
Show Source
-
address1:
string
Address line 1 of the store.
-
address2:
string
Address line 2 of the store.
-
address3:
string
Address line 3 of the store.
-
city:
string
The city in which the store resides.
-
country:
string
The country in which the store resides.
-
county:
string
The county in which the store resides.
-
email:
string
The email address of the store.
-
faxNumber:
string
The fax number of the store.
-
hours:
string
The opening hours of the store.
-
locationId:
string
The location id of the store.
-
name:
string
Name of the store.
-
phoneNumber:
string
The phone number of the store.
-
postalCode:
string
The postal code of the store.
-
stateAddress:
string
The state in which the store resides.
Nested Schema : items
Type:
Show Source
object
-
carrierId:
string
Carrier Id for Tracking.
-
carrierName:
string
Carrier Name for Tracking.
-
carrierUrl:
string
Carrier URL for Tracking.
-
trackingNumber:
string
Tracking Number.
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the item by the configurator system.
-
availabilityDate:
string
The Availability date of commerce Item.
-
backOrderQuantity:
number
Back Order Quantity of the Items.
-
catRefId:
string
catRefId of the product.
-
childItems:
array childItems
Child items of the commerce item
-
commerceItemId:
string
commerce item id of the configurable product
-
configuratorId:
string
configurator id of the configurable product
-
discountInfo:
object discountInfo
Discount information.
-
dynamicProperties:
array dynamicProperties
Array of custom properties at order line item level.
-
externalData:
array externalData
External data to be associated with a commerce item, provided by a configurator system.
-
externalPrice:
number
The Price of the product as per the external pricing system.
-
externalPriceQuantity:
integer
Quantity of the product, the customer is allowed to buy at the external price.
-
giftWithPurchaseCommerceItemMarkers:
array giftWithPurchaseCommerceItemMarkers
The array of giftWithPurchaseCommerceItemMarkers.
-
isPriceOverridden:
boolean
Indicates if commerce item price is overridden or not.
-
locationInventoryInfoMap:
object locationInventoryInfoMap
Additional Properties Allowed: additionalPropertiesThis is a map displaying inventory breakdowns for multiple inventory locations, created when the item is fulfilled by multiple inventories. Each entry in the map is keyed by inventory location id
-
onSale:
boolean
indicates if product is on sale or not.
-
originalCommerceItemId:
string
The Commerce Item ID associated with the original item from which item in cancel order is created.
-
overriddenPrice:
number
overridden price of commerce item.
-
pointOfNoRevision:
boolean
Point beyond which cancelling the commerce item would be restricted
-
preOrderQuantity:
number
Pre Order Quantity of the Items.
-
price:
number
price of the product.
-
priceOverridenBy:
string
Name of the agent who has overridden item price.
-
priceOverrideReason:
object priceOverrideReason
Price override reason map
-
productId:
string
Id of the product.
-
quantity:
integer
quantity of the product.
-
shopperInput:
object shopperInput
Additional Properties Allowed: additionalPropertiesMap of shopper input keys to values
-
state:
string
State at the commerceItem level
-
unitPrice:
number
unit price of the product.
Nested Schema : discountInfo
Type:
object
Discount information.
Show Source
-
gwpSelections:
array gwpSelections
The gift information.
-
orderCouponsMap:
object orderCouponsMap
The coupons that were claimed.
-
orderDiscount:
number
Discount given on an order.
-
orderImplicitDiscountList:
array orderImplicitDiscountList
List of discounts.
-
unclaimedCouponsMap:
array unclaimedCouponsMap
Map of unclaimed coupons.
Nested Schema : dynamicProperties
Type:
array
Array of custom properties at order line item level.
Show Source
Nested Schema : externalData
Type:
array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : giftWithPurchaseCommerceItemMarkers
Type:
array
The array of giftWithPurchaseCommerceItemMarkers.
Show Source
Nested Schema : locationInventoryInfoMap
Type:
object
Additional Properties Allowed
Show Source
This is a map displaying inventory breakdowns for multiple inventory locations, created when the item is fulfilled by multiple inventories. Each entry in the map is keyed by inventory location id
Nested Schema : priceOverrideReason
Type:
object
Price override reason map
Show Source
-
displayValue:
string
price override reason value
-
key:
string
price override reason key
Nested Schema : shopperInput
Type:
object
Additional Properties Allowed
Show Source
Map of shopper input keys to values
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the item by the configurator system.
-
activationDate:
string
The activation date in ISO format.
-
asset:
boolean
The flag that determines if the current item is an asset or not.
-
assetKey:
string
The assetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
billingAccountId:
string
The billing account ID associated to the current item.
-
billingProfileId:
string
The billing profile ID associated to the current item.
-
catRefId:
string
Sku Id of the child item
-
childItems:
array childItems
Child items of the commerce item
-
customerAccountId:
string
The customer account ID associated to the current item.
-
deactivationDate:
string
The deactivation date in ISO format.
-
displayName:
string
Display name of the child product
-
externalData:
array externalData
External data to be associated with a commerce item, provided by a configurator system.
-
parentAssetKey:
string
The parentAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
productId:
string
Product Id of the child item
-
quantity:
number
Quantity of the child item
-
rootAssetKey:
string
The rootAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
route:
string
Image route
-
selectedOptions:
array selectedOptions
The array of variants of the child item.
-
serviceAccountId:
string
The service account ID associated to the current item.
-
serviceId:
string
The service ID associated to the current item.
-
transactionDate:
string
ISO formatted Date on which the service action should be triggered.
Nested Schema : externalData
Type:
array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the item by the configurator system.
-
activationDate:
string
The activation date in ISO format.
-
addOnItem:
boolean
Whether the sub commerce item is an add-on (internally configured) or not (externally configured).
-
asset:
boolean
The flag that determines if the current item is an asset or not.
-
assetKey:
string
The assetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
billingAccountId:
string
The billing account ID associated to the current item.
-
billingProfileId:
string
The billing profile ID associated to the current item.
-
catRefId:
string
Sku Id of the child item
-
commerceItemId:
string
commerce item id of the child item
-
configurablePropertyId:
string
ID of the catalog's configurableProperty associated with this sub commerce item.
-
configurationOptionId:
string
ID of the catalog's configurationOption associated with this sub commerce item.
-
customerAccountId:
string
The customer account ID associated to the current item.
-
deactivationDate:
string
The deactivation date in ISO format.
-
displayName:
string
Display name of the child product
-
externalData:
array externalData
External data to be associated with a commerce item, provided by a configurator system.
-
parentAssetKey:
string
The parentAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
productId:
string
Product Id of the child item
-
quantity:
number
Quantity of the child item
-
rootAssetKey:
string
The rootAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
route:
string
Image route
-
selectedOptions:
array selectedOptions
The array of variants of the child item.
-
serviceAccountId:
string
The service account ID associated to the current item.
-
serviceId:
string
The service ID associated to the current item.
-
shopperInput:
object shopperInput
Additional Properties Allowed: additionalPropertiesMap of shopper input keys to values
-
transactionDate:
string
ISO formatted Date on which the service action should be triggered.
Nested Schema : externalData
Type:
array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : shopperInput
Type:
object
Additional Properties Allowed
Show Source
Map of shopper input keys to values
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the externalData item by the configurator system.
-
name:
string
The name to be associated with the externalData item.
-
values:
object values
The array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
Show Source
-
dynamic_property_key:
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
Show Source
object
-
optionName:
string
The varian option name.
-
optionValue:
string
The variant option value
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the externalData item by the configurator system.
-
name:
string
The name to be associated with the externalData item.
-
values:
object values
The array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
Show Source
-
dynamic_property_key:
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
Show Source
object
-
optionName:
string
The varian option name.
-
optionValue:
string
The variant option value
Nested Schema : orderCouponsMap
Type:
object
The coupons that were claimed.
Show Source
-
couponCode:
object couponCode
Coupon Code.
Nested Schema : items
Type:
Show Source
object
-
giftChoicesAvailable:
boolean
Boolean to show if there are any gift choices for selection.
-
giftHashCode:
integer
The gift hash code for this GWP promotion.
-
giftQuantity:
number
The quantity that is gift quantity
Nested Schema : couponCode
Type:
object
Coupon Code.
Show Source
-
external:
boolean
States whether this promotion was applied by an external system (only present on external promotions).
-
promotionDesc:
string
Description of the promotion. Retained for backward compatibility.
-
promotionId:
string
The Id of the promotion.
-
promotionLevel:
string
The promotion level.
-
promotionLongDesc:
string
The description of the promotion.
-
promotionName:
string
The display name of the promotion.
-
totalAdjustment:
number
Total adjustment caused by the promotion.
Nested Schema : items
Type:
Show Source
object
-
promotionDesc:
string
Description of the promotion.
-
promotionId:
string
Id of the promotion.
-
promotionLevel:
string
The promotion level.
-
totalAdjustment:
string
Total adjustment caused by the promotion.
Nested Schema : items
Type:
Show Source
object
-
couponInfo:
array couponInfo
The coupon Info.
-
promotionValue:
string
The value for promotion.
Nested Schema : items
Type:
Show Source
object
-
promotionDesc:
string
Description of the promotion.
-
promotionId:
string
Id of the promotion.
-
promotionLevel:
string
The promotion level.
-
totalAdjustment:
string
Total adjustment caused by the promotion.
Nested Schema : items
Type:
Show Source
object
-
id:
string
The ID of the dynamic property.
-
label:
string
The label of the dynamic property.
-
value:
string
The value of the dynamic property.
Nested Schema : items
Type:
Show Source
object
-
actionCode:
string
The action code that has been set on the externalData item by the configurator system.
-
activationDate:
string
The activation date in ISO format.
-
asset:
boolean
The flag that determines if the current item is an asset or not.
-
assetKey:
string
The assetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
billingAccountId:
string
The billing account ID associated to the current item.
-
billingProfileId:
string
The billing profile ID associated to the current item.
-
customerAccountId:
string
The customer account ID associated to the current item.
-
deactivationDate:
string
The deactivation date in ISO format.
-
name:
string
The name to be associated with the externalData item.
-
parentAssetKey:
string
The parentAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
rootAssetKey:
string
The rootAssetKey is only assigned when the root item has been set as assetable in the catalog and has been configured.
-
serviceAccountId:
string
The service account ID associated to the current item.
-
serviceId:
string
The service ID associated to the current item.
-
transactionDate:
string
ISO formatted Date on which the service action should be triggered.
-
values:
object values
The array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
Show Source
-
dynamic_property_key:
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
Show Source
object
-
automaticQuantity:
number
The quantity of the free gift that this commerce item is making free and was auto added by pricing.
-
data:
integer
The gift hash code for this GWP promotion.
-
key:
string
atg.gwp
-
remainingQuantity:
number
The quantity of the commerce item that is not affected by GWP.
-
selectedQuantity:
number
The quantity of the free gift that this commerce item is making free and was selected by the shopper.
-
targetedQuantity:
number
The quantity of the free gift that this commerce item is making free and was targeted by pricing.
-
value:
string
The GWP promotion id.
Nested Schema : additionalProperties
Type:
Show Source
object
-
availabilityDate:
string
The availabilityDate for preordered/backordered quantity, for this inventory location
-
backOrderQuantity:
integer
The backordered quantity included, for this inventory location
-
inStockQuantity:
integer
The available quantity included that is 'in stock', for this inventory location
-
preOrderQuantity:
integer
The preordered quantity included, for this inventory location
Example Response (application/json)
{
"shippingGroups":[
{
"taxPriceInfo":{
"cityTax":"6.5",
"amount":"18.56",
"valueAddedTax":"0",
"countyTax":"4.640000000000001",
"isTaxIncluded":false,
"miscTax":"0",
"districtTax":"0",
"stateTax":"7.42",
"countryTax":"0"
},
"shippingMethod":{
"shippingTax":"0.65",
"cost":"6.5",
"externalId":"ext001",
"value":"ground",
"shippingMethodDescription":"Ground"
},
"shippingGroupId":"sg10021",
"submittedDate":null,
"priceInfo":{
"amount":"179",
"total":"204.06",
"shipping":"6.5",
"shippingSurchargeValue":"0",
"tax":"18.56",
"subTotal":"179",
"currencyCode":"USD",
"totalWithoutTax":"185.5"
},
"recurringChargePriceInfo":{
"discounted":false,
"amount":"30",
"total":"32.4",
"shipping":"0",
"subTotalByFrequency":[
{
"amount":"30",
"frequency":"Monthly"
}
],
"taxByFrequency":[
{
"amount":"2.4",
"frequency":"Monthly"
}
],
"manualAdjustmentTotal":"0",
"amountIsFinal":false,
"discountAmount":"0",
"tax":"2.4",
"rawSubtotal":"30",
"currencyCode":"USD"
},
"discountInfo":{
"orderDiscount":"0",
"shippingDiscount":"0",
"discountDescList":[
]
},
"shipOnDate":null,
"trackingInfo":[
],
"actualShipDate":null,
"shippingAddress":{
"lastName":"Test",
"country":"US",
"address3":"",
"address2":"Line 2",
"city":"Montgomery",
"address1":"Line 1",
"prefix":"",
"companyName":"",
"postalCode":"36123",
"jobTitle":"",
"county":"",
"suffix":"",
"firstName":"Steve",
"phoneNumber":"45454545",
"alias":"Address",
"faxNumber":"",
"middleName":"",
"state":"AL",
"email":"steve.test@example.com"
},
"trackingNumber":null,
"items":[
{
"dynamicProperties":[
{
"id":"dynamicPropertyMode",
"label":"Mode",
"value":"pickup"
}
],
"discountAmount":"0",
"billingProfileId":"billingProfile-123",
"billingAccountId":"billingAcc-123",
"preOrderQuantity":"0",
"assetKey":"12345",
"price":"179",
"variant":[
{
"optionValue":"Red",
"optionName":"color"
},
{
"optionValue":"Large",
"optionName":"size"
}
],
"primaryImageAltText":"Antique Wood Chair",
"actionCode":"Add",
"stateDetailsAsUser":"The item has been initialized within the shipping group",
"unitPrice":"179",
"pointOfNoRevision":false,
"productId":"xprod2105",
"parentAssetKey":null,
"active":true,
"catRefId":"xsku2105",
"customerAccountId":"customerAcc-123",
"discountInfo":[
],
"route":"/antique-wood-chair/product/xprod2105",
"activationDate":"2017-06-27T15:30:00Z",
"backOrderQuantity":"0",
"recurringCharge":"10",
"status":"INITIAL",
"primaryThumbImageURL":"/ccstore/v1/images/?source=/file/v2/products/ST_AntiqueWoodChair_full.jpg&height=100&width=100",
"deactivationDate":"2018-06-27T12:59:59Z",
"rawTotalPrice":"179",
"returnedQuantity":"0",
"displayName":"Antique Wood Chair",
"shippingSurchargeValue":"0",
"externalData":[
],
"commerceItemId":"ci3000411",
"onSale":false,
"serviceId":"service-123",
"serviceAccountId":"serviceAcc-123",
"primaryImageTitle":"Antique Wood Chair",
"quantity":"1",
"relationshipType":"SHIPPINGQUANTITY",
"salePrice":"0",
"detailedItemPriceInfo":[
{
"discounted":false,
"amount":"179",
"quantity":"1",
"tax":"17.91",
"orderDiscountShare":"0",
"detailedUnitPrice":"179",
"currencyCode":"USD"
}
],
"externalRecurringCharge":"10",
"rootAssetKey":null,
"externalRecurringChargeFrequency":"Monthly",
"transactionDate":"2018-06-27T12:59:59Z",
"externalRecurringChargeDuration":"12",
"skuProperties":[
{
"propertyType":"sku-base",
"name":"UPC Code",
"id":"upcCode",
"value":"123456"
}
],
"detailedRecurringChargeInfo":[
{
"discounted":false,
"amount":"10",
"quantity":"1",
"tax":"0",
"orderDiscountShare":"0",
"detailedUnitPrice":"10",
"currencyCode":"USD"
}
],
"asset":false,
"listPrice":"179"
}
],
"email":"a@example.com",
"status":"INITIAL"
}
],
"creationTime":"1411984170268",
"sourceSystem":"Cloud Commerce",
"dynamicProperties":[
{
"id":"dynamicPropertyShippingInstructions",
"label":"Shipping Instructions",
"value":"Test Instructions"
}
],
"approvalSystemMessages":[
"Order is pending approval because total is greater than the approved order limit."
],
"shippingMethod":{
"cost":"6.5",
"value":"ground"
},
"payments":[
{
"paymentGroupId":"pg70441",
"amount":"100",
"customPaymentProperties":{
"EMIS":"12",
"MontlyCharge":"$100"
},
"balance":null,
"gatewayName":"chaseGiftCard",
"giftCardNumber":null,
"uiIntervention":null,
"paymentMethod":"physicalGiftCard",
"isAmountRemaining":false,
"paymentState":"AUTHORIZED",
"maskedCardNumber":"xxxxxxxxxxxxxxx1071"
},
{
"paymentGroupId":"pg70442",
"amount":"158.5",
"customPaymentProperties":{
"EMIS":"12",
"MontlyCharge":"$100"
},
"gatewayName":"chaseCreditCard",
"uiIntervention":null,
"paymentMethod":"creditCard",
"isAmountRemaining":true,
"paymentState":"AUTHORIZED"
}
],
"priceListGroup":{
"repositoryId":"UsDollar"
},
"cartName":"Test Name",
"creationDate":"2014-01-01T00:30:00.000Z",
"uuid":"05a89e3c-346b-4d50-a55d-91316a50b152",
"orderAction":"order",
"priceInfo":{
"amount":"179",
"total":"204.06",
"shipping":"6.5",
"shippingSurchargeValue":"0",
"tax":"18.56",
"subTotal":"179",
"currencyCode":"USD"
},
"recurringChargePriceInfo":{
"amount":"30",
"total":"32.4",
"shipping":"0",
"subTotalByFrequency":[
{
"amount":"30",
"frequency":"Monthly"
}
],
"taxByFrequency":[
{
"amount":"2.4",
"frequency":"Monthly"
}
],
"tax":"2.4",
"subTotal":"30",
"currencyCode":"USD",
"totalWithoutTax":"30"
},
"discountInfo":{
"orderDiscount":"0",
"orderDiscountDescList":[
{
"promotionLevel":"item",
"coupon":"FREETATTOO",
"totalAdjustment":"-21.99",
"promotionDesc":"Explicit Item Discount - FREETATTOO",
"promotionId":"explicitItemFreeDiscount"
}
],
"shippingDiscount":"0"
},
"pricingMessages":{
"giftWithPurchaseMessages":[
{
"summary":"The cart has qualified for a free gift promotion.",
"identifier":"GWPQualified",
"params":[
],
"type":"information",
"priority":"-10"
}
]
},
"trackingInfo":[
],
"shoppingCart":{
"items":[
{
"deactivationDate":"2018-06-27T12:59:59Z",
"dynamicProperties":[
{
"id":"dynamicPropertyMode",
"label":"Mode",
"value":"pickup"
}
],
"externalData":[
],
"billingProfileId":"billingProfile-123",
"billingAccountId":"billingAcc-123",
"assetKey":"12345",
"itemDiscountInfos":[
{
"couponCodes":[
"TestCouponCode"
],
"amount":"10",
"promotionId":"promo10001"
}
],
"externalPrice":"175",
"commerceItemId":"ci3000411",
"price":"179",
"variant":[
{
"optionValue":"Red",
"optionName":"color"
},
{
"optionValue":"Large",
"optionName":"size"
}
],
"actionCode":"Add",
"serviceId":"service-123",
"unitPrice":"179",
"serviceAccountId":"serviceAcc-123",
"quantity":"1",
"productId":"xprod2105",
"externalRecurringCharge":"10",
"orderDiscountInfos":[
{
"couponCodes":[
],
"amount":"29.9",
"promotionId":"orderDiscount"
},
{
"couponCodes":[
"coupon101"
],
"amount":"5",
"promotionId":"promo10001"
}
],
"parentAssetKey":null,
"originalCommerceItemId":null,
"rootAssetKey":null,
"externalPriceQuantity":"1",
"externalRecurringChargeFrequency":"Monthly",
"transactionDate":"2018-06-27T12:59:59Z",
"catRefId":"xsku2105",
"externalRecurringChargeDuration":"12",
"skuProperties":[
{
"propertyType":"sku-base",
"name":"UPC Code",
"id":"upcCode",
"value":"123456"
}
],
"customerAccountId":"customerAcc-123",
"discountInfo":[
],
"detailedRecurringChargeInfo":[
{
"discounted":false,
"amount":"10",
"quantity":"1",
"tax":"0",
"orderDiscountShare":"0",
"detailedUnitPrice":"10",
"currencyCode":"USD"
}
],
"shopperInput":{
"color":"neon",
"initials":"M.C.K",
"font":"courier"
},
"activationDate":"2017-06-27T15:30:00Z",
"asset":false,
"recurringCharge":"10"
}
]
},
"shippingAddress":{
"lastName":"Test",
"country":"US",
"address3":"",
"address2":"Line 2",
"city":"Montgomery",
"address1":"Line 1",
"prefix":"",
"companyName":"",
"postalCode":"36130",
"jobTitle":"",
"county":"",
"suffix":"",
"firstName":"Steve",
"phoneNumber":"45454545",
"faxNumber":"",
"alias":"",
"middleName":"",
"state":"AL",
"email":"steve.test@example.com"
},
"id":"o10018",
"billingAddress":{
"lastName":"Test",
"country":"US",
"address3":"",
"address2":"Line 2",
"city":"Montgomery",
"address1":"Line 1",
"prefix":"",
"companyName":"",
"postalCode":"36130",
"jobTitle":"",
"county":"",
"suffix":"",
"firstName":"Steve",
"phoneNumber":"45454545",
"faxNumber":"",
"alias":"",
"middleName":"",
"state":"AL",
"email":"steve.test@example.com"
},
"quoteInfo":{
"providerNote":null,
"notes":[
{
"profileType":null,
"profileId":"120213",
"requestDate":"1477479521002",
"requesterNote":"This is a sample quote"
}
],
"rejectionDate":null,
"requestDate":"2016-10-26T10:58:41.002Z",
"errorInfo":null,
"externalID":null,
"quoteSubmitted":false,
"rejectionNote":null,
"quoteDate":null,
"expirationDate":null
},
"markers":[
{
"repositoryId":"mark100001",
"value":"78900",
"key":"campaign_eloqua"
}
]
}
Default Response
In case of any failure in external tax or external shipping webhooks, the errors returned in the webhook response payload get added to the errors property in this endpoint???s error response. The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud:
The error response:
Error Code | Description | Possible Fix |
---|---|---|
51006 | The location used does not support in-store pickup | Enter a location that this store supports in-store pickup |
28102 | Product/Sku not found | The product ID you are using may be a typo or that product may not exist in the store |
28129 | The sku ID was not found for the product ID provided | Enter a valid sku ID that relates to the product ID queried |
25137 | An error occurred during inventory check for a configurable item | The quantity ordered is greater than the stock available. Reduce quantity to order. |
71006 | JSON Syntax error | Ensure the JSON syntax is correct. Look for correct closing braces or missing commas etc. |
28411 | Shopper input does not belong to sku specified | Ensure the shopper input is correct for the specified sku ID e.g. ensure color is applicable to the specified sku ID. | 51000 | An error has occured during the invocation of the web hook and the external pricing system. | A possible fix would be to check the webhook is configured correctly in Admin | 28089 | The request payload does not contain any shipping information. It must contain shipping information | Add shipping information to the payload | 28087 | No shipping method specified | Add a shipping method to the payload |
The error response:
Root Schema : errorModel
Type:
Show Source
object
-
devMessage:
string
An optional non-localized message containing technical information for developers
-
errorCode:
string
The numerical code identifying the error
-
errors:
array errors
An optional list of errors if multiple errors were encountered
-
message:
string
The localized message describing the error
-
moreInfo:
string
An optional non-localized message with more information
-
o:errorPath:
string
An optional machine readable description of where the error occurred
-
status:
string
The HTTP status code
-
type:
string
The URI to the HTTP state code definition
Nested Schema : errors
Type:
array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type:
Show Source
object
-
devMessage:
string
An optional non-localized message containing technical information for developers
-
errorCode:
string
The numerical code identifying the error
-
message:
string
The localized message describing the error
-
moreInfo:
string
An optional non-localized message with more information
-
o:errorPath:
string
An optional machine readable description of where the error occurred
-
status:
string
The HTTP status code