Shipping-quote service provides details of shipping and shipping options such as shipping cost with different shipping methods from the nearest facility to the ship-to address. The response will include box count and box weight for the specified product combination.
Shipping-quote requires details of the product as well as details of the Ship-To address.

NOTE:

Shipping-quote service takes an optional “sets” parameter to identify number of sets of jobs be group-shipped.
Shipping quote does not validate product and options for group-shipping qualification. The service may return shipping cost for invalid product combinations. This is to save processing time on the shipping-quote and does not mean that the product can be group-shipped. Product’s baseprice route contains “can_group_ship” flag that identifies qualified product, runsize and colorspec combinations. The Order route validates group-shipping qualifications and will fail if invalid products are group-shipped.

Resource URI

POST /shippingquote                                    

Input Parameters

@param product_uuid {uuid} UUID of a Product.
@param runsize_uuid {string} UUID of specified Runsize.
@param turnaround_uuid {string} UUID of turnaround time.
@param colorspec_uuid {string} UUID of colorspec time.
@param option_uuids {uuid} Array of Option UUIDs for all finishing/bindery options.
@param address {string} Address of ShipTo address.
@param address2 {string} Address2 of ShipTo address.
@param city {string} City of ShipTo address.
@param state {string} State of ShipTo address.
@param country {string} Country of ShipTo address.
@param zipcode {string} Zipcode of ShipTo address.
@param sets {integer} Optional parameter to identify number of sets for group-shipping.

Sample Request URI

html

https://api.4over.com/shippingquote

Sample Request Body

JSON

{
  "product_info": {
      "product_uuid": "e24dbd7f-16e9-4ca7-b6c1-b7c1d5110615",
      "runsize_uuid": "52e3d710-0e8f-4d4d-8560-7d4d8655be69",
      "turnaround_uuid": "9f85d0c4-d344-4088-a719-86f8f84d504d",
      "colorspec_uuid":"13abbda7-1d64-4f25-8bb2-c179b224825d",
      "option_uuids": [
          "fe6a4ed8-5803-433c-b773-a25a7b955e98"
      ],
      "sets": 19
  },
  "shipping_address": {
    "address": "5900 San Fernando Rd.",
    "address2": "",
    "city": "Glendale",
    "state": "CA",
    "country": "US",
    "zipcode": "91202"
  }
} 

Once a quote request is posted, validity of the product combination is checked first. If the product combination is not a valid combination, the API returns an error message. For valid product/options combination, the address is validated. If there is an ambiguity in the address, the response will return candidate addresses.
Once a valid address is selected, the facility and turnaround time is considered. If the facility closest to the Ship-To address can produce the product in the specified turnaround time, the response returns facility data and possible shipping options from that facility.
However; if the closest facility cannot produce the product in specified turnaround time, the response will return next closest facility with shipping methods and costs that can produce the product combination. In addition, it returns the closest facility with available turnaround times for that facility to produce selected product combination.

Sample Response

JSON

{
  "job":{
      "product_info":{
          "box_weight":40,
          "box_count":1,
          "product_uuid": "fa6d2828-cee1-4bf1-a4b4-75b2d7ae20e9",
          "runsize_uuid": "f593fda3-2d5c-4b9e-9c2c-6197b899ae74",
          "turnaround_uuid": "e04b099b-4ac3-4a35-84d0-c530df7b7aff",
          "colorspec_uuid":"13abbda7-1d64-4f25-8bb2-c179b224825d",
          "option_uuids": [
              "3be06301-cd4f-47f7-a3d7-130aff944a49",
              "d41dab50-ff65-4f4f-bb17-2afe4d36ae33"
          ]
      },
      "ship_to":{
          "address":"5900 San Fernando Rd.",
          "address2":"",
          "city":"Glendale",
          "state":"CA",
          "country":"US",
          "zipcode":"91202"
      },
      "facilities":[
          {
              "address":{
                  "code":"GLN",
                  "address":"4621 Sperry Street",
                  "city":"Los Angeles",
                  "state":"CA",
                  "country":"US",
                  "zip":"90039"
              },
              "shipping_options":[
                  {
                      "service_code":"03",
                      "service_name":"UPS Ground",
                      "service_price":"17.47"
                  },
                  {
                      "service_code":"12",
                      "service_name":"UPS 3 Day Select",
                      "service_price":"37.61"
                  },
                  {
                      "service_code":"02",
                      "service_name":"UPS 2nd Day Air",
                      "service_price":"50.64"
                  },
                  {
                      "service_code":"13",
                      "service_name":"UPS Next Day Air Saver",
                      "service_price":"72.43"
                  },
                  {
                      "service_code":"14",
                      "service_name":"UPS Next Day Air Early A.M.",
                      "service_price":"117.55"
                  },
                  {
                      "service_code":"01",
                      "service_name":"UPS Next Day Air",
                      "service_price":"84.70"
                  }
              ],
              "production_estimate":"10\/21\/2014",
              "total_tax":"1.53"
          }
      ]
   }
}