![\"Authorization](\"https://api.navisphere.com/api/B2B/Portal/v1/documents/descriptions/Auth_flow.jpeg\")
"
- name: Rating
description: "C.H. Robinson's rating product allows our customers to retrieve contractual or transactional quotes. Customers can generate quotes with nothing more
than weights and zip codes! However, the more detailed the rate request, the more refined the quote is. C.H. Robinson has taken this functionality a step further and can accommodate our customer's e-commerce platforms
to be the rating engine they use to give their customers shipping costs. One of the great features of C.H. Robinson's rating API is the ability for customers to turn the received quote into an order.
\n## Rating and Quote to Order
\n\nTo maximize the quote to order experience, we require more information than the bare minimum required parameters. Each parameter that has these \"conditional\" requirements
has been specifically called out in the parameter description.\n See [Order Create With Quote ID](https://developer.chrobinson.com/api-reference#operation/Order%20Create%20with%20Quote%20ID)
to learn more about the Quote to Order process.
\n\n #### Notes:
\n * **Multi-Stop Shipments:** For shipments with more than two stops (that is more than one pick and one drop), the Order
Create with Quote ID endpoint can receive only a quote ID and no other supplemental shipment data.
\n * **Incomplete Orders:** Orders created in C.H. Robinson's Navisphere® Order Management system will be marked as incomplete
if any data fields marked as “required” are not included. Incomplete orders will require manual intervention by C.H. Robinson team members to be processed.
\n## Rating and Order Create
\n\nAlternatively, you may also use the rating endpoint to retrieve a quote and use the Order Create method to complete the resulting order tender into C.H. Robinson.
Please review the
Rating Workflow Options Guide
to understand the advantages and tradeoffs between the Order Create and Order Create with QuoteID workflows.
\n## Rating and Transactional Truckload Quotes
\n\nOur rating API can provide Real-time Transactional truckload quotes. These are also known as Spot-Bid quotes or market rates. Please review the
Transactional Truckload and Equipment Handling Guide
for more detail.
\n## Density Based Freight Classification
\n\nThe NMFTA (National Motor Freight Traffic Association) publishes the NMFC (National Motor Freight Classification) which is a standard for evaluating product classifications for use in transportation.
There are four transportation characteristics that are used to determine product classifications:
\n * Density
\n * Stowability
\n * Handling
\n * Liability
\nIn many instances, all four characteristics hold equal weight in determining the product's classification. However, in some instances, one characteristic can hold more weight than the other.
For those commodities that use Density as the primary determining factor for freight classification, C.H. Robinson provides a service for retrieving the estimated classification,
based solely on density, for further use in the actual rate requests."
- name: Orders and Booking
description: "C.H. Robinson’s Orders and Bookings products are the starting point for all freight execution in Navisphere®.
They provide a unified gateway for customers to submit and manage shipment and booking details—whether leveraging C.H. Robinson’s brokerage services or using Navisphere® for tracking and transportation management."
- name: Events
description: |
C.H. Robinson's Events product gives complete, near real-time order and shipment information, including all transportation updates.
Integrating with C.H. Robinson's Events API give partners near visibility into their supply chain directly to their own TMS or ERP system.
There are two ways to integrate with C.H. Robinson events: via a callback/webhook (preferred and most real-time) or via a periodic event retrieval (easiest to implement and less real-time).
- name: Visibility
description: "Navisphere® Vision and Visibility tool is a global visibility technology that allows select customers to view and proactively manage their
supply chain movements from a single platform. The tool combines real-time order and shipment information with transportation updates and external factors
that can influence a supply chain, including weather, traffic, and current events to help customers prevent potential disruptions."
- name: Shipments
description: "C.H. Robinson's Shipments product allows our partner base to access C.H. Robinson's available shipments, send offers on those shipments,
and book those shipments. Additionally, our partners can update C.H. Robinson on any shipments that C.H. Robinson is responsible for, as well as view status
of payment."
- name: Financials
description: "C.H. Robinson's financial product provides customers and carriers insight into their invoicing.
\n\nCurrently, customers can retrieve their invoice information
from the Financials product. C.H. Robinson gives customers the ability to retrieve all active invoices in a single call along with the flexibility to retrieve detailed
information from each invoice if desired.
\n\n Carries can use C.H. Robinsons Financials product to check the status of payment for invoices they have submitted."
- name: Documents
description: "C.H. Robinson's Documents product allows our partners to generate, post, and retrieve documents. C.H. Robinson currently offers customers the ability to generate blank
BOLs and retrieve signed BOLs, PODs, and Lumper receipts. Additionally, carriers can post documents to their shipments."
#- name: Purchase Orders
# description: "Purchase Order (PO management) is a service that combines reporting capabilities through our single global technology platform, Navisphere®, and operational
# expertise through skilled people who understand our customers' perspective and the logistics industry at large."
- name: Labels
description: "A service for generating small parcel shipping labels. An associated C.H. Robinson order is also created to track the package updates through Navisphere®.
Note: Configuration of your company’s parcel carrier account details within Navisphere® is required as a prerequisite for using this API. Contact your C.H. Robinson or TMC account representative to begin this process."
paths:
#---Authentication---------------------------------------------------------------------------------------
/v1/oauth/token:
post:
description: Allows partner to retrieve their own auth token.
operationId: Generate Token
security: []
tags:
- Authentication
requestBody:
description: generate auth token
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/tokenRequest'
application/ x-www-form-urlencoded:
schema:
$ref: '#/components/schemas/tokenRequest'
x-code-samples:
- lang: Curl
source: "curl -X POST \\ \n
https://sandbox-api.navisphere.com/v1/oauth/token \\ \n
-H 'Content-Type: application/json' \\ \n
-d '{ \n
\"client_id\": \"Your Client ID\", \n
\"client_secret\": \"Your Client Secret\", \n
\"audience\": \"https://inavisphere.chrobinson.com\", \n
\"grant_type\": \"client_credentials\" \n
}'"
- lang: Java
source: "HttpResponse