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:
stringthe organization Id in which order should be created- x-ccsite
Type:stringthe 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:
stringamount to authorize. - billingAddress
-
Type:
objectbillingAddressBilling address for the order - combineLineItems
-
Type:
stringValue to determine if line items are to be combined. Can be yes or no. Related Endpoint operations - createOrder, priceOrder, submitOrder - op
-
Type:
stringRequired:trueoperation to be performed. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder, resendOrdersForFulfillment. - orderId
-
Type:
stringCommerce id for this order. Related Endpoint operations - priceOrder, submitOrder, preAuthorizeOrder - orders
-
Type:
arrayordersOrders to be resubmitted. Related Endpoint operations - resendOrdersForFulfillment - payments
-
Type:
objectpaymentsList of payments - profileId
-
Type:
stringRequired:trueprofile id. Related Endpoint operations - createOrder, priceOrder, submitOrder - requestChannel
-
Type:
stringrequest Channel name. Possible values are 'agent' or 'asa'. Related Endpoint operations - createOrder, priceOrder, submitOrder - schedule
-
Type:
objectscheduleThe details of the schedule order. Related Endpoint operations - createOrder - scheduleOnly
-
Type:
booleanThis 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:
objectshippingAddressRequired:trueShipping address. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder - shippingGroups
-
Type:
arrayshippingGroupsShipping Groups. Related Endpoint operations - createOrder, priceOrder, submitOrder - shippingMethod
-
Type:
objectshippingMethodRequired:trueshipping method. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder - shoppingCart
-
Type:
objectshoppingCartRequired:trueShopping cart information. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder
Nested Schema : billingAddress
Type:
objectBilling address for the order
- address1
-
Type:
stringRequired:trueAddress line 1 for this billing address. - address2
-
Type:
stringAddress line 2 for this billing address. - address3
-
Type:
stringAddress line 3 for this billing address. - alias
-
Type:
stringNickname or alternate name for address like home/office. - city
-
Type:
stringRequired:trueCity for this billing address. - companyName
-
Type:
stringCompany name for this billing address. - country
-
Type:
stringCountry for this billing address. -
Type:
stringEmail for this billing address. - faxNumber
-
Type:
stringFax Number for this billing address. - firstName
-
Type:
stringRequired:trueFirst Name for this billing address. - isDefaultAddress
-
Type:
booleanDefault value of the address. - jobTitle
-
Type:
stringJOb Title for this billing address. - lastName
-
Type:
stringRequired:trueLast Name for this billing address. - middleName
-
Type:
stringMiddle Name for this billing address. - phoneNumber
-
Type:
stringPhone Number for this billing address. - postalCode
-
Type:
stringRequired:truePostal code for this billing address. - prefix
-
Type:
stringPrefix for this billing address. - repositoryId
-
Type:
stringRepository Id of the address. - selectedCountry
-
Type:
stringRequired:trueThe selected country of the shipping address. - selectedState
-
Type:
stringRequired:trueThe selected state of the shipping address. - state
-
Type:
stringState for this billing address. - state_ISOCode
-
Type:
stringThe state ISON code of the shipping address. - suffix
-
Type:
stringsuffix for this billing address.
Nested Schema : orders
Type:
arrayOrders to be resubmitted. Related Endpoint operations - resendOrdersForFulfillment
-
Type:
string
Nested Schema : payments
Type:
objectList of payments
- amount
-
Type:
numberAmount to be authorized from the gift card. Payment type:card, physicalGiftCard, paypalCheckout, payUWebLatamCheckout. - cardCVV
-
Type:
stringCredit card CVV. - cardNumber
-
Type:
stringCredit card Number - cardType
-
Type:
stringCredit card type. - endMonth
-
Type:
stringCredit card expiry month - endYear
-
Type:
integerCredit card expiry year. - giftCardNumber
-
Type:
stringGift card number used for payment. Payment type: physicalGiftCard(this field should be used when giftcards are used). - giftCardPin
-
Type:
stringGift card pin. Payment type: physicalGiftCard(this field should be used when giftcards are used). - nameOnCard
-
Type:
stringName printed on credit card. - paymentGroupId
-
Type:
stringPayment Group Id of the gift card payment group. Payment type: physicalGiftCard - PONumber
-
Type:
stringPurchase order number for invoice payment. Payment type: invoice - seqNum
-
Type:
stringSequence Number of the payment. In multiple paymnets, there are can be any number of payments. - type
-
Type:
stringpayment type. payULatamWebcheckout,paypalCheckout,card,invoice,physicalGiftCard.
Nested Schema : schedule
Type:
objectThe details of the schedule order. Related Endpoint operations - createOrder
- endDate
-
Type:
stringScheduled order end date. - name
-
Type:
stringName of the Scheduled Order. - schedule
-
Type:
objectscheduleRequired:trueThe schedule of the scheduled order - startDate
-
Type:
stringRequired:trueScheduled Order start date. - state
-
Type:
stringThe state of the scheduled order.
Nested Schema : shippingAddress
Type:
objectShipping address. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder
- address1
-
Type:
stringRequired:trueThe address1 of the shipping address. - address2
-
Type:
stringRequired:trueThe address2 of the shipping address. - address3
-
Type:
stringThe address3 of the shipping address. - city
-
Type:
stringRequired:trueThe city of the shipping address. - companyName
-
Type:
stringThe companyName. - country
-
Type:
stringRequired:trueThe country of the shipping address. - county
-
Type:
stringThe county of the shipping address. - DEFAULT_POSTAL_CODE_PATTERN
-
Type:
stringThe default post code pattern of the shipping address. -
Type:
stringRequired:trueemail of the shipping address. - faxNumber
-
Type:
stringThe faxNumber of the shipping address. - firstName
-
Type:
stringRequired:trueThe first name of the shipping address. - jobTitle
-
Type:
stringThe job title. - lastName
-
Type:
stringRequired:trueThe last name of the shipping address. - middleName
-
Type:
stringThe middle name of the shipping address. - phoneNumber
-
Type:
stringRequired:trueThe phone Number of the shipping address. - postalCode
-
Type:
stringRequired:trueThe postal Code of the shipping address. - prefix
-
Type:
stringprefix of shipping address name. - selectedCountry
-
Type:
stringRequired:trueThe selected country of the shipping address. - selectedState
-
Type:
stringRequired:trueThe selected state of the shipping address. - state
-
Type:
stringRequired:trueThe state of the shipping address. - state_ISOCode
-
Type:
stringRequired:trueThe state ISON code of the shipping address. - suffix
-
Type:
stringsuffix of the shipping address name.
Nested Schema : shippingGroups
Nested Schema : shippingMethod
Type:
objectshipping method. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder
- value
-
Type:
stringRequired:truemethod type of shipment.
Nested Schema : shoppingCart
Type:
objectShopping cart information. Related Endpoint operations - createOrder, priceOrder, submitOrder, preAuthorizeOrder
Nested Schema : schedule
Type:
objectThe schedule of the scheduled order
- daysInMonth
-
Type:
arraydaysInMonthDays in a month this scheduled order has to be placed - daysOfWeek
-
Type:
arraydaysOfWeekDays in a week this scheduled order has to be placed - monthsInYear
-
Type:
arraymonthsInYearMonths in a year this scheduled order has to be placed - occurrenceInDay
-
Type:
integerThe number of times this scheduled order is placed in a day - weeksInMonth
-
Type:
arrayweeksInMonthWeeks 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:
arrayitemsItems in the cart. - shippingAddress
-
Type:
objectshippingAddressShipping address. - shippingMethod
-
Type:
objectshippingMethodshipping method
Nested Schema : shippingAddress
Type:
objectShipping address.
- address1
-
Type:
stringRequired:trueThe address1 of the shipping address. - address2
-
Type:
stringRequired:trueThe address2 of the shipping address. - address3
-
Type:
stringThe address3 of the shipping address. - city
-
Type:
stringRequired:trueThe city of the shipping address. - companyName
-
Type:
stringThe companyName. - country
-
Type:
stringRequired:trueThe country of the shipping address. - county
-
Type:
stringThe county of the shipping address. - DEFAULT_POSTAL_CODE_PATTERN
-
Type:
stringThe default post code pattern of the shipping address. -
Type:
stringRequired:trueemail of the shipping address. - faxNumber
-
Type:
stringThe faxNumber of the shipping address. - firstName
-
Type:
stringRequired:trueThe first name of the shipping address. - jobTitle
-
Type:
stringThe job title. - lastName
-
Type:
stringRequired:trueThe last name of the shipping address. - middleName
-
Type:
stringThe middle name of the shipping address. - phoneNumber
-
Type:
stringRequired:trueThe phone Number of the shipping address. - postalCode
-
Type:
stringRequired:trueThe postal Code of the shipping address. - prefix
-
Type:
stringprefix of shipping address name. - selectedCountry
-
Type:
stringRequired:trueThe selected country of the shipping address. - selectedState
-
Type:
stringRequired:trueThe selected state of the shipping address. - state
-
Type:
stringRequired:trueThe state of the shipping address. - state_ISOCode
-
Type:
stringRequired:trueThe state ISON code of the shipping address. - suffix
-
Type:
stringsuffix of the shipping address name.
Nested Schema : shippingMethod
Nested Schema : items
Type:
object- catRefId
-
Type:
stringRequired:truecatRefId of the product. - commerceItemId
-
Type:
stringUnique id of the line item - configuratorId
-
Type:
stringConfiguration id of the configurable product - productId
-
Type:
stringRequired:trueId of the product. - quantity
-
Type:
integerRequired:truequantity of the product.
Nested Schema : coupons
Nested Schema : items
Type:
object- code
-
Type:
stringRequired:trueThe coupon code. - description
-
Type:
stringThe coupon description. - id
-
Type:
stringRequired:trueThe coupon id. - level
-
Type:
stringRequired:trueThe level of the coupon (whether the coupon is item level, etc). - status
-
Type:
stringRequired:trueThe current status of the coupon.
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the item by the configurator system. - activationDate
-
Type:
stringThe activation date in ISO format. - assetId
-
Type:
stringThe asset ID corresponding to the current item. - billingAccountId
-
Type:
stringThe billing account ID associated to the current item. - catRefId
-
Type:
stringRequired:truecatRefId of the product. - childItems
-
Type:
arraychildItemsChild items of the commerce item - commerceItemId
-
Type:
stringUnique id of the line item. - configuratorId
-
Type:
stringConfiguration id of the configurable product - currentPrice
-
Type:
numberRequired:trueprice of the product. - customerAccountId
-
Type:
stringThe customer account ID associated to the current item. - deactivationDate
-
Type:
stringThe deactivation date in ISO format. - externalData
-
Type:
arrayexternalDataExternal data to be associated with a commerce item, provided by a configurator system. - externalPrice
-
Type:
integerThe Price of the product as per the external pricing system. - externalPriceQuantity
-
Type:
integerQuantity of the product, the customer is allowed to buy at the external price. - isPriceOverridden
-
Type:
booleanIndicates whether an item price is overridden. Should not be added when the operation is of type 'createOrder' - onSale
-
Type:
booleanRequired:trueindicates if product is on sale or not. - overriddenPrice
-
Type:
numberoverridden price of commerce item. Should not be added when the operation is of type 'createOrder' - priceOverrideReason
-
Type:
stringPrice override reason. Should not be added when the operation is of type 'createOrder' - productId
-
Type:
stringRequired:trueId of the product. - quantity
-
Type:
integerRequired:truequantity of the product. - serviceAccountId
-
Type:
stringThe service account ID associated to the current item. - serviceId
-
Type:
stringThe service ID associated to the current item. - stockStatus
-
Type:
booleanRequired:truestockStatus of the product.
Nested Schema : externalData
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the item by the configurator system. - activationDate
-
Type:
stringThe activation date in ISO format. - assetId
-
Type:
stringThe asset ID corresponding to the current item. - billingAccountId
-
Type:
stringThe billing account ID associated to the current item. - catRefId
-
Type:
stringRequired:trueSku Id of the child item - childItems
-
Type:
arraychildItemsChild items of the commerce item - currentPrice
-
Type:
numberCurrent price of the child item - customerAccountId
-
Type:
stringThe customer account ID associated to the current item. - deactivationDate
-
Type:
stringThe deactivation date in ISO format. - displayName
-
Type:
stringDisplay name of the child item - externalData
-
Type:
arrayexternalDataExternal data to be associated with a commerce item, provided by a configurator system. - invalid
-
Type:
booleanInvalid state of the child item - priceListGroupId
-
Type:
stringprice list group id of the child item - productId
-
Type:
stringRequired:trueProduct Id of the child item - quantity
-
Type:
numberRequired:trueQuantity of the child item - serviceAccountId
-
Type:
stringThe service account ID associated to the current item. - serviceId
-
Type:
stringThe service ID associated to the current item. - stockStatus
-
Type:
booleanStock status Id of the child item
Nested Schema : externalData
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the item by the configurator system. - activationDate
-
Type:
stringThe activation date in ISO format. - assetId
-
Type:
stringThe asset ID corresponding to the current item. - billingAccountId
-
Type:
stringThe billing account ID associated to the current item. - catRefId
-
Type:
stringRequired:trueSku Id of the child item - currentPrice
-
Type:
numberCurrent price of the child item - customerAccountId
-
Type:
stringThe customer account ID associated to the current item. - deactivationDate
-
Type:
stringThe deactivation date in ISO format. - displayName
-
Type:
stringDisplay name of the child item - externalData
-
Type:
arrayexternalDataExternal data to be associated with a commerce item, provided by a configurator system. - invalid
-
Type:
booleanInvalid state of the child item - priceListGroupId
-
Type:
stringprice list group id of the child item - productId
-
Type:
stringRequired:trueProduct Id of the child item - quantity
-
Type:
numberRequired:trueQuantity of the child item - serviceAccountId
-
Type:
stringThe service account ID associated to the current item. - serviceId
-
Type:
stringThe service ID associated to the current item. - stockStatus
-
Type:
booleanStock status Id of the child item
Nested Schema : externalData
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the externalData item by the configurator system. - name
-
Type:
stringRequired:trueThe name to be associated with the externalData item. - values
-
Type:
objectvaluesRequired:trueThe array of values associated with an externalData item.
Nested Schema : values
Type:
objectThe array of values associated with an externalData item.
- dynamic_property_key
-
Type:
stringRequired:trueThis property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the externalData item by the configurator system. - name
-
Type:
stringRequired:trueThe name to be associated with the externalData item. - values
-
Type:
objectvaluesRequired:trueThe array of values associated with an externalData item.
Nested Schema : values
Type:
objectThe array of values associated with an externalData item.
- dynamic_property_key
-
Type:
stringRequired:trueThis property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the externalData item by the configurator system. - name
-
Type:
stringRequired:trueThe name to be associated with the externalData item. - values
-
Type:
objectvaluesRequired:trueThe array of values associated with an externalData item.
Nested Schema : values
Type:
objectThe array of values associated with an externalData item.
- dynamic_property_key
-
Type:
stringRequired:trueThis 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:
objectbillingMethodBilling method information of the order. Related Endpoint operation - submitOrder. - creationDate
-
Type:
stringDate on which the Order was created. Related Endpoint operation - submitOrder. - creationTime
-
Type:
stringOrder creation Time. Related Endpoint operation - submitOrder. - discountInfo
-
Type:
objectdiscountInfoDiscount information. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder. - dynamicProperties
-
Type:
arraydynamicPropertiesRead-only list of dynamic properties for the order along with meta-data. Related Endpoint operation - createOrder, priceOrder, submitOrder. - giftWithPurchaseInfo
-
Type:
arraygiftWithPurchaseInfoGift Selection Information. Related Endpoint operation - createOrder, priceOrder, submitOrder. - giftWithPurchaseOrderMarkers
-
Type:
arraygiftWithPurchaseOrderMarkersGift With Purchase order markers information. Related Endpoint operation - createOrder, priceOrder, submitOrder. - isItemPriceOverrideAllowed
-
Type:
booleanIndicates whether an item price can be overridden. Related Endpoint operation - createOrder, priceOrder, submitOrder. - notSubmittedOrders
-
Type:
arraynotSubmittedOrdersOrders not submitted for fulfillment. Related Endpoint operations - resendOrdersForFulfillment - orderComments
-
Type:
arrayorderCommentsThe list of all logged comments for the order. - orderId
-
Type:
stringId of newly created order. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder. - paymentGroup
-
Type:
objectpaymentGroupPayment Group for the order. Related Endpoint operation - submitOrder. - paymentGroups
-
Type:
arraypaymentGroupsList of payment Groups for the order. Related Endpoint operations - submitOrder - priceInfo
-
Type:
objectpriceInfoPrice information. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder. - pricingMessages
-
Type:
objectpricingMessagesThe Pricing messages information. Related Endpoint operation - createOrder, priceOrder, submitOrder. - profile
-
Type:
objectprofileProfile Information for the order. Related Endpoint operations - submitOrder - returnRequests
-
Type:
arrayreturnRequestsThe list of the requests raised for the order. Related Endpoint operations - submitOrder - scheduledOrderId
-
Type:
stringThe 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:
stringThe 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:
objectshippingAddressShipping address. Related Endpoint operations - submitOrder - shippingGroups
-
Type:
arrayshippingGroupsShipping Groups. Related Endpoint operation - createOrder, priceOrder, submitOrder. - shippingMethod
-
Type:
objectshippingMethodShipping method information. Related Endpoint operation - priceOrder, submitOrder, preAuthorizeOrder. - shoppingCart
-
Type:
objectshoppingCartShopping cart information. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder. - siteId
-
Type:
stringSite Id on which the order was placed. Related Endpoint operation - priceOrder, submitOrder, preAuthorizeOrder. - sourceSystem
-
Type:
stringThe system where the order originated. Related Endpoint operation - submitOrder. - state
-
Type:
integerThe order state. Related Endpoint operation - submitOrder. - stateDetailsAsUser
-
Type:
stringOrder State description for this order. Related Endpoint operation - submitOrder. - submittedOrders
-
Type:
arraysubmittedOrdersOrders submitted for fulfillment. Related Endpoint operations - resendOrdersForFulfillment - taxPriceInfo
-
Type:
objecttaxPriceInfoThe tax pricing details for the order. Related Endpoint operation - createOrder, priceOrder, submitOrder. - totalAmountAuthorized
-
Type:
numberTotal amount authorized for the order. Related Endpoint operation - submitOrder.
Nested Schema : billingMethod
Type:
objectBilling method information of the order. Related Endpoint operation - submitOrder.
- cost
-
Type:
integerShipping cost. - displayName
-
Type:
stringBilling method display name for this billing method. - value
-
Type:
stringMethod type of billing.
Nested Schema : discountInfo
Type:
objectDiscount information. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder.
- claimedCouponMultiPromotions
-
Type:
objectclaimedCouponMultiPromotionsThe coupons that were claimed - orderCouponsMap
-
Type:
arrayorderCouponsMapMap of coupons. - orderDiscount
-
Type:
numberDiscount given on an order. - orderImplicitDiscountList
-
Type:
arrayorderImplicitDiscountListList of discounts. - shippingDiscount
-
Type:
integerThe shipping discount. - unclaimedCouponMultiPromotions
-
Type:
objectunclaimedCouponMultiPromotionsThe coupons that were not claimed - unclaimedCouponsMap
-
Type:
arrayunclaimedCouponsMapMap of unclaimed coupons.
Nested Schema : dynamicProperties
Nested Schema : giftWithPurchaseInfo
Nested Schema : giftWithPurchaseOrderMarkers
Nested Schema : notSubmittedOrders
Nested Schema : orderComments
Nested Schema : paymentGroup
Type:
objectPayment Group for the order. Related Endpoint operation - submitOrder.
- amount
-
Type:
numberThe amount associated with this Payment Group. - amountAuthorized
-
Type:
numberThe amount authorized with this Payment Group. - balance
-
Type:
stringThe gift card balance available. - billingAddress
-
Type:
objectbillingAddressBilling address for the order. - cardNumber
-
Type:
stringThe masked credit card number. - cardType
-
Type:
stringThe credit card type. - firstName
-
Type:
stringFirst name associated with this Payment Group. - lastName
-
Type:
stringLast name associated with this Payment Group. - paidAmount
-
Type:
numberThe amount that has been debited to-date for this Payment Group. - paymentGroupId
-
Type:
integerId of this payment Group. - paymentState
-
Type:
stringThe Payment Group state. - paymentStateDetailsAsUser
-
Type:
stringThe payment state description as string. - paymentStatString
-
Type:
stringThe payment state as a key string. - PONumber
-
Type:
stringPurchase order number for invoice payment. Payment type: invoice - refundAmount
-
Type:
numberThe amount that has been credited to-date for this Payment Group. - token
-
Type:
stringToken associated with this Payment Group. - totalDue
-
Type:
numberThe current working total order price including all discounts, tax, and billing costs. - uiIntervention
-
Type:
stringThis decides whether the client has to do some intervention for payment. e.g. SOP - zero_value_auto_authorized
-
Type:
stringThe Payment Group is auto authorized without any payment details for zero amount. e.g. true
Nested Schema : paymentGroups
Nested Schema : priceInfo
Type:
objectPrice information. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder.
- amount
-
Type:
numberThe raw number that represents the price. - currencyCode
-
Type:
stringIndicates the currency of the price. For example, USD indicates that the price is in US dollars. - shipping
-
Type:
numbershipping amount - subTotal
-
Type:
numberThe subtotal of the order before applying order-level promotions. - tax
-
Type:
numberThe tax on the order. - total
-
Type:
numberThe current working total, including all promotions, tax, and billing costs.
Nested Schema : pricingMessages
Type:
objectThe Pricing messages information. Related Endpoint operation - createOrder, priceOrder, submitOrder.
- GiftWithPurchaseMessages
-
Type:
arrayGiftWithPurchaseMessagesThe GWP messages information.
Nested Schema : profile
Type:
objectProfile Information for the order. Related Endpoint operations - submitOrder
-
Type:
stringEmail Address corresponding to the profile. - firstName
-
Type:
stringFirst name of profile. - isAnonymous
-
Type:
booleanIndicates whether this profile is an anonymous profile. By default, it is false. - lastName
-
Type:
stringLast name of profile. - middleName
-
Type:
stringMiddle name of profile. - organization
-
Type:
objectorganizationThe Organization associated with the B2B customer profile.
Nested Schema : returnRequests
Nested Schema : shippingAddress
Type:
objectShipping address. Related Endpoint operations - submitOrder
- address1
-
Type:
stringThe address1 of the shipping address. - address2
-
Type:
stringThe address2 of the shipping address. - address3
-
Type:
stringThe address3 of the shipping address. - city
-
Type:
stringThe city of the shipping address. - companyName
-
Type:
stringThe companyName. - country
-
Type:
stringThe country of the shipping address. - county
-
Type:
stringThe county of the shipping address. - DEFAULT_POSTAL_CODE_PATTERN
-
Type:
stringThe default post code pattern of the shipping address. -
Type:
stringemail of the shipping address. - faxNumber
-
Type:
stringThe faxNumber of the shipping address. - firstName
-
Type:
stringThe first name of the shipping address. - jobTitle
-
Type:
stringThe job title. - lastName
-
Type:
stringThe last name of the shipping address. - middleName
-
Type:
stringThe middle name of the shipping address. - phoneNumber
-
Type:
stringThe phone Number of the shipping address. - postalCode
-
Type:
stringThe postal Code of the shipping address. - prefix
-
Type:
stringprefix of shipping address name. - selectedCountry
-
Type:
stringThe selected country of the shipping address. - selectedState
-
Type:
stringThe selected state of the shipping address. - state
-
Type:
stringThe state of the shipping address. - state_ISOCode
-
Type:
stringThe state ISON code of the shipping address. - suffix
-
Type:
stringsuffix of the shipping address name.
Nested Schema : shippingGroups
Nested Schema : shippingMethod
Type:
objectShipping method information. Related Endpoint operation - priceOrder, submitOrder, preAuthorizeOrder.
- cost
-
Type:
integerShipping cost. - value
-
Type:
stringMethod type of shipment.
Nested Schema : shoppingCart
Type:
objectShopping cart information. Related Endpoint operation - createOrder, priceOrder, submitOrder, preAuthorizeOrder.
- items
-
Type:
arrayitemsItems in the cart. - numberOfItems
-
Type:
integernumber of items in an order.
Nested Schema : submittedOrders
Type:
arrayOrders submitted for fulfillment. Related Endpoint operations - resendOrdersForFulfillment
-
Type:
string
Nested Schema : taxPriceInfo
Type:
objectThe tax pricing details for the order. Related Endpoint operation - createOrder, priceOrder, submitOrder.
- amount
-
Type:
numberThe monetary amount. - amountIsFinal
-
Type:
booleanWhether the amount is final. - cityTax
-
Type:
numberThe monetary amount of city tax. - countryTax
-
Type:
numberThe monetary amount of country tax. - countyTax
-
Type:
numberThe monetary amount of county tax. - currencyCode
-
Type:
stringThe three character currency code. - discounted
-
Type:
booleanWhether the price was discounted. - districtTax
-
Type:
numberTax amount for the district. - stateTax
-
Type:
numberTax amount for the state.
Nested Schema : claimedCouponMultiPromotions
Type:
objectThe coupons that were claimed
- couponCode
-
Type:
arraycouponCodeCoupon Code, corresponding to which promotions were applied
Nested Schema : unclaimedCouponMultiPromotions
Type:
objectThe coupons that were not claimed
- couponCode
-
Type:
arraycouponCodeCoupon Code, corresponding to which some promotions were not applied
Nested Schema : couponCode
Nested Schema : items
Type:
object- promotionDesc
-
Type:
stringPromotion Description - promotionId
-
Type:
stringPromotion Id - promotionLevel
-
Type:
stringPromotion Level - totalAdjustment
-
Type:
numberAdjustment done by the promotion
Nested Schema : items
Type:
object- promotionDesc
-
Type:
stringDescription of the promotion. - promotionId
-
Type:
stringId of the promotion. - promotionLevel
-
Type:
stringLevel of the promotion. - totalAdjustment
-
Type:
stringTotal adjustment caused by the promotion.
Nested Schema : items
Type:
object- promotionDesc
-
Type:
stringDescription of the promotion. - promotionId
-
Type:
stringId of the promotion. - promotionLevel
-
Type:
stringLevel of the promotion. - totalAdjustment
-
Type:
stringTotal adjustment caused by the promotion.
Nested Schema : couponCode
Nested Schema : items
Type:
object- promotionDesc
-
Type:
stringPromotion Description - promotionId
-
Type:
stringPromotion Id - promotionLevel
-
Type:
stringPromotion Level
Nested Schema : items
Type:
object- couponInfo
-
Type:
arraycouponInfoThe coupon Info. - promotionValue
-
Type:
stringThe value for promotion.
Nested Schema : items
Type:
object- promotionDesc
-
Type:
stringDescription of the promotion. - promotionId
-
Type:
stringId of the promotion. - promotionLevel
-
Type:
stringLevel of the promotion. - totalAdjustment
-
Type:
stringTotal adjustment caused by the promotion.
Nested Schema : items
Type:
object- id
-
Type:
stringThe ID of the dynamic property. - value
-
Type:
stringThe value of the dynamic property.
Nested Schema : items
Type:
object- giftHashCode
-
Type:
stringThe gift hash code for the promotion - giftWithPurchaseDetail
-
Type:
stringString identifying the gift usually the repository ID of the gift type. - giftWithPurchaseIdentifier
-
Type:
integerAn 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:
numberQuantity of gift that the shopper still needs to select. - giftWithPurchaseType
-
Type:
stringThe type of gift like sku, product, category, skuContentGroup or productContentGroup. - promotionDesc
-
Type:
stringThe promotion description. - promotionId
-
Type:
stringThe gift with purchase promotion id
Nested Schema : items
Type:
object- automaticQuantity
-
Type:
numberThe quantity of free sku for this gift selection that has already been auto added to the order. - autoRemove
-
Type:
booleanFlag to indicate whether free gifts should be auto removed if the promotion no longer qualifies. - data
-
Type:
stringGift 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:
numberThe amount of automatic free quantity that failed to be added to the cart due to some pricing error, e.g. invalid site.. - giftDetail
-
Type:
stringString identifying the free gift, usually the repository id of the gift type. - giftType
-
Type:
stringThe type of gift like sku, product, category, skuContentGroup or productContentGroup. - key
-
Type:
stringatg.gwp. - quantity
-
Type:
numberThe total quantity of sku for this gift selection. - removedQuantity
-
Type:
numberThe amount of free quantity that has since been manually removed by a Shopper. - repositoryId
-
Type:
stringThe repository id of the gwp order marker. - selectedQuantity
-
Type:
numberThe quantity of free sku for this gift selection that has already been selected by the Shopper and added to the order. - targetedQuantity
-
Type:
numberThe quantity of free sku for this gift selection that has already been targeted and made free by the calculator in the order. - value
-
Type:
stringThe GWP promotion id.
Nested Schema : items
Type:
object- failureReason
-
Type:
stringFailure Reason. - orderId
-
Type:
stringOrder Id of the order whose submission has failed.
Nested Schema : items
Type:
object- comment
-
Type:
stringThe comment string. - creationDate
-
Type:
stringDate on which the comment was created. - repositoryId
-
Type:
stringThe repository id of the comment record.
Nested Schema : billingAddress
Type:
objectBilling address for the order.
- address1
-
Type:
stringAddress line 1 for this billing address. - address2
-
Type:
stringAddress line 2 for this billing address. - address3
-
Type:
stringAddress line 3 for this billing address. - city
-
Type:
stringCity for this billing address. - companyName
-
Type:
stringCompany name for this billing address. - country
-
Type:
stringCountry for this billing address. - county
-
Type:
stringCounty for this billing address. -
Type:
stringEmail for this billing address. - faxNumber
-
Type:
stringFax number for this billing address. - firstName
-
Type:
stringFirst name for this billing address. - jobTitle
-
Type:
stringJob title for this billing address. - lastName
-
Type:
stringLast name for this billing address. - middleName
-
Type:
stringMiddle name for this billing address. - phoneNumber
-
Type:
stringPhone number for this billing address. - postalCode
-
Type:
stringPostal code for this billing address. - prefix
-
Type:
stringPrefix for this billing address. - selectedCountry
-
Type:
stringThe selected country of the shipping address. - selectedState
-
Type:
stringThe selected state of the shipping address. - state
-
Type:
stringState for this billing address. - state_ISOCode
-
Type:
stringThe state ISON code of the shipping address. - suffix
-
Type:
stringSuffix for this billing address.
Nested Schema : items
Type:
object- amount
-
Type:
numberThe amount associated with this Payment Group. - amountAuthorized
-
Type:
numberThe amount authorized with this Payment Group. - billingAddress
-
Type:
objectbillingAddressBilling address for the order. - cardNumber
-
Type:
stringThe masked credit card number. - cardType
-
Type:
stringPayment method e.g. physicalGiftCard/creditCard - firstName
-
Type:
stringFirst name associated with this Payment Group. - IIN
-
Type:
stringThe 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:
stringLast name associated with this Payment Group. - paidAmount
-
Type:
numberThe amount that has been debited to-date for this Payment Group. - paymentGroupId
-
Type:
integerId of this payment Group. - paymentState
-
Type:
stringThe Payment Group state. - paymentStateDetailsAsUser
-
Type:
stringThe payment state description as string. - PONumber
-
Type:
stringPurchase order number for invoice payment. Payment type: invoice - refundAmount
-
Type:
numberThe amount that has been credited to-date for this Payment Group. - seqNum
-
Type:
stringSequence Number of the payment. In multiple paymnets, there are can be any number of payments. - token
-
Type:
stringToken associated with this Payment Group. - totalDue
-
Type:
numberThe current working total order price including all discounts, tax, and billing costs. - type
-
Type:
stringRequired:truePayment type e.g payULatamWebcheckout, paypalCheckout, card, invoice, physicalGiftCard - uiIntervention
-
Type:
stringThis decides whether the client has to do some intervention for payment. e.g. SOP - zero_value_auto_authorized
-
Type:
stringThe Payment Group is auto authorized without any payment details for zero amount. e.g. true
Nested Schema : billingAddress
Type:
objectBilling address for the order.
- address1
-
Type:
stringAddress line 1 for this billing address. - address2
-
Type:
stringAddress line 2 for this billing address. - address3
-
Type:
stringAddress line 3 for this billing address. - city
-
Type:
stringCity for this billing address. - companyName
-
Type:
stringCompany name for this billing address. - country
-
Type:
stringCountry for this billing address. - county
-
Type:
stringCounty for this billing address. -
Type:
stringEmail for this billing address. - faxNumber
-
Type:
stringFax number for this billing address. - firstName
-
Type:
stringFirst name for this billing address. - jobTitle
-
Type:
stringJob title for this billing address. - lastName
-
Type:
stringLast name for this billing address. - middleName
-
Type:
stringMiddle name for this billing address. - phoneNumber
-
Type:
stringPhone number for this billing address. - postalCode
-
Type:
stringPostal code for this billing address. - prefix
-
Type:
stringPrefix for this billing address. - selectedCountry
-
Type:
stringThe selected country of the shipping address. - selectedState
-
Type:
stringThe selected state of the shipping address. - state
-
Type:
stringState for this billing address. - state_ISOCode
-
Type:
stringThe state ISON code of the shipping address. - suffix
-
Type:
stringSuffix for this billing address.
Nested Schema : GiftWithPurchaseMessages
Nested Schema : items
Type:
object- identifier
-
Type:
stringThe pricing message identifier. - params
-
Type:
arrayparamsThe list of all message parameters. - priority
-
Type:
integerThe pricing message priority. - summary
-
Type:
stringThe pricing message summary. - type
-
Type:
stringThe pricing message type.
Nested Schema : items
Type:
object- promotionId
-
Type:
stringThe promotion id.
Nested Schema : organization
Type:
objectThe Organization associated with the B2B customer profile.
- id
-
Type:
stringThe id of the organization. - name
-
Type:
stringThe name of of the organization.
Nested Schema : items
Type:
object- createdDate
-
Type:
stringThe creation date of the return request. - returnRequestId
-
Type:
stringThe return request id. - state
-
Type:
stringThe status of the return request. - totalRefund
-
Type:
numberThe total amount to be refunded on return. - totalReturnQuantity
-
Type:
integerThe total quantity for which return request has been raised.
Nested Schema : items
Type:
object- items
-
Type:
arrayitemsItems in the cart. - shippingAddress
-
Type:
objectshippingAddressshipping address for the order. - shippingMethod
-
Type:
objectshippingMethodShipping method information. - trackingInfo
-
Type:
arraytrackingInfoTracking Information for the Order. - trackingNumber
-
Type:
stringShipping tracking number.
Nested Schema : shippingAddress
Type:
objectshipping address for the order.
- address1
-
Type:
stringAddress Line 1 for this shipping address. - address2
-
Type:
stringAddress Line 2 for this shipping address. - address3
-
Type:
stringAddress Line 3 for this shipping address. - city
-
Type:
stringCity for this shipping address. - companyName
-
Type:
stringCompany name for this shipping address. - country
-
Type:
stringCountry for this shipping address. - county
-
Type:
stringCounty for this shipping address. -
Type:
stringEmail for this shipping address. - faxNumber
-
Type:
stringFax number for this shipping address. - firstName
-
Type:
stringFirst name for this shipping address. - jobTitle
-
Type:
stringJob title for this shipping address. - lastName
-
Type:
stringLast name for this shipping address. - middleName
-
Type:
stringMiddle name for this shipping address. - phoneNumber
-
Type:
stringPhone number for this shipping address. - postalCode
-
Type:
stringPostal code for this shipping address. - prefix
-
Type:
stringPrefix for this shipping address. - selectedCountry
-
Type:
stringThe selected country of the shipping address. - selectedState
-
Type:
stringThe selected state of the shipping address. - state
-
Type:
stringState for this shipping address. - state_ISOCode
-
Type:
stringThe state ISON code of the shipping address. - suffix
-
Type:
stringSuffix for this shipping address.
Nested Schema : shippingMethod
Type:
objectShipping method information.
- cost
-
Type:
numbershipping cost. - displayName
-
Type:
stringDisplay Name of shipment. - value
-
Type:
stringmethod type of shipment.
Nested Schema : trackingInfo
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the item by the configurator system. - activationDate
-
Type:
stringThe activation date in ISO format. - assetId
-
Type:
stringThe asset ID corresponding to the current item. - availabilityDate
-
Type:
stringThe Availability date of commerce Item. - backOrderQuantity
-
Type:
numberBack Order Quantity of the Items. - billingAccountId
-
Type:
stringThe billing account ID associated to the current item. - catRefId
-
Type:
stringCatalog Reference Id of commerce item. - childItems
-
Type:
arraychildItemsChild items of the commerce item - commerceItemId
-
Type:
stringcommerce item id of the configurable product - configuratorId
-
Type:
stringconfigurator id of the configurable product - customerAccountId
-
Type:
stringThe customer account ID associated to the current item. - deactivationDate
-
Type:
stringThe deactivation date in ISO format. - discountInfo
-
Type:
objectdiscountInfoDiscount information. - displayName
-
Type:
stringDisplay name of commerce item. - dynamicProperties
-
Type:
arraydynamicPropertiesArray of custom properties at order line item level. - externalData
-
Type:
arrayexternalDataExternal data to be associated with a commerce item, provided by a configurator system. - externalPrice
-
Type:
numberThe Price of the product as per the external pricing system. - externalPriceQuantity
-
Type:
integerQuantity of the product, the customer is allowed to buy at the external price. - imageInfo
-
Type:
objectimageInfoShipping method information. - onSale
-
Type:
booleanindicates if product is on sale or not. - preOrderQuantity
-
Type:
numberPre Order Quantity of the Items. - price
-
Type:
numberThe raw number that represents the price. - quantity
-
Type:
numberQuantity of the items. - rawTotalPrice
-
Type:
numberThe raw total price. - returnedQuantity
-
Type:
numberQuantity for which return request has been raised. - serviceAccountId
-
Type:
stringThe service account ID associated to the current item. - serviceId
-
Type:
stringThe service ID associated to the current item. - status
-
Type:
integerState of the commerce item. - subTotal
-
Type:
numberThe base price for the item, before any modifications. Calculated by multiplying the quantity by the listPrice. - tax
-
Type:
numberThe amount of tax paid for this item. - unitPrice
-
Type:
numberSale price or list price of commerceItem. - variant
-
Type:
arrayvariantProduct Variant Information.
Nested Schema : discountInfo
Type:
objectDiscount information.
- orderCouponsMap
-
Type:
arrayorderCouponsMapMap of coupons. - orderDiscount
-
Type:
numberDiscount given on an order. - orderImplicitDiscountList
-
Type:
arrayorderImplicitDiscountListList of discounts. - unclaimedCouponsMap
-
Type:
arrayunclaimedCouponsMapMap of unclaimed coupons.
Nested Schema : dynamicProperties
Nested Schema : externalData
Nested Schema : imageInfo
Type:
objectShipping method information.
- primaryThumbImageURL
-
Type:
stringThumbNail Image URL
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the item by the configurator system. - activationDate
-
Type:
stringThe activation date in ISO format. - assetId
-
Type:
stringThe asset ID corresponding to the current item. - billingAccountId
-
Type:
stringThe billing account ID associated to the current item. - catRefId
-
Type:
stringSku Id of the child item - childItems
-
Type:
arraychildItemsChild items of the commerce item - customerAccountId
-
Type:
stringThe customer account ID associated to the current item. - deactivationDate
-
Type:
stringThe deactivation date in ISO format. - displayName
-
Type:
stringDisplay name of the child product - externalData
-
Type:
arrayexternalDataExternal data to be associated with a commerce item, provided by a configurator system. - productId
-
Type:
stringProduct Id of the child item - quantity
-
Type:
numberQuantity of the child item - route
-
Type:
stringImage route - selectedOptions
-
Type:
arrayselectedOptionsThe array of variants of the child item. - serviceAccountId
-
Type:
stringThe service account ID associated to the current item. - serviceId
-
Type:
stringThe service ID associated to the current item.
Nested Schema : externalData
Nested Schema : selectedOptions
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the item by the configurator system. - activationDate
-
Type:
stringThe activation date in ISO format. - assetId
-
Type:
stringThe asset ID corresponding to the current item. - billingAccountId
-
Type:
stringThe billing account ID associated to the current item. - catRefId
-
Type:
stringSku Id of the child item - customerAccountId
-
Type:
stringThe customer account ID associated to the current item. - deactivationDate
-
Type:
stringThe deactivation date in ISO format. - displayName
-
Type:
stringDisplay name of the child product - externalData
-
Type:
arrayexternalDataExternal data to be associated with a commerce item, provided by a configurator system. - productId
-
Type:
stringProduct Id of the child item - quantity
-
Type:
numberQuantity of the child item - route
-
Type:
stringImage route - selectedOptions
-
Type:
arrayselectedOptionsThe array of variants of the child item. - serviceAccountId
-
Type:
stringThe service account ID associated to the current item. - serviceId
-
Type:
stringThe service ID associated to the current item.
Nested Schema : externalData
Nested Schema : selectedOptions
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the externalData item by the configurator system. - name
-
Type:
stringThe name to be associated with the externalData item. - values
-
Type:
objectvaluesThe array of values associated with an externalData item.
Nested Schema : values
Type:
objectThe array of values associated with an externalData item.
- dynamic_property_key
-
Type:
stringThis property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object- optionName
-
Type:
stringThe varian option name. - optionValue
-
Type:
stringThe variant option value
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the externalData item by the configurator system. - name
-
Type:
stringThe name to be associated with the externalData item. - values
-
Type:
objectvaluesThe array of values associated with an externalData item.
Nested Schema : values
Type:
objectThe array of values associated with an externalData item.
- dynamic_property_key
-
Type:
stringThis property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object- optionName
-
Type:
stringThe varian option name. - optionValue
-
Type:
stringThe variant option value
Nested Schema : items
Type:
object- promotionDesc
-
Type:
stringDescription of the promotion. - promotionId
-
Type:
stringId of the promotion. - promotionLevel
-
Type:
stringLevel of the promotion. - totalAdjustment
-
Type:
stringTotal adjustment caused by the promotion.
Nested Schema : items
Type:
object- promotionDesc
-
Type:
stringDescription of the promotion. - promotionId
-
Type:
stringId of the promotion. - promotionLevel
-
Type:
stringLevel of the promotion. - totalAdjustment
-
Type:
stringTotal adjustment caused by the promotion.
Nested Schema : items
Type:
object- couponInfo
-
Type:
arraycouponInfoThe coupon Info. - promotionValue
-
Type:
stringThe value for promotion.
Nested Schema : items
Type:
object- promotionDesc
-
Type:
stringDescription of the promotion. - promotionId
-
Type:
stringId of the promotion. - promotionLevel
-
Type:
stringLevel of the promotion. - totalAdjustment
-
Type:
stringTotal adjustment caused by the promotion.
Nested Schema : items
Type:
object- id
-
Type:
stringThe ID of the dynamic property. - label
-
Type:
stringThe label of the dynamic property. - value
-
Type:
stringThe value of the dynamic property.
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the externalData item by the configurator system. - name
-
Type:
stringThe name to be associated with the externalData item. - values
-
Type:
objectvaluesThe array of values associated with an externalData item.
Nested Schema : values
Type:
objectThe array of values associated with an externalData item.
- dynamic_property_key
-
Type:
stringThis property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object- optionName
-
Type:
stringName of the Dynamic attribute. - optionValue
-
Type:
stringValue of the Dynamic attribute.
Nested Schema : items
Type:
object- carrierId
-
Type:
stringCarrier Id for Tracking. - carrierName
-
Type:
stringCarrier Name for Tracking. - carrierUrl
-
Type:
stringCarrier URL for Tracking. - trackingNumber
-
Type:
stringTracking Number.
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the item by the configurator system. - availabilityDate
-
Type:
stringThe Availability date of commerce Item. - backOrderQuantity
-
Type:
numberBack Order Quantity of the Items. - catRefId
-
Type:
stringcatRefId of the product. - childItems
-
Type:
arraychildItemsChild items of the commerce item - commerceItemId
-
Type:
stringcommerce item id of the configurable product - configuratorId
-
Type:
stringconfigurator id of the configurable product - discountInfo
-
Type:
objectdiscountInfoDiscount information. - dynamicProperties
-
Type:
arraydynamicPropertiesArray of custom properties at order line item level. - externalData
-
Type:
arrayexternalDataExternal data to be associated with a commerce item, provided by a configurator system. - externalPrice
-
Type:
numberThe Price of the product as per the external pricing system. - externalPriceQuantity
-
Type:
integerQuantity of the product, the customer is allowed to buy at the external price. - giftWithPurchaseCommerceItemMarkers
-
Type:
arraygiftWithPurchaseCommerceItemMarkersThe array of giftWithPurchaseCommerceItemMarkers. - isPriceOverridden
-
Type:
booleanIndicates if commerce item price is overridden or not. - onSale
-
Type:
booleanindicates if product is on sale or not. - overriddenPrice
-
Type:
numberoverridden price of commerce item. - preOrderQuantity
-
Type:
numberPre Order Quantity of the Items. - price
-
Type:
numberprice of the product. - priceOverridenBy
-
Type:
stringName of the agent who has overridden item price. - priceOverrideReason
-
Type:
objectpriceOverrideReasonPrice override reason map - productId
-
Type:
stringId of the product. - quantity
-
Type:
integerquantity of the product. - unitPrice
-
Type:
numberunit price of the product.
Nested Schema : discountInfo
Type:
objectDiscount information.
- gwpSelections
-
Type:
arraygwpSelectionsThe gift information. - orderCouponsMap
-
Type:
arrayorderCouponsMapMap of coupons. - orderDiscount
-
Type:
numberDiscount given on an order. - orderImplicitDiscountList
-
Type:
arrayorderImplicitDiscountListList of discounts. - unclaimedCouponsMap
-
Type:
arrayunclaimedCouponsMapMap of unclaimed coupons.
Nested Schema : dynamicProperties
Nested Schema : externalData
Nested Schema : giftWithPurchaseCommerceItemMarkers
Nested Schema : priceOverrideReason
Type:
objectPrice override reason map
- displayValue
-
Type:
stringprice override reason value - key
-
Type:
stringprice override reason key
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the item by the configurator system. - activationDate
-
Type:
stringThe activation date in ISO format. - assetId
-
Type:
stringThe asset ID corresponding to the current item. - billingAccountId
-
Type:
stringThe billing account ID associated to the current item. - catRefId
-
Type:
stringSku Id of the child item - childItems
-
Type:
arraychildItemsChild items of the commerce item - customerAccountId
-
Type:
stringThe customer account ID associated to the current item. - deactivationDate
-
Type:
stringThe deactivation date in ISO format. - displayName
-
Type:
stringDisplay name of the child product - externalData
-
Type:
arrayexternalDataExternal data to be associated with a commerce item, provided by a configurator system. - productId
-
Type:
stringProduct Id of the child item - quantity
-
Type:
numberQuantity of the child item - route
-
Type:
stringImage route - selectedOptions
-
Type:
arrayselectedOptionsThe array of variants of the child item. - serviceAccountId
-
Type:
stringThe service account ID associated to the current item. - serviceId
-
Type:
stringThe service ID associated to the current item.
Nested Schema : externalData
Nested Schema : selectedOptions
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the item by the configurator system. - activationDate
-
Type:
stringThe activation date in ISO format. - assetId
-
Type:
stringThe asset ID corresponding to the current item. - billingAccountId
-
Type:
stringThe billing account ID associated to the current item. - catRefId
-
Type:
stringSku Id of the child item - customerAccountId
-
Type:
stringThe customer account ID associated to the current item. - deactivationDate
-
Type:
stringThe deactivation date in ISO format. - displayName
-
Type:
stringDisplay name of the child product - externalData
-
Type:
arrayexternalDataExternal data to be associated with a commerce item, provided by a configurator system. - productId
-
Type:
stringProduct Id of the child item - quantity
-
Type:
numberQuantity of the child item - route
-
Type:
stringImage route - selectedOptions
-
Type:
arrayselectedOptionsThe array of variants of the child item. - serviceAccountId
-
Type:
stringThe service account ID associated to the current item. - serviceId
-
Type:
stringThe service ID associated to the current item.
Nested Schema : externalData
Nested Schema : selectedOptions
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the externalData item by the configurator system. - name
-
Type:
stringThe name to be associated with the externalData item. - values
-
Type:
objectvaluesThe array of values associated with an externalData item.
Nested Schema : values
Type:
objectThe array of values associated with an externalData item.
- dynamic_property_key
-
Type:
stringThis property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object- optionName
-
Type:
stringThe varian option name. - optionValue
-
Type:
stringThe variant option value
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the externalData item by the configurator system. - name
-
Type:
stringThe name to be associated with the externalData item. - values
-
Type:
objectvaluesThe array of values associated with an externalData item.
Nested Schema : values
Type:
objectThe array of values associated with an externalData item.
- dynamic_property_key
-
Type:
stringThis property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object- optionName
-
Type:
stringThe varian option name. - optionValue
-
Type:
stringThe variant option value
Nested Schema : items
Type:
object- giftChoicesAvailable
-
Type:
booleanBoolean to show if there are any gift choices for selection. - giftHashCode
-
Type:
integerThe gift hash code for this GWP promotion. - giftQuantity
-
Type:
numberThe quantity that is gift quantity
Nested Schema : items
Type:
object- promotionDesc
-
Type:
stringDescription of the promotion. - promotionId
-
Type:
stringId of the promotion. - promotionLevel
-
Type:
stringLevel of the promotion. - totalAdjustment
-
Type:
stringTotal adjustment caused by the promotion.
Nested Schema : items
Type:
object- promotionDesc
-
Type:
stringDescription of the promotion. - promotionId
-
Type:
stringId of the promotion. - promotionLevel
-
Type:
stringLevel of the promotion. - totalAdjustment
-
Type:
stringTotal adjustment caused by the promotion.
Nested Schema : items
Type:
object- couponInfo
-
Type:
arraycouponInfoThe coupon Info. - promotionValue
-
Type:
stringThe value for promotion.
Nested Schema : items
Type:
object- promotionDesc
-
Type:
stringDescription of the promotion. - promotionId
-
Type:
stringId of the promotion. - promotionLevel
-
Type:
stringLevel of the promotion. - totalAdjustment
-
Type:
stringTotal adjustment caused by the promotion.
Nested Schema : items
Type:
object- id
-
Type:
stringThe ID of the dynamic property. - label
-
Type:
stringThe label of the dynamic property. - value
-
Type:
stringThe value of the dynamic property.
Nested Schema : items
Type:
object- actionCode
-
Type:
stringThe action code that has been set on the externalData item by the configurator system. - activationDate
-
Type:
stringThe activation date in ISO format. - assetId
-
Type:
stringThe asset ID corresponding to the current item. - billingAccountId
-
Type:
stringThe billing account ID associated to the current item. - customerAccountId
-
Type:
stringThe customer account ID associated to the current item. - deactivationDate
-
Type:
stringThe deactivation date in ISO format. - name
-
Type:
stringThe name to be associated with the externalData item. - serviceAccountId
-
Type:
stringThe service account ID associated to the current item. - serviceId
-
Type:
stringThe service ID associated to the current item. - values
-
Type:
objectvaluesThe array of values associated with an externalData item.
Nested Schema : values
Type:
objectThe array of values associated with an externalData item.
- dynamic_property_key
-
Type:
stringThis property's name and value will be retrieved from a configurator system, so will be dynamically set.
Nested Schema : items
Type:
object- automaticQuantity
-
Type:
numberThe quantity of the free gift that this commerce item is making free and was auto added by pricing. - data
-
Type:
integerThe gift hash code for this GWP promotion. - key
-
Type:
stringatg.gwp - remainingQuantity
-
Type:
numberThe quantity of the commerce item that is not affected by GWP. - selectedQuantity
-
Type:
numberThe quantity of the free gift that this commerce item is making free and was selected by the shopper. - targetedQuantity
-
Type:
numberThe quantity of the free gift that this commerce item is making free and was targeted by pricing. - value
-
Type:
stringThe 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:
stringAn optional non-localized message containing technical information for developers - errorCode
-
Type:
stringThe numerical code identifying the error - errors
-
Type:
arrayerrorsAn optional list of errors if multiple errors were encountered - message
-
Type:
stringThe localized message describing the error - moreInfo
-
Type:
stringAn optional non-localized message with more information - o:errorPath
-
Type:
stringAn optional machine readable description of where the error occurred - status
-
Type:
stringThe HTTP status code - type
-
Type:
stringThe URI to the HTTP state code definition
Nested Schema : errors
Nested Schema : items
Type:
object- devMessage
-
Type:
stringAn optional non-localized message containing technical information for developers - errorCode
-
Type:
stringThe numerical code identifying the error - message
-
Type:
stringThe localized message describing the error - moreInfo
-
Type:
stringAn optional non-localized message with more information - o:errorPath
-
Type:
stringAn optional machine readable description of where the error occurred - status
-
Type:
stringThe 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": []
}