createOrder
post
/ccagent/v1/orders
Create Order. It can createOrder/priceOrder/preAuthorizeOrder/submitOrder/resendOrdersForFulfillment order for a customer based on operations. Operations can be any of createOrder, priceOrder, preAuthorizeOrder, submitOrder. Dynamic Properties of order 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. Storefront also has an endopint with same id ('createOrder'), but the behaviour is different. For more informaiton refer Storefront API. This takes additonal header paramater x-ccsite to create the order in specific site. If the header information is not provided order is created on default site. Optionally takes X-CCOrganization header which is a JSON field with organization ID as value. If this header is not provided, then the endPoint will consider first active organization as the current organization for a B2B user.
Request
Supported Media Types
- application/json
Header Parameters
- X-CCOrganization
-
Type:
string
the organization Id in which order should be created- x-ccsite
Type:string
the site id on which the orders needs to be placed
Body Parameter
Root Schema : createOrder_request
{
"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":[
{
"serviceAccountId":"serviceAcc-123",
"deactivationDate":"2018-06-27T12:59:59Z",
"quantity":1,
"productId":"Product_18Cyii",
"currentPrice":0,
"billingAccountId":"billingAcc-123",
"childItems":[
{
"serviceAccountId":"serviceAcc-123",
"deactivationDate":"2018-06-27T12:59:59Z",
"quantity":"1",
"productId":"prod40001",
"displayName":"Laptop Parts 1",
"externalData":[
],
"currentPrice":0,
"billingAccountId":"billingAcc-123",
"childItems":[
{
"serviceAccountId":"serviceAcc-123",
"deactivationDate":"2018-06-27T12:59:59Z",
"quantity":"1",
"productId":"prod40001",
"displayName":"Laptop Parts 1",
"externalData":[
],
"currentPrice":0,
"billingAccountId":"billingAcc-123",
"catRefId":"sku40009",
"priceListGroupId":"defaultPriceGroup",
"customerAccountId":"customerAcc-123",
"assetId":"asset10001",
"invalid":false,
"stockStatus":true,
"actionCode":"Add",
"activationDate":"2017-06-27T15:30:00Z",
"serviceId":"service-123"
}
],
"catRefId":"sku40001",
"priceListGroupId":"defaultPriceGroup",
"customerAccountId":"customerAcc-123",
"assetId":"asset10001",
"invalid":false,
"stockStatus":true,
"actionCode":"Add",
"activationDate":"2017-06-27T15:30:00Z",
"serviceId":"service-123"
}
],
"externalPriceQuantity":-1,
"catRefId":"Sku_18Dxy",
"configuratorId":"12343455",
"externalPrice":"722.0",
"customerAccountId":"customerAcc-123",
"assetId":"asset10001",
"stockStatus":true,
"onSale":true,
"actionCode":"Add",
"activationDate":"2017-06-27T15:30:00Z",
"serviceId":"service-123"
}
]
},
"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"
}
- amountRemaining
-
Type:
string
amount to authorize. - billingAddress
-
Type:
object
billingAddressBilling address for the order - combineLineItems
-
Type:
string
Value to determine if line items are to be combined. Can be yes or no. Related Endpoint operations - createOrder, priceOrder, submitOrder - op
-
Type:
string
Required:true
operation to be performed. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder, resendOrdersForFulfillment. - orderId
-
Type:
string
Commerce id for this order. Related Endpoint operations - priceOrder, submitOrder, preAuthorizeOrder - orders
-
Type:
array
ordersOrders to be resubmitted. Related Endpoint operations - resendOrdersForFulfillment - payments
-
Type:
object
paymentsList of payments - profileId
-
Type:
string
Required:true
profile id. Related Endpoint operations - createOrder, priceOrder, submitOrder - requestChannel
-
Type:
string
request Channel name. Possible values are 'agent' or 'asa'. Related Endpoint operations - createOrder, priceOrder, submitOrder - schedule
-
Type:
object
scheduleThe details of the schedule order. Related Endpoint operations - createOrder - scheduleOnly
-
Type:
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 - shippingAddress
-
Type:
object
shippingAddressRequired:true
Shipping address. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder - shippingGroups
-
Type:
array
shippingGroupsShipping Groups. Related Endpoint operations - createOrder, priceOrder, submitOrder - shippingMethod
-
Type:
object
shippingMethodRequired:true
shipping method. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder - shoppingCart
-
Type:
object
shoppingCartRequired:true
Shopping cart information. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder
Nested Schema : billingAddress
Type:
object
Billing address for the order
- address1
-
Type:
string
Required:true
Address line 1 for this billing address. - address2
-
Type:
string
Address line 2 for this billing address. - address3
-
Type:
string
Address line 3 for this billing address. - alias
-
Type:
string
Nickname or alternate name for address like home/office. - city
-
Type:
string
Required:true
City for this billing address. - companyName
-
Type:
string
Company name for this billing address. - country
-
Type:
string
Country for this billing address. -
Type:
string
Email for this billing address. - faxNumber
-
Type:
string
Fax Number for this billing address. - firstName
-
Type:
string
Required:true
First Name for this billing address. - isDefaultAddress
-
Type:
boolean
Default value of the address. - jobTitle
-
Type:
string
JOb Title for this billing address. - lastName
-
Type:
string
Required:true
Last Name for this billing address. - middleName
-
Type:
string
Middle Name for this billing address. - phoneNumber
-
Type:
string
Phone Number for this billing address. - postalCode
-
Type:
string
Required:true
Postal code for this billing address. - prefix
-
Type:
string
Prefix for this billing address. - repositoryId
-
Type:
string
Repository Id of the address. - selectedCountry
-
Type:
string
Required:true
The selected country of the shipping address. - selectedState
-
Type:
string
Required:true
The selected state of the shipping address. - state
-
Type:
string
State for this billing address. - state_ISOCode
-
Type:
string
The state ISON code of the shipping address. - suffix
-
Type:
string
suffix for this billing address.
Nested Schema : orders
Type:
array
Orders to be resubmitted. Related Endpoint operations - resendOrdersForFulfillment
-
Type:
string
Nested Schema : payments
Type:
object
List of payments
- amount
-
Type:
number
Amount to be authorized from the gift card. Payment type:card, physicalGiftCard, paypalCheckout, payUWebLatamCheckout. - cardCVV
-
Type:
string
Credit card CVV. - cardNumber
-
Type:
string
Credit card Number - cardType
-
Type:
string
Credit card type. - endMonth
-
Type:
string
Credit card expiry month - endYear
-
Type:
integer
Credit card expiry year. - giftCardNumber
-
Type:
string
Gift card number used for payment. Payment type: physicalGiftCard(this field should be used when giftcards are used). - giftCardPin
-
Type:
string
Gift card pin. Payment type: physicalGiftCard(this field should be used when giftcards are used). - nameOnCard
-
Type:
string
Name printed on credit card. - paymentGroupId
-
Type:
string
Payment Group Id of the gift card payment group. Payment type: physicalGiftCard - PONumber
-
Type:
string
Purchase order number for invoice payment. Payment type: invoice - seqNum
-
Type:
string
Sequence Number of the payment. In multiple paymnets, there are can be any number of payments. - type
-
Type:
string
payment type. payULatamWebcheckout,paypalCheckout,card,invoice,physicalGiftCard.
Nested Schema : schedule
Type:
object
The details of the schedule order. Related Endpoint operations - createOrder
- endDate
-
Type:
string
Scheduled order end date. - name
-
Type:
string
Name of the Scheduled Order. - schedule
-
Type:
object
scheduleRequired:true
The schedule of the scheduled order - startDate
-
Type:
string
Required:true
Scheduled Order start date. - state
-
Type:
string
The state of the scheduled order.
Nested Schema : shippingAddress
Type:
object
Shipping address. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder
- address1
-
Type:
string
Required:true
The address1 of the shipping address. - address2
-
Type:
string
Required:true
The address2 of the shipping address. - address3
-
Type:
string
The address3 of the shipping address. - city
-
Type:
string
Required:true
The city of the shipping address. - companyName
-
Type:
string
The companyName. - country
-
Type:
string
Required:true
The country of the shipping address. - county
-
Type:
string
The county of the shipping address. - DEFAULT_POSTAL_CODE_PATTERN
-
Type:
string
The default post code pattern of the shipping address. -
Type:
string
Required:true
email of the shipping address. - faxNumber
-
Type:
string
The faxNumber of the shipping address. - firstName
-
Type:
string
Required:true
The first name of the shipping address. - jobTitle
-
Type:
string
The job title. - lastName
-
Type:
string
Required:true
The last name of the shipping address. - middleName
-
Type:
string
The middle name of the shipping address. - phoneNumber
-
Type:
string
Required:true
The phone Number of the shipping address. - postalCode
-
Type:
string
Required:true
The postal Code of the shipping address. - prefix
-
Type:
string
prefix of shipping address name. - selectedCountry
-
Type:
string
Required:true
The selected country of the shipping address. - selectedState
-
Type:
string
Required:true
The selected state of the shipping address. - state
-
Type:
string
Required:true
The state of the shipping address. - state_ISOCode
-
Type:
string
Required:true
The state ISON code of the shipping address. - suffix
-
Type:
string
suffix of the shipping address name.
Nested Schema : shippingGroups
Nested Schema : shippingMethod
Type:
object
shipping method. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder
- value
-
Type:
string
Required:true
method type of shipment.
Nested Schema : shoppingCart
Type:
object
Shopping cart information. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder
Nested Schema : schedule
Type:
object
The schedule of the scheduled order
- daysInMonth
-
Type:
array
daysInMonthDays in a month this scheduled order has to be placed - daysOfWeek
-
Type:
array
daysOfWeekDays in a week this scheduled order has to be placed - monthsInYear
-
Type:
array
monthsInYearMonths in a year this scheduled order has to be placed - occurrenceInDay
-
Type:
integer
The number of times this scheduled order is placed in a day - weeksInMonth
-
Type:
array
weeksInMonthWeeks in a month this scheduled order has to be placed
Nested Schema : daysInMonth
Nested Schema : daysOfWeek
Nested Schema : monthsInYear
Nested Schema : weeksInMonth
Nested Schema : items
Type:
object
- items
-
Type:
array
itemsItems in the cart. - shippingAddress
-
Type:
object
shippingAddressShipping address. - shippingMethod
-
Type:
object
shippingMethodshipping method
Nested Schema : shippingAddress
Type:
object
Shipping address.
- address1
-
Type:
string
Required:true
The address1 of the shipping address. - address2
-
Type:
string
Required:true
The address2 of the shipping address. - address3
-
Type:
string
The address3 of the shipping address. - city
-
Type:
string
Required:true
The city of the shipping address. - companyName
-
Type:
string
The companyName. - country
-
Type:
string
Required:true
The country of the shipping address. - county
-
Type:
string
The county of the shipping address. - DEFAULT_POSTAL_CODE_PATTERN
-
Type:
string
The default post code pattern of the shipping address. -
Type:
string
Required:true
email of the shipping address. - faxNumber
-
Type:
string
The faxNumber of the shipping address. - firstName
-
Type:
string
Required:true
The first name of the shipping address. - jobTitle
-
Type:
string
The job title. - lastName
-
Type:
string
Required:true
The last name of the shipping address. - middleName
-
Type:
string
The middle name of the shipping address. - phoneNumber
-
Type:
string
Required:true
The phone Number of the shipping address. - postalCode
-
Type:
string
Required:true
The postal Code of the shipping address. - prefix
-
Type:
string
prefix of shipping address name. - selectedCountry
-
Type:
string
Required:true
The selected country of the shipping address. - selectedState
-
Type:
string
Required:true
The selected state of the shipping address. - state
-
Type:
string
Required:true
The state of the shipping address. - state_ISOCode
-
Type:
string
Required:true
The state ISON code of the shipping address. - suffix
-
Type:
string
suffix of the shipping address name.
Nested Schema : shippingMethod
Nested Schema : items
Type:
object
- catRefId
-
Type:
string
Required:true
catRefId of the product. - commerceItemId
-
Type:
string
Unique id of the line item - configuratorId
-
Type:
string
Configuration id of the configurable product - productId
-
Type:
string
Required:true
Id of the product. - quantity
-
Type:
integer
Required:true
quantity of the product.
Nested Schema : coupons
Nested Schema : items
Type:
object
- code
-
Type:
string
Required:true
The coupon code. - description
-
Type:
string
The coupon description. - id
-
Type:
string
Required:true
The coupon id. - level
-
Type:
string
Required:true
The level of the coupon (whether the coupon is item level, etc). - status
-
Type:
string
Required:true
The current status of the coupon.
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the item by the configurator system. - activationDate
-
Type:
string
The activation date in ISO format. - assetId
-
Type:
string
The asset ID corresponding to the current item. - billingAccountId
-
Type:
string
The billing account ID associated to the current item. - catRefId
-
Type:
string
Required:true
catRefId of the product. - childItems
-
Type:
array
childItemsChild items of the commerce item - commerceItemId
-
Type:
string
Unique id of the line item. - configuratorId
-
Type:
string
Configuration id of the configurable product - currentPrice
-
Type:
number
Required:true
price of the product. - customerAccountId
-
Type:
string
The customer account ID associated to the current item. - deactivationDate
-
Type:
string
The deactivation date in ISO format. - externalData
-
Type:
array
externalDataExternal data to be associated with a commerce item, provided by a configurator system. - externalPrice
-
Type:
integer
The Price of the product as per the external pricing system. - externalPriceQuantity
-
Type:
integer
Quantity of the product, the customer is allowed to buy at the external price. - isPriceOverridden
-
Type:
boolean
Indicates whether an item price is overridden. Should not be added when the operation is of type 'createOrder' - onSale
-
Type:
boolean
Required:true
indicates if product is on sale or not. - overriddenPrice
-
Type:
number
overridden price of commerce item. Should not be added when the operation is of type 'createOrder' - priceOverrideReason
-
Type:
string
Price override reason. Should not be added when the operation is of type 'createOrder' - productId
-
Type:
string
Required:true
Id of the product. - quantity
-
Type:
integer
Required:true
quantity of the product. - serviceAccountId
-
Type:
string
The service account ID associated to the current item. - serviceId
-
Type:
string
The service ID associated to the current item. - stockStatus
-
Type:
boolean
Required:true
stockStatus of the product.
Nested Schema : externalData
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the item by the configurator system. - activationDate
-
Type:
string
The activation date in ISO format. - assetId
-
Type:
string
The asset ID corresponding to the current item. - billingAccountId
-
Type:
string
The billing account ID associated to the current item. - catRefId
-
Type:
string
Required:true
Sku Id of the child item - childItems
-
Type:
array
childItemsChild items of the commerce item - currentPrice
-
Type:
number
Current price of the child item - customerAccountId
-
Type:
string
The customer account ID associated to the current item. - deactivationDate
-
Type:
string
The deactivation date in ISO format. - displayName
-
Type:
string
Display name of the child item - externalData
-
Type:
array
externalDataExternal data to be associated with a commerce item, provided by a configurator system. - invalid
-
Type:
boolean
Invalid state of the child item - priceListGroupId
-
Type:
string
price list group id of the child item - productId
-
Type:
string
Required:true
Product Id of the child item - quantity
-
Type:
number
Required:true
Quantity of the child item - serviceAccountId
-
Type:
string
The service account ID associated to the current item. - serviceId
-
Type:
string
The service ID associated to the current item. - stockStatus
-
Type:
boolean
Stock status Id of the child item
Nested Schema : externalData
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the item by the configurator system. - activationDate
-
Type:
string
The activation date in ISO format. - assetId
-
Type:
string
The asset ID corresponding to the current item. - billingAccountId
-
Type:
string
The billing account ID associated to the current item. - catRefId
-
Type:
string
Required:true
Sku Id of the child item - currentPrice
-
Type:
number
Current price of the child item - customerAccountId
-
Type:
string
The customer account ID associated to the current item. - deactivationDate
-
Type:
string
The deactivation date in ISO format. - displayName
-
Type:
string
Display name of the child item - externalData
-
Type:
array
externalDataExternal data to be associated with a commerce item, provided by a configurator system. - invalid
-
Type:
boolean
Invalid state of the child item - priceListGroupId
-
Type:
string
price list group id of the child item - productId
-
Type:
string
Required:true
Product Id of the child item - quantity
-
Type:
number
Required:true
Quantity of the child item - serviceAccountId
-
Type:
string
The service account ID associated to the current item. - serviceId
-
Type:
string
The service ID associated to the current item. - stockStatus
-
Type:
boolean
Stock status Id of the child item
Nested Schema : externalData
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the externalData item by the configurator system. - name
-
Type:
string
Required:true
The name to be associated with the externalData item. - values
-
Type:
object
valuesRequired:true
The array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
- dynamic_property_key
-
Type:
string
Required:true
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the externalData item by the configurator system. - name
-
Type:
string
Required:true
The name to be associated with the externalData item. - values
-
Type:
object
valuesRequired:true
The array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
- dynamic_property_key
-
Type:
string
Required:true
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the externalData item by the configurator system. - name
-
Type:
string
Required:true
The name to be associated with the externalData item. - values
-
Type:
object
valuesRequired:true
The array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
- dynamic_property_key
-
Type:
string
Required:true
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Body
Root Schema : createOrder_response
- billingMethod
-
Type:
object
billingMethodBilling method information of the order. Related Endpoint operation - submitOrder. - creationDate
-
Type:
string
Date on which the Order was created. Related Endpoint operation - submitOrder. - creationTime
-
Type:
string
Order creation Time. Related Endpoint operation - submitOrder. - discountInfo
-
Type:
object
discountInfoDiscount information. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder. - dynamicProperties
-
Type:
array
dynamicPropertiesRead-only list of dynamic properties for the order along with meta-data. Related Endpoint operation - createOrder, priceOrder, submitOrder. - giftWithPurchaseInfo
-
Type:
array
giftWithPurchaseInfoGift Selection Information. Related Endpoint operation - createOrder, priceOrder, submitOrder. - giftWithPurchaseOrderMarkers
-
Type:
array
giftWithPurchaseOrderMarkersGift With Purchase order markers information. Related Endpoint operation - createOrder, priceOrder, submitOrder. - isItemPriceOverrideAllowed
-
Type:
boolean
Indicates whether an item price can be overridden. Related Endpoint operation - createOrder, priceOrder, submitOrder. - notSubmittedOrders
-
Type:
array
notSubmittedOrdersOrders not submitted for fulfillment. Related Endpoint operations - resendOrdersForFulfillment - orderComments
-
Type:
array
orderCommentsThe list of all logged comments for the order. - orderId
-
Type:
string
Id of newly created order. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder. - paymentGroup
-
Type:
object
paymentGroupPayment Group for the order. Related Endpoint operation - submitOrder. - paymentGroups
-
Type:
array
paymentGroupsList of payment Groups for the order. Related Endpoint operations - submitOrder - priceInfo
-
Type:
object
priceInfoPrice information. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder. - pricingMessages
-
Type:
object
pricingMessagesThe Pricing messages information. Related Endpoint operation - createOrder, priceOrder, submitOrder. - profile
-
Type:
object
profileProfile Information for the order. Related Endpoint operations - submitOrder - returnRequests
-
Type:
array
returnRequestsThe list of the requests raised for the order. Related Endpoint operations - submitOrder - scheduledOrderId
-
Type:
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, priceOrder, submitOrder. - scheduledOrderName
-
Type:
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, priceOrder, submitOrder. - shippingAddress
-
Type:
object
shippingAddressShipping address. Related Endpoint operations - submitOrder - shippingGroups
-
Type:
array
shippingGroupsShipping Groups. Related Endpoint operation - createOrder, priceOrder, submitOrder. - shippingMethod
-
Type:
object
shippingMethodShipping method information. Related Endpoint operation - priceOrder, submitOrder, preAuthorizeOrder. - shoppingCart
-
Type:
object
shoppingCartShopping cart information. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder. - siteId
-
Type:
string
Site Id on which the order was placed. Related Endpoint operation - priceOrder, submitOrder, preAuthorizeOrder. - sourceSystem
-
Type:
string
The system where the order originated. Related Endpoint operation - submitOrder. - state
-
Type:
integer
The order state. Related Endpoint operation - submitOrder. - stateDetailsAsUser
-
Type:
string
Order State description for this order. Related Endpoint operation - submitOrder. - submittedOrders
-
Type:
array
submittedOrdersOrders submitted for fulfillment. Related Endpoint operations - resendOrdersForFulfillment - taxPriceInfo
-
Type:
object
taxPriceInfoThe tax pricing details for the order. Related Endpoint operation - createOrder, priceOrder, submitOrder. - totalAmountAuthorized
-
Type:
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.
- cost
-
Type:
integer
Shipping cost. - displayName
-
Type:
string
Billing method display name for this billing method. - value
-
Type:
string
Method type of billing.
Nested Schema : discountInfo
Type:
object
Discount information. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder.
- claimedCouponMultiPromotions
-
Type:
object
claimedCouponMultiPromotionsThe coupons that were claimed - orderCouponsMap
-
Type:
array
orderCouponsMapMap of coupons. - orderDiscount
-
Type:
number
Discount given on an order. - orderImplicitDiscountList
-
Type:
array
orderImplicitDiscountListList of discounts. - shippingDiscount
-
Type:
integer
The shipping discount. - unclaimedCouponMultiPromotions
-
Type:
object
unclaimedCouponMultiPromotionsThe coupons that were not claimed - unclaimedCouponsMap
-
Type:
array
unclaimedCouponsMapMap of unclaimed coupons.
Nested Schema : dynamicProperties
Nested Schema : giftWithPurchaseInfo
Nested Schema : giftWithPurchaseOrderMarkers
Nested Schema : notSubmittedOrders
Nested Schema : orderComments
Nested Schema : paymentGroup
Type:
object
Payment Group for the order. Related Endpoint operation - submitOrder.
- amount
-
Type:
number
The amount associated with this Payment Group. - amountAuthorized
-
Type:
number
The amount authorized with this Payment Group. - balance
-
Type:
string
The gift card balance available. - billingAddress
-
Type:
object
billingAddressBilling address for the order. - cardNumber
-
Type:
string
The masked credit card number. - cardType
-
Type:
string
The credit card type. - firstName
-
Type:
string
First name associated with this Payment Group. - lastName
-
Type:
string
Last name associated with this Payment Group. - paidAmount
-
Type:
number
The amount that has been debited to-date for this Payment Group. - paymentGroupId
-
Type:
integer
Id of this payment Group. - paymentState
-
Type:
string
The Payment Group state. - paymentStateDetailsAsUser
-
Type:
string
The payment state description as string. - paymentStatString
-
Type:
string
The payment state as a key string. - PONumber
-
Type:
string
Purchase order number for invoice payment. Payment type: invoice - refundAmount
-
Type:
number
The amount that has been credited to-date for this Payment Group. - token
-
Type:
string
Token associated with this Payment Group. - totalDue
-
Type:
number
The current working total order price including all discounts, tax, and billing costs. - uiIntervention
-
Type:
string
This decides whether the client has to do some intervention for payment. e.g. SOP - zero_value_auto_authorized
-
Type:
string
The Payment Group is auto authorized without any payment details for zero amount. e.g. true
Nested Schema : paymentGroups
Nested Schema : priceInfo
Type:
object
Price information. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder.
- amount
-
Type:
number
The raw number that represents the price. - currencyCode
-
Type:
string
Indicates the currency of the price. For example, USD indicates that the price is in US dollars. - shipping
-
Type:
number
shipping amount - subTotal
-
Type:
number
The subtotal of the order before applying order-level promotions. - tax
-
Type:
number
The tax on the order. - total
-
Type:
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, priceOrder, submitOrder.
- GiftWithPurchaseMessages
-
Type:
array
GiftWithPurchaseMessagesThe GWP messages information.
Nested Schema : profile
Type:
object
Profile Information for the order. Related Endpoint operations - submitOrder
-
Type:
string
Email Address corresponding to the profile. - firstName
-
Type:
string
First name of profile. - isAnonymous
-
Type:
boolean
Indicates whether this profile is an anonymous profile. By default, it is false. - lastName
-
Type:
string
Last name of profile. - middleName
-
Type:
string
Middle name of profile. - organization
-
Type:
object
organizationThe Organization associated with the B2B customer profile.
Nested Schema : returnRequests
Nested Schema : shippingAddress
Type:
object
Shipping address. Related Endpoint operations - submitOrder
- address1
-
Type:
string
The address1 of the shipping address. - address2
-
Type:
string
The address2 of the shipping address. - address3
-
Type:
string
The address3 of the shipping address. - city
-
Type:
string
The city of the shipping address. - companyName
-
Type:
string
The companyName. - country
-
Type:
string
The country of the shipping address. - county
-
Type:
string
The county of the shipping address. - DEFAULT_POSTAL_CODE_PATTERN
-
Type:
string
The default post code pattern of the shipping address. -
Type:
string
email of the shipping address. - faxNumber
-
Type:
string
The faxNumber of the shipping address. - firstName
-
Type:
string
The first name of the shipping address. - jobTitle
-
Type:
string
The job title. - lastName
-
Type:
string
The last name of the shipping address. - middleName
-
Type:
string
The middle name of the shipping address. - phoneNumber
-
Type:
string
The phone Number of the shipping address. - postalCode
-
Type:
string
The postal Code of the shipping address. - prefix
-
Type:
string
prefix of shipping address name. - selectedCountry
-
Type:
string
The selected country of the shipping address. - selectedState
-
Type:
string
The selected state of the shipping address. - state
-
Type:
string
The state of the shipping address. - state_ISOCode
-
Type:
string
The state ISON code of the shipping address. - suffix
-
Type:
string
suffix of the shipping address name.
Nested Schema : shippingGroups
Nested Schema : shippingMethod
Type:
object
Shipping method information. Related Endpoint operation - priceOrder, submitOrder, preAuthorizeOrder.
- cost
-
Type:
integer
Shipping cost. - value
-
Type:
string
Method type of shipment.
Nested Schema : shoppingCart
Type:
object
Shopping cart information. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder.
- items
-
Type:
array
itemsItems in the cart. - numberOfItems
-
Type:
integer
number of items in an order.
Nested Schema : submittedOrders
Type:
array
Orders submitted for fulfillment. Related Endpoint operations - resendOrdersForFulfillment
-
Type:
string
Nested Schema : taxPriceInfo
Type:
object
The tax pricing details for the order. Related Endpoint operation - createOrder, priceOrder, submitOrder.
- amount
-
Type:
number
The monetary amount. - amountIsFinal
-
Type:
boolean
Whether the amount is final. - cityTax
-
Type:
number
The monetary amount of city tax. - countryTax
-
Type:
number
The monetary amount of country tax. - countyTax
-
Type:
number
The monetary amount of county tax. - currencyCode
-
Type:
string
The three character currency code. - discounted
-
Type:
boolean
Whether the price was discounted. - districtTax
-
Type:
number
Tax amount for the district. - stateTax
-
Type:
number
Tax amount for the state.
Nested Schema : claimedCouponMultiPromotions
Type:
object
The coupons that were claimed
- couponCode
-
Type:
array
couponCodeCoupon Code, corresponding to which promotions were applied
Nested Schema : unclaimedCouponMultiPromotions
Type:
object
The coupons that were not claimed
- couponCode
-
Type:
array
couponCodeCoupon Code, corresponding to which some promotions were not applied
Nested Schema : couponCode
Nested Schema : items
Type:
object
- promotionDesc
-
Type:
string
Promotion Description - promotionId
-
Type:
string
Promotion Id - promotionLevel
-
Type:
string
Promotion Level - totalAdjustment
-
Type:
number
Adjustment done by the promotion
Nested Schema : items
Type:
object
- promotionDesc
-
Type:
string
Description of the promotion. - promotionId
-
Type:
string
Id of the promotion. - promotionLevel
-
Type:
string
Level of the promotion. - totalAdjustment
-
Type:
string
Total adjustment caused by the promotion.
Nested Schema : items
Type:
object
- promotionDesc
-
Type:
string
Description of the promotion. - promotionId
-
Type:
string
Id of the promotion. - promotionLevel
-
Type:
string
Level of the promotion. - totalAdjustment
-
Type:
string
Total adjustment caused by the promotion.
Nested Schema : couponCode
Nested Schema : items
Type:
object
- promotionDesc
-
Type:
string
Promotion Description - promotionId
-
Type:
string
Promotion Id - promotionLevel
-
Type:
string
Promotion Level
Nested Schema : items
Type:
object
- couponInfo
-
Type:
array
couponInfoThe coupon Info. - promotionValue
-
Type:
string
The value for promotion.
Nested Schema : items
Type:
object
- promotionDesc
-
Type:
string
Description of the promotion. - promotionId
-
Type:
string
Id of the promotion. - promotionLevel
-
Type:
string
Level of the promotion. - totalAdjustment
-
Type:
string
Total adjustment caused by the promotion.
Nested Schema : items
Type:
object
- id
-
Type:
string
The ID of the dynamic property. - value
-
Type:
string
The value of the dynamic property.
Nested Schema : items
Type:
object
- giftHashCode
-
Type:
string
The gift hash code for the promotion - giftWithPurchaseDetail
-
Type:
string
String identifying the gift usually the repository ID of the gift type. - giftWithPurchaseIdentifier
-
Type:
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
-
Type:
number
Quantity of gift that the shopper still needs to select. - giftWithPurchaseType
-
Type:
string
The type of gift like sku, product, category, skuContentGroup or productContentGroup. - promotionDesc
-
Type:
string
The promotion description. - promotionId
-
Type:
string
The gift with purchase promotion id
Nested Schema : items
Type:
object
- automaticQuantity
-
Type:
number
The quantity of free sku for this gift selection that has already been auto added to the order. - autoRemove
-
Type:
boolean
Flag to indicate whether free gifts should be auto removed if the promotion no longer qualifies. - data
-
Type:
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
-
Type:
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
-
Type:
string
String identifying the free gift, usually the repository id of the gift type. - giftType
-
Type:
string
The type of gift like sku, product, category, skuContentGroup or productContentGroup. - key
-
Type:
string
atg.gwp. - quantity
-
Type:
number
The total quantity of sku for this gift selection. - removedQuantity
-
Type:
number
The amount of free quantity that has since been manually removed by a Shopper. - repositoryId
-
Type:
string
The repository id of the gwp order marker. - selectedQuantity
-
Type:
number
The quantity of free sku for this gift selection that has already been selected by the Shopper and added to the order. - targetedQuantity
-
Type:
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
-
Type:
string
The GWP promotion id.
Nested Schema : items
Type:
object
- failureReason
-
Type:
string
Failure Reason. - orderId
-
Type:
string
Order Id of the order whose submission has failed.
Nested Schema : items
Type:
object
- comment
-
Type:
string
The comment string. - creationDate
-
Type:
string
Date on which the comment was created. - repositoryId
-
Type:
string
The repository id of the comment record.
Nested Schema : billingAddress
Type:
object
Billing address for the order.
- address1
-
Type:
string
Address line 1 for this billing address. - address2
-
Type:
string
Address line 2 for this billing address. - address3
-
Type:
string
Address line 3 for this billing address. - city
-
Type:
string
City for this billing address. - companyName
-
Type:
string
Company name for this billing address. - country
-
Type:
string
Country for this billing address. - county
-
Type:
string
County for this billing address. -
Type:
string
Email for this billing address. - faxNumber
-
Type:
string
Fax number for this billing address. - firstName
-
Type:
string
First name for this billing address. - jobTitle
-
Type:
string
Job title for this billing address. - lastName
-
Type:
string
Last name for this billing address. - middleName
-
Type:
string
Middle name for this billing address. - phoneNumber
-
Type:
string
Phone number for this billing address. - postalCode
-
Type:
string
Postal code for this billing address. - prefix
-
Type:
string
Prefix for this billing address. - selectedCountry
-
Type:
string
The selected country of the shipping address. - selectedState
-
Type:
string
The selected state of the shipping address. - state
-
Type:
string
State for this billing address. - state_ISOCode
-
Type:
string
The state ISON code of the shipping address. - suffix
-
Type:
string
Suffix for this billing address.
Nested Schema : items
Type:
object
- amount
-
Type:
number
The amount associated with this Payment Group. - amountAuthorized
-
Type:
number
The amount authorized with this Payment Group. - billingAddress
-
Type:
object
billingAddressBilling address for the order. - cardNumber
-
Type:
string
The masked credit card number. - cardType
-
Type:
string
Payment method e.g. physicalGiftCard/creditCard - firstName
-
Type:
string
First name associated with this Payment Group. - IIN
-
Type:
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
-
Type:
string
Last name associated with this Payment Group. - paidAmount
-
Type:
number
The amount that has been debited to-date for this Payment Group. - paymentGroupId
-
Type:
integer
Id of this payment Group. - paymentState
-
Type:
string
The Payment Group state. - paymentStateDetailsAsUser
-
Type:
string
The payment state description as string. - PONumber
-
Type:
string
Purchase order number for invoice payment. Payment type: invoice - refundAmount
-
Type:
number
The amount that has been credited to-date for this Payment Group. - seqNum
-
Type:
string
Sequence Number of the payment. In multiple paymnets, there are can be any number of payments. - token
-
Type:
string
Token associated with this Payment Group. - totalDue
-
Type:
number
The current working total order price including all discounts, tax, and billing costs. - type
-
Type:
string
Required:true
Payment type e.g payULatamWebcheckout, paypalCheckout, card, invoice, physicalGiftCard - uiIntervention
-
Type:
string
This decides whether the client has to do some intervention for payment. e.g. SOP - zero_value_auto_authorized
-
Type:
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.
- address1
-
Type:
string
Address line 1 for this billing address. - address2
-
Type:
string
Address line 2 for this billing address. - address3
-
Type:
string
Address line 3 for this billing address. - city
-
Type:
string
City for this billing address. - companyName
-
Type:
string
Company name for this billing address. - country
-
Type:
string
Country for this billing address. - county
-
Type:
string
County for this billing address. -
Type:
string
Email for this billing address. - faxNumber
-
Type:
string
Fax number for this billing address. - firstName
-
Type:
string
First name for this billing address. - jobTitle
-
Type:
string
Job title for this billing address. - lastName
-
Type:
string
Last name for this billing address. - middleName
-
Type:
string
Middle name for this billing address. - phoneNumber
-
Type:
string
Phone number for this billing address. - postalCode
-
Type:
string
Postal code for this billing address. - prefix
-
Type:
string
Prefix for this billing address. - selectedCountry
-
Type:
string
The selected country of the shipping address. - selectedState
-
Type:
string
The selected state of the shipping address. - state
-
Type:
string
State for this billing address. - state_ISOCode
-
Type:
string
The state ISON code of the shipping address. - suffix
-
Type:
string
Suffix for this billing address.
Nested Schema : GiftWithPurchaseMessages
Nested Schema : items
Type:
object
- identifier
-
Type:
string
The pricing message identifier. - params
-
Type:
array
paramsThe list of all message parameters. - priority
-
Type:
integer
The pricing message priority. - summary
-
Type:
string
The pricing message summary. - type
-
Type:
string
The pricing message type.
Nested Schema : items
Type:
object
- promotionId
-
Type:
string
The promotion id.
Nested Schema : organization
Type:
object
The Organization associated with the B2B customer profile.
- id
-
Type:
string
The id of the organization. - name
-
Type:
string
The name of of the organization.
Nested Schema : items
Type:
object
- createdDate
-
Type:
string
The creation date of the return request. - returnRequestId
-
Type:
string
The return request id. - state
-
Type:
string
The status of the return request. - totalRefund
-
Type:
number
The total amount to be refunded on return. - totalReturnQuantity
-
Type:
integer
The total quantity for which return request has been raised.
Nested Schema : items
Type:
object
- items
-
Type:
array
itemsItems in the cart. - shippingAddress
-
Type:
object
shippingAddressshipping address for the order. - shippingMethod
-
Type:
object
shippingMethodShipping method information. - trackingInfo
-
Type:
array
trackingInfoTracking Information for the Order. - trackingNumber
-
Type:
string
Shipping tracking number.
Nested Schema : shippingAddress
Type:
object
shipping address for the order.
- address1
-
Type:
string
Address Line 1 for this shipping address. - address2
-
Type:
string
Address Line 2 for this shipping address. - address3
-
Type:
string
Address Line 3 for this shipping address. - city
-
Type:
string
City for this shipping address. - companyName
-
Type:
string
Company name for this shipping address. - country
-
Type:
string
Country for this shipping address. - county
-
Type:
string
County for this shipping address. -
Type:
string
Email for this shipping address. - faxNumber
-
Type:
string
Fax number for this shipping address. - firstName
-
Type:
string
First name for this shipping address. - jobTitle
-
Type:
string
Job title for this shipping address. - lastName
-
Type:
string
Last name for this shipping address. - middleName
-
Type:
string
Middle name for this shipping address. - phoneNumber
-
Type:
string
Phone number for this shipping address. - postalCode
-
Type:
string
Postal code for this shipping address. - prefix
-
Type:
string
Prefix for this shipping address. - selectedCountry
-
Type:
string
The selected country of the shipping address. - selectedState
-
Type:
string
The selected state of the shipping address. - state
-
Type:
string
State for this shipping address. - state_ISOCode
-
Type:
string
The state ISON code of the shipping address. - suffix
-
Type:
string
Suffix for this shipping address.
Nested Schema : shippingMethod
Type:
object
Shipping method information.
- cost
-
Type:
number
shipping cost. - displayName
-
Type:
string
Display Name of shipment. - value
-
Type:
string
method type of shipment.
Nested Schema : trackingInfo
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the item by the configurator system. - activationDate
-
Type:
string
The activation date in ISO format. - assetId
-
Type:
string
The asset ID corresponding to the current item. - availabilityDate
-
Type:
string
The Availability date of commerce Item. - backOrderQuantity
-
Type:
number
Back Order Quantity of the Items. - billingAccountId
-
Type:
string
The billing account ID associated to the current item. - catRefId
-
Type:
string
Catalog Reference Id of commerce item. - childItems
-
Type:
array
childItemsChild items of the commerce item - commerceItemId
-
Type:
string
commerce item id of the configurable product - configuratorId
-
Type:
string
configurator id of the configurable product - customerAccountId
-
Type:
string
The customer account ID associated to the current item. - deactivationDate
-
Type:
string
The deactivation date in ISO format. - discountInfo
-
Type:
object
discountInfoDiscount information. - displayName
-
Type:
string
Display name of commerce item. - dynamicProperties
-
Type:
array
dynamicPropertiesArray of custom properties at order line item level. - externalData
-
Type:
array
externalDataExternal data to be associated with a commerce item, provided by a configurator system. - externalPrice
-
Type:
number
The Price of the product as per the external pricing system. - externalPriceQuantity
-
Type:
integer
Quantity of the product, the customer is allowed to buy at the external price. - imageInfo
-
Type:
object
imageInfoShipping method information. - onSale
-
Type:
boolean
indicates if product is on sale or not. - preOrderQuantity
-
Type:
number
Pre Order Quantity of the Items. - price
-
Type:
number
The raw number that represents the price. - quantity
-
Type:
number
Quantity of the items. - rawTotalPrice
-
Type:
number
The raw total price. - returnedQuantity
-
Type:
number
Quantity for which return request has been raised. - serviceAccountId
-
Type:
string
The service account ID associated to the current item. - serviceId
-
Type:
string
The service ID associated to the current item. - status
-
Type:
integer
State of the commerce item. - subTotal
-
Type:
number
The base price for the item, before any modifications. Calculated by multiplying the quantity by the listPrice. - tax
-
Type:
number
The amount of tax paid for this item. - unitPrice
-
Type:
number
Sale price or list price of commerceItem. - variant
-
Type:
array
variantProduct Variant Information.
Nested Schema : discountInfo
Type:
object
Discount information.
- orderCouponsMap
-
Type:
array
orderCouponsMapMap of coupons. - orderDiscount
-
Type:
number
Discount given on an order. - orderImplicitDiscountList
-
Type:
array
orderImplicitDiscountListList of discounts. - unclaimedCouponsMap
-
Type:
array
unclaimedCouponsMapMap of unclaimed coupons.
Nested Schema : dynamicProperties
Nested Schema : externalData
Nested Schema : imageInfo
Type:
object
Shipping method information.
- primaryThumbImageURL
-
Type:
string
ThumbNail Image URL
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the item by the configurator system. - activationDate
-
Type:
string
The activation date in ISO format. - assetId
-
Type:
string
The asset ID corresponding to the current item. - billingAccountId
-
Type:
string
The billing account ID associated to the current item. - catRefId
-
Type:
string
Sku Id of the child item - childItems
-
Type:
array
childItemsChild items of the commerce item - customerAccountId
-
Type:
string
The customer account ID associated to the current item. - deactivationDate
-
Type:
string
The deactivation date in ISO format. - displayName
-
Type:
string
Display name of the child product - externalData
-
Type:
array
externalDataExternal data to be associated with a commerce item, provided by a configurator system. - productId
-
Type:
string
Product Id of the child item - quantity
-
Type:
number
Quantity of the child item - route
-
Type:
string
Image route - selectedOptions
-
Type:
array
selectedOptionsThe array of variants of the child item. - serviceAccountId
-
Type:
string
The service account ID associated to the current item. - serviceId
-
Type:
string
The service ID associated to the current item.
Nested Schema : externalData
Nested Schema : selectedOptions
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the item by the configurator system. - activationDate
-
Type:
string
The activation date in ISO format. - assetId
-
Type:
string
The asset ID corresponding to the current item. - billingAccountId
-
Type:
string
The billing account ID associated to the current item. - catRefId
-
Type:
string
Sku Id of the child item - customerAccountId
-
Type:
string
The customer account ID associated to the current item. - deactivationDate
-
Type:
string
The deactivation date in ISO format. - displayName
-
Type:
string
Display name of the child product - externalData
-
Type:
array
externalDataExternal data to be associated with a commerce item, provided by a configurator system. - productId
-
Type:
string
Product Id of the child item - quantity
-
Type:
number
Quantity of the child item - route
-
Type:
string
Image route - selectedOptions
-
Type:
array
selectedOptionsThe array of variants of the child item. - serviceAccountId
-
Type:
string
The service account ID associated to the current item. - serviceId
-
Type:
string
The service ID associated to the current item.
Nested Schema : externalData
Nested Schema : selectedOptions
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the externalData item by the configurator system. - name
-
Type:
string
The name to be associated with the externalData item. - values
-
Type:
object
valuesThe array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
- dynamic_property_key
-
Type:
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object
- optionName
-
Type:
string
The varian option name. - optionValue
-
Type:
string
The variant option value
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the externalData item by the configurator system. - name
-
Type:
string
The name to be associated with the externalData item. - values
-
Type:
object
valuesThe array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
- dynamic_property_key
-
Type:
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object
- optionName
-
Type:
string
The varian option name. - optionValue
-
Type:
string
The variant option value
Nested Schema : items
Type:
object
- promotionDesc
-
Type:
string
Description of the promotion. - promotionId
-
Type:
string
Id of the promotion. - promotionLevel
-
Type:
string
Level of the promotion. - totalAdjustment
-
Type:
string
Total adjustment caused by the promotion.
Nested Schema : items
Type:
object
- promotionDesc
-
Type:
string
Description of the promotion. - promotionId
-
Type:
string
Id of the promotion. - promotionLevel
-
Type:
string
Level of the promotion. - totalAdjustment
-
Type:
string
Total adjustment caused by the promotion.
Nested Schema : items
Type:
object
- couponInfo
-
Type:
array
couponInfoThe coupon Info. - promotionValue
-
Type:
string
The value for promotion.
Nested Schema : items
Type:
object
- promotionDesc
-
Type:
string
Description of the promotion. - promotionId
-
Type:
string
Id of the promotion. - promotionLevel
-
Type:
string
Level of the promotion. - totalAdjustment
-
Type:
string
Total adjustment caused by the promotion.
Nested Schema : items
Type:
object
- id
-
Type:
string
The ID of the dynamic property. - label
-
Type:
string
The label of the dynamic property. - value
-
Type:
string
The value of the dynamic property.
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the externalData item by the configurator system. - name
-
Type:
string
The name to be associated with the externalData item. - values
-
Type:
object
valuesThe array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
- dynamic_property_key
-
Type:
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object
- optionName
-
Type:
string
Name of the Dynamic attribute. - optionValue
-
Type:
string
Value of the Dynamic attribute.
Nested Schema : items
Type:
object
- carrierId
-
Type:
string
Carrier Id for Tracking. - carrierName
-
Type:
string
Carrier Name for Tracking. - carrierUrl
-
Type:
string
Carrier URL for Tracking. - trackingNumber
-
Type:
string
Tracking Number.
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the item by the configurator system. - availabilityDate
-
Type:
string
The Availability date of commerce Item. - backOrderQuantity
-
Type:
number
Back Order Quantity of the Items. - catRefId
-
Type:
string
catRefId of the product. - childItems
-
Type:
array
childItemsChild items of the commerce item - commerceItemId
-
Type:
string
commerce item id of the configurable product - configuratorId
-
Type:
string
configurator id of the configurable product - discountInfo
-
Type:
object
discountInfoDiscount information. - dynamicProperties
-
Type:
array
dynamicPropertiesArray of custom properties at order line item level. - externalData
-
Type:
array
externalDataExternal data to be associated with a commerce item, provided by a configurator system. - externalPrice
-
Type:
number
The Price of the product as per the external pricing system. - externalPriceQuantity
-
Type:
integer
Quantity of the product, the customer is allowed to buy at the external price. - giftWithPurchaseCommerceItemMarkers
-
Type:
array
giftWithPurchaseCommerceItemMarkersThe array of giftWithPurchaseCommerceItemMarkers. - isPriceOverridden
-
Type:
boolean
Indicates if commerce item price is overridden or not. - onSale
-
Type:
boolean
indicates if product is on sale or not. - overriddenPrice
-
Type:
number
overridden price of commerce item. - preOrderQuantity
-
Type:
number
Pre Order Quantity of the Items. - price
-
Type:
number
price of the product. - priceOverridenBy
-
Type:
string
Name of the agent who has overridden item price. - priceOverrideReason
-
Type:
object
priceOverrideReasonPrice override reason map - productId
-
Type:
string
Id of the product. - quantity
-
Type:
integer
quantity of the product. - unitPrice
-
Type:
number
unit price of the product.
Nested Schema : discountInfo
Type:
object
Discount information.
- gwpSelections
-
Type:
array
gwpSelectionsThe gift information. - orderCouponsMap
-
Type:
array
orderCouponsMapMap of coupons. - orderDiscount
-
Type:
number
Discount given on an order. - orderImplicitDiscountList
-
Type:
array
orderImplicitDiscountListList of discounts. - unclaimedCouponsMap
-
Type:
array
unclaimedCouponsMapMap of unclaimed coupons.
Nested Schema : dynamicProperties
Nested Schema : externalData
Nested Schema : giftWithPurchaseCommerceItemMarkers
Nested Schema : priceOverrideReason
Type:
object
Price override reason map
- displayValue
-
Type:
string
price override reason value - key
-
Type:
string
price override reason key
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the item by the configurator system. - activationDate
-
Type:
string
The activation date in ISO format. - assetId
-
Type:
string
The asset ID corresponding to the current item. - billingAccountId
-
Type:
string
The billing account ID associated to the current item. - catRefId
-
Type:
string
Sku Id of the child item - childItems
-
Type:
array
childItemsChild items of the commerce item - customerAccountId
-
Type:
string
The customer account ID associated to the current item. - deactivationDate
-
Type:
string
The deactivation date in ISO format. - displayName
-
Type:
string
Display name of the child product - externalData
-
Type:
array
externalDataExternal data to be associated with a commerce item, provided by a configurator system. - productId
-
Type:
string
Product Id of the child item - quantity
-
Type:
number
Quantity of the child item - route
-
Type:
string
Image route - selectedOptions
-
Type:
array
selectedOptionsThe array of variants of the child item. - serviceAccountId
-
Type:
string
The service account ID associated to the current item. - serviceId
-
Type:
string
The service ID associated to the current item.
Nested Schema : externalData
Nested Schema : selectedOptions
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the item by the configurator system. - activationDate
-
Type:
string
The activation date in ISO format. - assetId
-
Type:
string
The asset ID corresponding to the current item. - billingAccountId
-
Type:
string
The billing account ID associated to the current item. - catRefId
-
Type:
string
Sku Id of the child item - customerAccountId
-
Type:
string
The customer account ID associated to the current item. - deactivationDate
-
Type:
string
The deactivation date in ISO format. - displayName
-
Type:
string
Display name of the child product - externalData
-
Type:
array
externalDataExternal data to be associated with a commerce item, provided by a configurator system. - productId
-
Type:
string
Product Id of the child item - quantity
-
Type:
number
Quantity of the child item - route
-
Type:
string
Image route - selectedOptions
-
Type:
array
selectedOptionsThe array of variants of the child item. - serviceAccountId
-
Type:
string
The service account ID associated to the current item. - serviceId
-
Type:
string
The service ID associated to the current item.
Nested Schema : externalData
Nested Schema : selectedOptions
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the externalData item by the configurator system. - name
-
Type:
string
The name to be associated with the externalData item. - values
-
Type:
object
valuesThe array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
- dynamic_property_key
-
Type:
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object
- optionName
-
Type:
string
The varian option name. - optionValue
-
Type:
string
The variant option value
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the externalData item by the configurator system. - name
-
Type:
string
The name to be associated with the externalData item. - values
-
Type:
object
valuesThe array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
- dynamic_property_key
-
Type:
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object
- optionName
-
Type:
string
The varian option name. - optionValue
-
Type:
string
The variant option value
Nested Schema : items
Type:
object
- giftChoicesAvailable
-
Type:
boolean
Boolean to show if there are any gift choices for selection. - giftHashCode
-
Type:
integer
The gift hash code for this GWP promotion. - giftQuantity
-
Type:
number
The quantity that is gift quantity
Nested Schema : items
Type:
object
- promotionDesc
-
Type:
string
Description of the promotion. - promotionId
-
Type:
string
Id of the promotion. - promotionLevel
-
Type:
string
Level of the promotion. - totalAdjustment
-
Type:
string
Total adjustment caused by the promotion.
Nested Schema : items
Type:
object
- promotionDesc
-
Type:
string
Description of the promotion. - promotionId
-
Type:
string
Id of the promotion. - promotionLevel
-
Type:
string
Level of the promotion. - totalAdjustment
-
Type:
string
Total adjustment caused by the promotion.
Nested Schema : items
Type:
object
- couponInfo
-
Type:
array
couponInfoThe coupon Info. - promotionValue
-
Type:
string
The value for promotion.
Nested Schema : items
Type:
object
- promotionDesc
-
Type:
string
Description of the promotion. - promotionId
-
Type:
string
Id of the promotion. - promotionLevel
-
Type:
string
Level of the promotion. - totalAdjustment
-
Type:
string
Total adjustment caused by the promotion.
Nested Schema : items
Type:
object
- id
-
Type:
string
The ID of the dynamic property. - label
-
Type:
string
The label of the dynamic property. - value
-
Type:
string
The value of the dynamic property.
Nested Schema : items
Type:
object
- actionCode
-
Type:
string
The action code that has been set on the externalData item by the configurator system. - activationDate
-
Type:
string
The activation date in ISO format. - assetId
-
Type:
string
The asset ID corresponding to the current item. - billingAccountId
-
Type:
string
The billing account ID associated to the current item. - customerAccountId
-
Type:
string
The customer account ID associated to the current item. - deactivationDate
-
Type:
string
The deactivation date in ISO format. - name
-
Type:
string
The name to be associated with the externalData item. - serviceAccountId
-
Type:
string
The service account ID associated to the current item. - serviceId
-
Type:
string
The service ID associated to the current item. - values
-
Type:
object
valuesThe array of values associated with an externalData item.
Nested Schema : values
Type:
object
The array of values associated with an externalData item.
- dynamic_property_key
-
Type:
string
This property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object
- automaticQuantity
-
Type:
number
The quantity of the free gift that this commerce item is making free and was auto added by pricing. - data
-
Type:
integer
The gift hash code for this GWP promotion. - key
-
Type:
string
atg.gwp - remainingQuantity
-
Type:
number
The quantity of the commerce item that is not affected by GWP. - selectedQuantity
-
Type:
number
The quantity of the free gift that this commerce item is making free and was selected by the shopper. - targetedQuantity
-
Type:
number
The quantity of the free gift that this commerce item is making free and was targeted by pricing. - value
-
Type:
string
The GWP promotion id.
Example application/json
{
"taxPriceInfo":{
"cityTax":0,
"amount":4,
"valueAddedTax":0,
"countyTax":2,
"isTaxIncluded":false,
"miscTax":0,
"districtTax":0,
"stateTax":2,
"countryTax":0
},
"priceInfo":{
"amount":9.99,
"total":38.5,
"shipping":25,
"tax":3.51,
"subTotal":9.99,
"currencyCode":"USD"
},
"discountInfo":{
"unclaimedCouponMultiPromotions":{
},
"orderCouponsMap":{
},
"orderDiscount":0,
"shippingDiscount":0,
"orderImplicitDiscountList":[
],
"unclaimedCouponsMap":{
},
"claimedCouponMultiPromotions":{
}
},
"orderId":"o10415",
"dynamicProperties":[
{
"id":"dynamicPropertyShippingInstructions",
"value":"Test Instructions"
}
],
"isItemPriceOverrideAllowed":true,
"shoppingCart":{
"numberOfItems":1,
"items":[
{
"unitPrice":9.99,
"quantity":1,
"productId":"Product_18Cyii",
"priceOverridenBy":"",
"giftWithPurchaseCommerceItemMarkers":[
],
"preOrderQuantity":0,
"childItems":[
{
"quantity":1,
"route":"/intel-pentium-dual-core/product/prod40001",
"productId":"prod40001",
"displayName":"Intel Pentium Dual Core",
"selectedOptions":[
],
"catRefId":"sku40001"
},
{
"quantity":1,
"route":"/8-gb-kingston-sodimm-ddr3-1600mhz/product/prod40007",
"productId":"prod40007",
"displayName":"8 GB Kingston Sodimm DDR3 1600MHz",
"selectedOptions":[
],
"catRefId":"sku40007"
}
],
"catRefId":"Sku_18Dxy",
"configuratorId":"36379716",
"overriddenPrice":"",
"commerceItemId":"ci1000785",
"discountInfo":[
],
"price":9.99,
"isPriceOverridden":false,
"onSale":true,
"backOrderQuantity":0,
"priceOverrideReason":{
}
}
]
},
"giftWithPurchaseInfo":[
],
"links":[
{
"method":"POST",
"rel":"self",
"href":"/ccagentui/v1/orders"
}
],
"giftWithPurchaseOrderMarkers":[
]
}
Default Response
The error response.
The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud:
|Error Code|Description|
|------------------|------------------|
|40001|Please check the shipping address and try again.|
|200124|Internal error occurred.|
|28155|{0} cannot be purchased directly and is only available as part of a customizable product, please remove this item from your cart in order to proceed|
|1002020|The user does not have permission to place an order.|
|100094|Organization passed in the header is currently inactive|
|100098|Current operation is being performed in an organization context and the shopper profile is not associated to any organization|
|28107|Specified order does not exist|
|28129|Product/sku {0} not found|
|22001|An internal error occurred while processing input request.|
|22002|No profile found with profile id {0}|
|28326|Code not currently active./ Code not found. / Code expired.|
|28088|Please check the selected shipping method before placing your order. The previously selected shipping method is no longer available.|
|28086|No shipping data specified|
|30015|SiteId passed in x-ccsite header is currently inactive|
|28087|No shipping method specified|
|30014|SiteId passed in x-ccsite header is invalid or the site was deleted|
|28103|Quantity cannot exceed order limit|
|28301|Order submission failed|
|28104|Quantity cannot exceed stock limit (inventory check)|
|28102|Product/sku {0} not found|
|28300|Internal error while creating the order|
|28080|Empty shopping cart data|
|28081|No items found in cart data|
|100101|The shopper profile does not belong to organization passed in the header|
|100102|Organization passed in the header is invalid or does not exist|
|100103|The order or return request does not belong to the organization passed in the header|
|28084|No quantity specified on item|
|28085|Invalid quantity {0} specified on item|
|28082|No product id specified on item|
|28083|No catalog reference id specified on item|
|28105|Order submission failed|
|28111|Your order has not been placed due to a payment error, and you have not been charged. Please try again|
Body
Root Schema : errorModel
Type:
object
- devMessage
-
Type:
string
An optional non-localized message containing technical information for developers - errorCode
-
Type:
string
The numerical code identifying the error - errors
-
Type:
array
errorsAn optional list of errors if multiple errors were encountered - message
-
Type:
string
The localized message describing the error - moreInfo
-
Type:
string
An optional non-localized message with more information - o:errorPath
-
Type:
string
An optional machine readable description of where the error occurred - status
-
Type:
string
The HTTP status code - type
-
Type:
string
The URI to the HTTP state code definition
Nested Schema : errors
Nested Schema : items
Type:
object
- devMessage
-
Type:
string
An optional non-localized message containing technical information for developers - errorCode
-
Type:
string
The numerical code identifying the error - message
-
Type:
string
The localized message describing the error - moreInfo
-
Type:
string
An optional non-localized message with more information - o:errorPath
-
Type:
string
An optional machine readable description of where the error occurred - status
-
Type:
string
The HTTP status code
Examples
Sample Request:
{ "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": [{ "serviceAccountId": "serviceAcc-123", "deactivationDate": "2018-06-27T12:59:59Z", "quantity": 1, "productId": "Product_18Cyii", "currentPrice": 0, "billingAccountId": "billingAcc-123", "childItems": [{ "serviceAccountId": "serviceAcc-123", "deactivationDate": "2018-06-27T12:59:59Z", "quantity": "1", "productId": "prod40001", "displayName": "Laptop Parts 1", "externalData": [], "currentPrice": 0, "billingAccountId": "billingAcc-123", "childItems": [{ "serviceAccountId": "serviceAcc-123", "deactivationDate": "2018-06-27T12:59:59Z", "quantity": "1", "productId": "prod40001", "displayName": "Laptop Parts 1", "externalData": [], "currentPrice": 0, "billingAccountId": "billingAcc-123", "catRefId": "sku40009", "priceListGroupId": "defaultPriceGroup", "customerAccountId": "customerAcc-123", "assetId": "asset10001", "invalid": false, "stockStatus": true, "actionCode": "Add", "activationDate": "2017-06-27T15:30:00Z", "serviceId": "service-123" }], "catRefId": "sku40001", "priceListGroupId": "defaultPriceGroup", "customerAccountId": "customerAcc-123", "assetId": "asset10001", "invalid": false, "stockStatus": true, "actionCode": "Add", "activationDate": "2017-06-27T15:30:00Z", "serviceId": "service-123" }], "externalPriceQuantity": -1, "catRefId": "Sku_18Dxy", "configuratorId": "12343455", "externalPrice": "722.0", "customerAccountId": "customerAcc-123", "assetId": "asset10001", "stockStatus": true, "onSale": true, "actionCode": "Add", "activationDate": "2017-06-27T15:30:00Z", "serviceId": "service-123" }] }, "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" }
Sample Response Payload returned by endpoint:
{ "taxPriceInfo": { "cityTax": 0, "amount": 4, "valueAddedTax": 0, "countyTax": 2, "isTaxIncluded": false, "miscTax": 0, "districtTax": 0, "stateTax": 2, "countryTax": 0 }, "priceInfo": { "amount": 9.99, "total": 38.5, "shipping": 25, "tax": 3.51, "subTotal": 9.99, "currencyCode": "USD" }, "discountInfo": { "unclaimedCouponMultiPromotions": {}, "orderCouponsMap": {}, "orderDiscount": 0, "shippingDiscount": 0, "orderImplicitDiscountList": [], "unclaimedCouponsMap": {}, "claimedCouponMultiPromotions": {} }, "orderId": "o10415", "dynamicProperties": [{ "id": "dynamicPropertyShippingInstructions", "value": "Test Instructions" }], "isItemPriceOverrideAllowed": true, "shoppingCart": { "numberOfItems": 1, "items": [{ "unitPrice": 9.99, "quantity": 1, "productId": "Product_18Cyii", "priceOverridenBy": "", "giftWithPurchaseCommerceItemMarkers": [], "preOrderQuantity": 0, "childItems": [ { "quantity": 1, "route": "/intel-pentium-dual-core/product/prod40001", "productId": "prod40001", "displayName": "Intel Pentium Dual Core", "selectedOptions": [], "catRefId": "sku40001" }, { "quantity": 1, "route": "/8-gb-kingston-sodimm-ddr3-1600mhz/product/prod40007", "productId": "prod40007", "displayName": "8 GB Kingston Sodimm DDR3 1600MHz", "selectedOptions": [], "catRefId": "sku40007" } ], "catRefId": "Sku_18Dxy", "configuratorId": "36379716", "overriddenPrice": "", "commerceItemId": "ci1000785", "discountInfo": [], "price": 9.99, "isPriceOverridden": false, "onSale": true, "backOrderQuantity": 0, "priceOverrideReason": {} }] }, "giftWithPurchaseInfo": [], "links": [{ "method": "POST", "rel": "self", "href": "/ccagentui/v1/orders" }], "giftWithPurchaseOrderMarkers": [] }