Published Rates for Vehicles
uShip provides three primary integrations for retrieving shipping rates on cars and light trucks: the uShip Logistics site widget, the Single Vendor API integration and the Published Rates API integration.
What is a published rate?
A published rate is a bookable price from top service providers based on the vehicle make and model, origin zip code and destination zip code.
- A published rate is based on a Service Provider's unique pricing algorithms.
- A published rate is valid until the expiration date or when there are significant changes in the listing details.
- A published rate gives Shipping Customers a chance to instantly view bookable rates for a shipment without going through an auction.
A Service Provider must confirm the published rate prior to charging the Shipping Customer's payment method.
Overview
Published rates integrations are based on authenticating, creating a rate request, retrieving those rates, and booking your shipment on uShip.com. Once you have registered on our API portal, you will receive access keys as well as a preconfigured Postman collection to quickly test and integrate this solution.
Walkthrough
The following steps outline a common Published Rates workflow. Please contact uShip's Partnerships team to obtain a Postman collection and support for your particular integration. The examples below demonstrate the sandbox integration; production integrations will use a different URL in each call.
- Authenticate with POST https://api.ushipsandbox.com/oauth/token_authenticated. You will need this access token for the following steps.
- Create your Rate Request with POST https://api.ushipsandbox.com/v2/rateRequests/. Copy the value found in the Location header of the response.
- Retrieve your rates with GEThttps://api.ushipsandbox.com/v2/raterequests/{value found in the Location header}/rates. You may want to include a delay or ping this value multiple times to ensure that all service providers have had time to send a request.
- Checkout with https://www.ushipsandbox.com/quotes/checkout.aspx?qrid={the value from the location header}&qid={the value for the quote you'd like to checkout}. For example, https://www.ushipsandbox.com/quotes/checkout.aspx?qrid=5ec4299bb0b6e217fc410666&qid=5ec429a0b0b6e21698e5c9d3.
