Turvo’s integration with FourKites provides greater visibility into shipment and tracking information by pushing this information from Turvo into FourKites.
This article covers:
- Prerequisites for establishing a connection between your Turvo tenant and FourKites
- Enabling FourKites for your tenant
- Setting up FourKites on the customer profile
Enablement prerequisites
Before initiating a connection between your Turvo tenant and FourKites, you must first create an account with FourKites.
Next, reach out to FourKites to obtain the following SFTP credentials to enter into Turvo to establish the connection:
- SFTP username
- SFTP server
- Private key
Finally, reach out to your FourKites representative to designate a time zone and set FourKites to accept timestamps in UTC.
In FourKites, you must designate a time zone in order to receive location updates.
Note: Location updates are rejected if timestamps are more than 5 minutes in the future or more than 6 hours in the past.
Important Note: Turvo will only send timestamps in UTC to FourKites; when enabling this integration, ensure that FourKites is set to receive timestamps in UTC. If the correct time zone is not set, a future time error is generated, and the updates will not be processed by FourKites.
Be sure to store these credentials in a safe place, as you will need to enter them into Turvo in the following steps.
As an alternative to connecting via SFTP, you can also utilize our self-serve public API to set up the integration using your IT resources.
Enabling FourKites in Integration hub
Once your FourKites account is created and the above credentials obtained, follow these steps to enable the FourKites integration:
Step 1:
Log into your Turvo tenant and navigate to the Admin console via the Profile icon at the top right corner of the screen.
Step 2:
Click the Integration hub tile.
Step 3:
Scroll down to the Load boards/Tracking integrations section of the Available Integrations tab and click the FourKites tile.
Step 4:
In the Integrate tab, enter the following SFTP credentials obtained from FourKites as described in the Enablement Prerequisites section of the article:
- SFTP username
- SFTP server
- Private key
Final Step:
Once the credentials are entered, the CONNECT button at the bottom corner of the screen will change from blue to grey. Click CONNECT to establish the connection.
Setup FourKites in customer profiles
FourKites requires configuration within the customer profile in Turvo after you have enabled the integration in Integration hub. To set a customer up with FourKites:
Step 1:
Navigate to Accounts > Customers in the left navigation menu and select the customer that you would like to associate with the provider or use the global search bar to search for a specific customer.
Step 2:
Under the customer Details tab, scroll down to Settings, and expand the Integrations segment.
Step 3:
Toggle the FourKites toggle to the blue ON position and indicate which ID type should be used to match shipment in Turvo to shipments in FourKites. Be sure to click SAVE to save your changes.
Final Step:
The FourKites shipment ID that is generated at shipment creation within FourKites must be entered into a consistent ID field within the Turvo shipment Customer block. This is to ensure the correct Turvo shipment is matched with the correct FourKites shipment.
For instance, if you select PO number as the ID type, you would input the FourKites shipment ID into the PO number field within the Customer block on shipment.
Once established, tracking information for the shipment will be shared to the designated FourKites FTP site via CSV file transfer while the shipment is in the Ship phase. This allows customers to view tracking updates within the FourKites platform for shipments while they are being executed.
The telematics breadcrumbs data is updated every 15 minutes and is pushed from Turvo to FourKites, including the shipment creation, location updates, and stop events.
<%= heading %>