requestQuote

post

/ccagent/v1/orders/quote

Request Quote. Request for a quote on an incomplete order or request for a requote on a quoted order. 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
Header Parameters
Body ()
Root Schema : requestQuote_request
Type: object
Show Source
Example:
{
    "note":"This is a sample quote request"
}
Nested Schema : appliedPromotions
Type: array
The array of applied promotions. If not supplied, it utilizes the promotions in the current incomplete order.
Show Source
Nested Schema : shippingAddress
Type: object
The shipping address details. If not supplied, it utilizes the shipping address in the current incomplete order.
Show Source
Nested Schema : shippingGroups
Type: array
The shipping groups for the order. If not supplied, it utilizes the shipping groups in the current incomplete order.
Show Source
Nested Schema : shippingMethod
Type: object
The shipping method details for the order. If not supplied, it utilizes the shipping method in the current incomplete order.
Show Source
Nested Schema : shoppingCart
Type: object
The shopping cart contents of the current order. If not supplied, it utilizes the items in the current incomplete order.
Show Source
Nested Schema : items
Type: object
Show Source
  • The email address of the person picking up the items in store (if type is inStorePickupShippingGroup).
  • The first name of the person picking up the items in store (if type is inStorePickupShippingGroup).
  • items
    The array of products in the shipping group.
  • The last name of the person picking up the items in store (if type is inStorePickupShippingGroup).
  • The location ID of the store from which items are to be picked up (if type is inStorePickupShippingGroup) or hardgoodShippingGroup location ID.
  • The middle name of the person picking up the items in store (if type is inStorePickupShippingGroup).
  • The phone number of the person picking up the items in store (if type is inStorePickupShippingGroup).
  • shippingAddress
    The shipping address details.
  • shippingMethod
    The shipping method details for the order.
  • The type of shipping group to create, e.g. hardgoodShippingGroup, inStorePickupShippingGroup, inStoreTakeWithShippingGroup, virtualShippingGroup
Nested Schema : items
Type: array
The array of products in the shipping group.
Show Source
Nested Schema : shippingAddress
Type: object
The shipping address details.
Show Source
Nested Schema : shippingMethod
Type: object
The shipping method details for the order.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : coupons
Type: array
The array of coupons applied to the order.
Show Source
Nested Schema : items
Type: array
The array of products in the shopping cart.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : childItems
Type: array
The array of child items in the item, if the item is a configurable item. A child item can itself contain a child item array if it is a configurable product in itself.
Show Source
Nested Schema : detailedRecurringChargeInfo
Type: object
Detailed Item Price Information.
Show Source
Nested Schema : externalData
Type: array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : giftWithPurchaseSelections
Type: array
The array of gift with purchase selections to be made.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : detailedRecurringChargeInfo
Type: object
Detailed Item Price Information.
Show Source
Nested Schema : externalData
Type: array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : values
Type: object
The array of values associated with an externalData item.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : values
Type: object
The array of values associated with an externalData item.
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top

Response

Supported Media Types

200 Response

Following model is returned when operation succeeds.
Body ()
Root Schema : requestQuote_response
Type: object
Show Source
Nested Schema : discountInfo
Type: object
The discount information.
Show Source
Nested Schema : dynamicProperties
Type: array
Read-only list of dynamic properties for the order along with meta-data.
Show Source
Nested Schema : giftWithPurchaseOrderMarkers
Type: array
gift with purchase order marker information
Show Source
Nested Schema : markers
Type: array
Order markers.
Show Source
Nested Schema : payments
Type: object
Payment details for the order, including additional properties specific to the payment type. This should be an empty array for request of a quote.
Show Source
Nested Schema : priceInfo
Type: object
The price information.
Show Source
Nested Schema : priceListGroup
Type: object
The price list group object.
Show Source
Nested Schema : quoteInfo
Type: object
the quote information of the order
Show Source
Nested Schema : recurringChargePriceInfo
Type: object
Recurring charge price information.
Show Source
Nested Schema : shippingAddress
Type: object
The shipping address details.
Show Source
Nested Schema : shippingGroups
Type: array
The shipping groups for the order.
Show Source
Nested Schema : shippingMethod
Type: object
The shipping method details for the order.
Show Source
Nested Schema : shoppingCart
Type: object
The shopping cart contents of the current order.
Show Source
Nested Schema : taxPriceInfo
Type: object
tax price information for the order
Show Source
Nested Schema : orderDiscountDescList
Type: array
The list of all the order discounts.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
  • The ID of the dynamic property.
  • The label of the dynamic property.
  • The value of the dynamic property. The value type depends on how the dynamic property was defined and might be something other than string, such as boolean or number.
