Truckstop

Supported Truckstop Integrations: 

  • Loadboard Postings
  • Book It Now
  • RateMate
  • Carrier Onboarding

Loadboard Posting Instructions

  1. Authentication
    1. Create a Truckstop Integration
    2. Enter Handle, Integration ID, and Account number
    3. Add the Linked Organization 
  2. If needed, please send an email to tsi@truckstop.com. to obtain the above credentials.

Book It Now Instructions

  1. Authentication
    1. Create a Truckstop Book It Now Integration
    2. Add a Source Setting with the staff id (comma separated)
    3. Add the Linked Organization 
    4. Tokens will be generated after a posting is created
  2. Book It Now Initialization
    1. 3 Parts to start it
      1. On The Truckload Quoting Page, the Book It Now button will be available
      2. Upon pushing the button, the Truckstop Authentication Window will pop up and will request to use the integration with the Tai Software application. (This is a one-time process) All tokens will be saved to the TMS. This is so that no username/password information is required. 

      1. Once this has happened, the next step is to push the Book It Now button again to load up the Terms & Conditions setup. (This is a one-time process) The T&C ID will be stored in the Integration Source parameters.


  1. Posting A Book It Now 
    1. After the setup process is completed, click on the Book It Now button, and a modal will popup where the Rate Offer can be entered. 
    2. At this point, the Carrier can go into the Truckstop Portal. They will see a Book It Now button. When the carrier accepts, a webhook will be triggered indicating that the shipment was booked. The carrier will be selected/assigned for the shipment. In addition, as part of the BIN feature, it will set the status of the shipment to "Dispatched" and will email the rate confirmation to the carrier. This will be the email listed for the carrier in the Truckstop portal. This information will be logged in the Activity Log for the shipment. 
    3. There is a separate workflow that can occur when the BIN carrier rejects the shipment. This happens in the event that the carrier accepts the load but then later rejects it. When this occurs, we will update the shipment to "Rejected By Carrier". A reason will also be passed in and saved to the Shipment Activity Log. 

RateMate

  1. This will show up on the Truckload Quoting Page
    1. Create a Truckstop Integration 
      1. Add the License Key (Integration ID provided by Truckstop) 
      2. Set a Source Setting called "rateindex" and enter the value "true" (without quotes)
      3. Add a Source Setting called "staffid" (without quotes) and enter the staff ID number. This can be comma-separated.
      4. In the Rate Intelligence area, all rate information that matches the query will be visible. 
    1. Query Info basedon city/state/country for Origin & Destination
      1. Also based on Trailer Type
        1. Flatbed
        2. Reefer
        3. Van
    2. Search Criteria Available
      1. State to State
      2. 100 Mile Radius
      3. Note: If the user sets the Search Criteria to something other than the above, we will override it and still submit the criteria that are available with the integration.

Carrier Onboarding

  1. Create a Truckstop Integration
    1. Add the username/password provided by Truckstop for the Carrier Onboarding integration
    2. Set the Source Settings called onboard = true
    3. Add the Linked Organization that manages the LSP Organization (typically the parent org) 
  2. Setting Up
    1. Push the Sync Truckstop Onboarding Carriers
      1. This will pull from Truckstop Into TMS all carriers that have been set up. 
      2. This will match based on DOT Numbers
      3. If needed, this will create a new broker carrier. 
      4. This will pull contact information, phone numbers, fax, name, 
      5. Will update Remit Payment Information
      6. This will add a parameter indicating that the sync has occurred and remove the button
    2. Automated Function
      1. Every 10 minutes, two jobs (one job queries through edit changes and the other job queries through new carrier members) are run that both pull the following information:
      2. Carrier contracts / agreements
      3. Carrier Addendums
      4. Carrier Documents
      5. Broker Carrier Insurance Information
        1. Company Name
        2. Effective Date
        3. Expiration Date
        4. Type of Insurance
        5. Policy Number
        6. Amounts
        7. Phone Number
        8. Certificate Image (when available)
  3. Workflow
    1. User will create a broker carrier in TMS
    2. User will onboard the carrier via Truckstop using their "Course" links 
      1. This sends an invite link to the carrier from Truckstop where the broker can fill out all of the necessary paperwork. 
      2. In the future, I believe we can void this portion and send the email directly to the TMS. 
        1. They have an API for this that we might work on in the future.
    3. When the Course link is accepted and completed, this will add them as a Core carrier list in Truckstop.
    4. The automation workflow should then pick up information on the carrier and pull it into the TMS.
      1. The initial sync will bring over information for the new carrier.
      2. Further tracking will track changes to the carriers in Truckstop (Rating, Insurance, Documents) and sync the appropriate information