Nested Schema : items
Type: object
Show Source
  • The quantity of free sku for this gift selection that has already been auto added to the order.
  • Flag to indicate whether free gifts should be auto removed if the promotion no longer qualifies.
  • Gift hash code to track which gift selection in the promotion this is. It allows the commerce item marker to link to this one.
  • The amount of automatic free quantity that failed to be added to the cart due to some pricing error, e.g. invalid site.
  • String identifying the free gift, usually the repository ID of the gift type.
  • The type of the gift. (sku, product)
  • atg.gwp
  • The total quantity of sku for this gift selection.
  • The amount of free quantity that has since been manually removed by a Shopper.
  • The quantity of free sku for this gift selection that has already been selected by the Shopper and added to the order.
  • The quantity of free sku for this gift selection that has already been targeted and made free by the calculator in the order.
  • The gift with purchase promotion ID
Nested Schema : items
Type: object
Show Source
  • Order marker key. In a marketing campaign marker, a key signifies that it is a campaign marker. Also, it identifies the external marketing system that is the source of the campaign, e.g., campaign_eloqua
  • Order marker value. In the case of a marketing campaign, it represents the actual unique campaign ID
Nested Schema : errorInfo
Type: array
the array of errors, if any
Show Source
Nested Schema : notes
Type: array
the notes (history) for the order
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : frequencyAmountTotals
Type: array
The total for each recurring charge frequency
Show Source
Nested Schema : frequencyTaxTotals
Type: array
The tax for each recurring charge frequency
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: array
The array of products in the shipping group.
Show Source
Nested Schema : priceInfo
Type: object
The price information.
Show Source
Nested Schema : recurringChargePriceInfo
Type: object
Recurring charge price information.
Show Source
Nested Schema : shippingAddress
Type: object
The shipping address details.
Show Source
Nested Schema : shippingMethod
Type: object
The shipping method details for the order.
Show Source
Nested Schema : store
Type: object
Information about the Store from which items are being picked up from (if shipping group type is inStorePickupShippingGroup)
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : detailedRecurringChargeInfo
Type: object
Detailed Item Price Information.
Show Source
Nested Schema : discountInfo
Type: array
The discount information.
Show Source
Nested Schema : dynamicProperties
Type: array
Array of custom properties at order line item level.
Show Source
Nested Schema : externalData
Type: array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : variant
Type: array
List of variants for the product.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
  • The ID of the dynamic property.
  • The label of the dynamic property.
  • The value of the dynamic property. The value type depends on how the dynamic property was defined and might be something other than string, such as boolean or number.
Nested Schema : items
Type: object
Show Source
Nested Schema : values
Type: object
The array of values associated with an externalData item.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : frequencyAmountTotals
Type: array
The total for each recurring charge frequency
Show Source
Nested Schema : frequencyTaxTotals
Type: array
The tax for each recurring charge frequency
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: array
The array of products in the shopping cart.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : childItems
Type: array
The array of child items in the item, if the item is a configurable item. A child item can itself contain a child item array if it is a configurable product in itself.
Show Source
Nested Schema : detailedRecurringChargeInfo
Type: object
Detailed Item Price Information.
Show Source
Nested Schema : discountInfo
Type: array
The discount information.
Show Source
Nested Schema : dynamicProperties
Type: array
Array of custom properties at order line item level.
Show Source
Nested Schema : externalData
Type: array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : externalData
Type: array
External data to be associated with a commerce item, provided by a configurator system.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : values
Type: object
The array of values associated with an externalData item.
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
  • The ID of the dynamic property.
  • The label of the dynamic property.
  • The value of the dynamic property. The value type depends on how the dynamic property was defined and might be something other than string, such as boolean or number.
Nested Schema : items
Type: object
Show Source
Nested Schema : values
Type: object
The array of values associated with an externalData item.
Show Source
Example Response (application/json)
{
    "creationTime":"1478607046000",
    "orderComments":[
    ],
    "sourceSystem":"Cloud Commerce",
    "dynamicProperties":[
    ],
    "stateString":"PENDING_QUOTE",
    "paymentGroups":[
    ],
    "priceInfo":{
        "amount":1858.99,
        "total":2045.51,
        "shipping":35,
        "shippingSurchargeValue":0,
        "tax":151.52,
        "subTotal":1858.99,
        "currencyCode":"USD",
        "totalWithoutTax":1893.99
    },
    "submissionProgress":[
    ],
    "pricingMessages":{
    },
    "shoppingCart":{
        "items":[
            {
                "deactivationDate":"2018-06-27T12:59:59Z",
                "rawTotalPrice":1858.99,
                "returnedQuantity":0,
                "displayName":"Dr. Dolittle",
                "shippingSurchargeValue":0,
                "externalData":[
                ],
                "billingProfileId":"billingProfile-123",
                "discountAmount":0,
                "billingAccountId":"billingAcc-123",
                "imageInfo":{
                    "primaryThumbImageURL":"/ccstore/v1/images/?source=/file/v6155711626513500309/products/doctordolittle_LARGE.jpg&height=100&width=100"
                },
                "assetKey":"12345",
                "externalPrice":922,
                "price":1858.99,
                "variant":[
                ],
                "onSale":false,
                "actionCode":"Add",
                "serviceId":"service-123",
                "stateDetailsAsUser":"Added to order",
                "serviceAccountId":"serviceAcc-123",
                "unitPrice":14.99,
                "quantity":3,
                "productId":"Product_18Cxi",
                "salePrice":0,
                "detailedItemPriceInfo":[
                    {
                        "discounted":false,
                        "amount":1844,
                        "quantity":2,
                        "tax":147.52,
                        "orderDiscountShare":0,
                        "detailedUnitPrice":922,
                        "currencyCode":"USD"
                    },
                    {
                        "discounted":false,
                        "amount":14.99,
                        "quantity":1,
                        "tax":1.2,
                        "orderDiscountShare":0,
                        "detailedUnitPrice":14.99,
                        "currencyCode":"USD"
                    }
                ],
                "giftWithPurchaseCommerceItemMarkers":[
                ],
                "parentAssetKey":null,
                "originalCommerceItemId":"o30417",
                "tax":147.52,
                "rootAssetKey":null,
                "externalPriceQuantity":2,
                "transactionDate":"2018-06-27T12:59:59Z",
                "catRefId":"Sku_18Dxi",
                "customerAccountId":"customerAcc-123",
                "discountInfo":[
                ],
                "siteId":"siteUS",
                "stateDescription":"INITIAL",
                "activationDate":"2017-06-27T15:30:00Z",
                "asset":false,
                "listPrice":14.99,
                "status":0
            }
        ]
    },
    "links":[
        {
            "rel":"self",
            "href":"http://localhost:9080/ccagentui/v1/orders/quote"
        }
    ],
    "id":"o90412",
    "state":4004,
    "quoteInfo":{
        "providerNote":null,
        "notes":[
            {
                "profileType":null,
                "profileId":"se-570031",
                "requestDate":"2016-11-08T12:48:11.481Z",
                "requesterNote":"hi"
            }
        ],
        "rejectionDate":null,
        "requestDate":"2016-11-08T12:48:11.481Z",
        "errorInfo":null,
        "externalId":null,
        "rejectionNote":null,
        "quoteDate":null,
        "expirationDate":null
    },
    "stateDetailsAsUser":"This quote is pending",
    "taxPriceInfo":{
        "cityTax":0,
        "amount":151.52,
        "valueAddedTax":0,
        "countyTax":75.76,
        "isTaxIncluded":false,
        "miscTax":0,
        "districtTax":0,
        "stateTax":75.76,
        "countryTax":0
    },
    "shippingGroups":[
        {
            "taxPriceInfo":{
                "cityTax":0,
                "amount":151.52,
                "valueAddedTax":0,
                "countyTax":75.76,
                "isTaxIncluded":false,
                "miscTax":0,
                "districtTax":0,
                "stateTax":75.76,
                "countryTax":0
            },
            "shippingMethod":{
                "shippingTax":2.8,
                "cost":35,
                "displayName":"Standard",
                "value":"standardShippingMethod",
                "shippingMethodDescription":"Standard"
            },
            "shippingGroupId":"sg100412",
            "submittedDate":null,
            "priceInfo":{
                "amount":1858.99,
                "total":2045.51,
                "shipping":35,
                "shippingSurchargeValue":0,
                "tax":151.52,
                "subTotal":1858.99,
                "currencyCode":"USD",
                "totalWithoutTax":1893.99
            },
            "discountInfo":{
                "orderDiscount":0,
                "shippingDiscount":0,
                "discountDescList":[
                ]
            },
            "shipOnDate":null,
            "trackingInfo":[
            ],
            "actualShipDate":null,
            "locationId":"SiteUS-GlenAllen187",
            "siteId":"siteUS",
            "shippingAddress":{
                "lastName":"Anderson",
                "country":"US",
                "address3":"",
                "address2":"",
                "city":"Syracuse",
                "prefix":"",
                "address1":"21 Cedar Ave",
                "postalCode":"13202",
                "companyName":"",
                "jobTitle":"",
                "county":"",
                "suffix":"",
                "selectedCountry":"US",
                "firstName":"Kim",
                "phoneNumber":"212-555-1977",
                "stateName":"New York",
                "faxNumber":"",
                "alias":"Home",
                "middleName":"",
                "state":"NY",
                "countryName":"United States",
                "email":"kim@example.com",
                "selectedState":"NY",
                "state_ISOCode":"US-NY"
            },
            "items":[
                {
                    "primaryThumbImageURL":"/ccstore/v1/images/?source=/file/v6155711626513500309/products/doctordolittle_LARGE.jpg&height=100&width=100",
                    "deactivationDate":"2018-06-27T12:59:59Z",
                    "rawTotalPrice":44.97,
                    "returnedQuantity":0,
                    "displayName":"Dr. Dolittle",
                    "shippingSurchargeValue":0,
                    "discountAmount":0,
                    "externalData":[
                    ],
                    "billingProfileId":"billingProfile-123",
                    "billingAccountId":"billingAcc-123",
                    "assetKey":"12345",
                    "externalPrice":922,
                    "price":1858.99,
                    "variant":[
                    ],
                    "onSale":false,
                    "primaryImageAltText":"Dr. Dolittle",
                    "actionCode":"Add",
                    "serviceId":"service-123",
                    "stateDetailsAsUser":"The item has been initialized within the shipping group",
                    "serviceAccountId":"serviceAcc-123",
                    "unitPrice":14.99,
                    "primaryImageTitle":"Dr. Dolittle",
                    "quantity":3,
                    "pointOfNoRevision":false,
                    "relationshipType":"SHIPPINGQUANTITY",
                    "productId":"Product_18Cxi",
                    "salePrice":0,
                    "detailedItemPriceInfo":[
                        {
                            "discounted":false,
                            "amount":1844,
                            "quantity":2,
                            "tax":147.52,
                            "orderDiscountShare":0,
                            "detailedUnitPrice":922,
                            "currencyCode":"USD"
                        },
                        {
                            "discounted":false,
                            "amount":14.99,
                            "quantity":1,
                            "tax":1.2,
                            "orderDiscountShare":0,
                            "detailedUnitPrice":14.99,
                            "currencyCode":"USD"
                        }
                    ],
                    "parentAssetKey":null,
                    "active":true,
                    "rootAssetKey":null,
                    "externalPriceQuantity":2,
                    "transactionDate":"2018-06-27T12:59:59Z",
                    "catRefId":"Sku_18Dxi",
                    "customerAccountId":"customerAcc-123",
                    "discountInfo":[
                    ],
                    "route":"/product/Product_18Cxi",
                    "siteId":"siteUS",
                    "activationDate":"2017-06-27T15:30:00Z",
                    "asset":false,
                    "listPrice":14.99,
                    "status":"INITIAL"
                }
            ],
            "trackingNumber":null,
            "status":"INITIAL"
        }
    ],
    "creationSiteId":"siteUS",
    "approvalSystemMessages":[
        "Order is pending approval because total is greater than the approved order limit."
    ],
    "shippingMethod":{
        "shippingTax":2.8,
        "cost":35,
        "displayName":"Standard",
        "value":"standardShippingMethod",
        "shippingMethodDescription":"Standard"
    },
    "profile":{
        "firstName":"Kim",
        "lastName":"Anderson",
        "middleName":null,
        "email":"kim@example.com"
    },
    "priceListGroup":{
        "repositoryId":"defaultPriceGroup"
    },
    "returnRequests":[
    ],
    "creationDate":"2016-11-08T12:10:46.000Z",
    "OrderAction":"order",
    "submissionErrorCodes":[
    ],
    "discountInfo":{
        "unclaimedCouponMultiPromotions":{
        },
        "orderCouponsMap":{
        },
        "orderDiscount":0,
        "shippingDiscount":0,
        "orderImplicitDiscountList":[
        ],
        "unclaimedCouponsMap":{
        },
        "claimedCouponMultiPromotions":{
        }
    },
    "submissionErrorMessages":[
    ],
    "profileId":"se-570031",
    "exchangeRequests":[
    ],
    "giftWithPurchaseInfo":[
    ],
    "siteId":"siteUS",
    "shippingAddress":{
        "lastName":"Anderson",
        "country":"US",
        "address3":"",
        "address2":"",
        "city":"Syracuse",
        "prefix":"",
        "address1":"21 Cedar Ave",
        "postalCode":"13202",
        "companyName":"",
        "jobTitle":"",
        "county":"",
        "suffix":"",
        "selectedCountry":"US",
        "firstName":"Kim",
        "phoneNumber":"212-555-1977",
        "stateName":"New York",
        "faxNumber":"",
        "alias":"Home",
        "middleName":"",
        "state":"NY",
        "countryName":"United States",
        "email":"kim@example.com",
        "selectedState":"NY",
        "state_ISOCode":"US-NY"
    },
    "markers":[
    ],
    "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| |------------------|------------------| |100094|Organization passed in the header is currently inactive| |100095|The order or return request does not belong to the current organization of the shopper profile| |100096|The organization associated to the order or return request was deleted / does not exist| |100097|The organization associated to the order or return request is currently inactive| |100098|Current operation is being performed in an organization context and the shopper profile is not associated to any organization| |100099|Current operation is being performed in an organization context and the order or return request does not belong to any organization| |28107|If no order is found of the order id which is mentioned in request paylaod.| |200106|No order data specified| |200105|No Order id specified in request.| |28315|Error occurred while updating the order.| |200115|Error occurred at the time of pricing.| |28364|Error occurred when quote is not allowed.| |30015|SiteId passed in x-ccsite header is currently inactive| |30014|SiteId passed in x-ccsite header is invalid or the site was deleted| |28365|Error occurred while requesting for quote| |28300|Internal error while creating the order| |100101|The shopper profile does not belong to organization passed in the header|
Body ()
Root Schema : errorModel
Type: object
Show Source
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top