Skip to main content

FourKites Outbound Integration

Written by Alvys Admin

Applies to: Admin, Partner Admin, Support

Module: Management > EDI & Visibility

Last reviewed: 2026-07 · Owner: Support

Share real-time load location and status updates from Alvys to FourKites so customers can track shipments in their FourKites portal without contacting your team.

Overview

Share real-time load location and status updates from Alvys to FourKites (also called 4Kites) so customers can track shipments in their FourKites portal without contacting your team.

Synonyms: FourKites outbound, 4Kites, outbound visibility, customer tracking, location sharing, shipment milestones.

The FourKites Outbound integration connects Alvys to FourKites using basic authentication credentials provided by FourKites. Setup has two parts: you enter your credentials and choose which subsidiaries to enable, then you set the default outbound update rules (which location sources and trip statuses to share, and how often). Once connected and activated for a customer, Alvys automatically sends location updates and shipment milestones to FourKites based on the sharing preferences you configure.

This integration enables your customers who use FourKites to receive real-time visibility into load progress, including location coordinates, delivery status, and delivery confirmation.

This is a one-way integration. Data flows in one direction, from Alvys to FourKites.

Prerequisites

Before setting up this integration you will need:

  • An active FourKites account.

  • Basic authentication credentials (username and password) from FourKites. Contact [email protected] to request these credentials.

  • The Alvys Customer ID for each customer you want to activate data sharing for.

  • Admin, Partner Admin, or Support access in Alvys.

How to connect

1. Open the FourKites Outbound integration.

Navigate to Management > EDI & Visibility in Alvys. Under the Outbound section, click the FourKites card to open the FourKites Outbound setup window.

2. Enter your FourKites credentials.

On the Credentials tab, enter the Username and Password provided by FourKites. Under Subsidiaries, select All Subsidiaries, or choose the specific subsidiaries you want to enable, then click Save.

3. Set your default outbound update rules.

Open the Outbound Updates tab to define the default sharing rules applied across the enabled subsidiaries:

  • Location — Select Location Sources to be Shared: Alvys Check Calls, ELD Integrations, Alvys Driver App, Inbound Tracking Integrations, and Stop Location (while at stop).

  • Shareable Trip Statuses: Dispatched or Covered status (2 hours before the scheduled pickup), Dispatched status and the first stop is marked as Arrived, Load In Transit, and Load Delivered.

  • Location Submission Frequency — Sharing Interval: how often Alvys sends location updates to FourKites (for example, every 15 minutes).

Click Save.

4. Find the Alvys Customer ID.

Open a customer profile in Alvys from any load where the customer has been set, or from Companies > Customers. The Alvys Customer ID is the long identifier in the address bar of the customer profile page.

For example, in the address https://app.alvys.com/#/companies/affa5b56ceaeb45dc44z9af3cf855e8c6c12b/edit, the Alvys Customer ID is affa5b56ceaeb45dc44z9af3cf855e8c6c12b.

5. Link the customer in FourKites.

Add the Alvys Customer ID to the Customer Bill-to codes in the FourKites customer settings. You can do this at app.fourkites.com/self-service/carrier/customers following the instructions in the FourKites Connect Carrier Flow guide, or provide the Alvys Customer ID to the FourKites contact who gave you your integration credentials.

6. Open the customer's Auto Update Settings.

On the customer profile in Alvys, find the Auto Updates Settings section. The FourKites integration appears there with an Enabled badge once setup is complete. Click it to open Auto Update Settings: FourKites.

7. Configure sharing preferences for the customer.

In the Auto Update Settings: FourKites window:

  • Use the left-hand list to select the subsidiary you are configuring for this customer.

  • Tracking Key (BOL): select the load field whose value FourKites uses as the tracking key / bill of lading. This defaults to Order #.

  • Location: turn Auto-send on, then select the Location Sources to be Shared and the Shareable Trip Statuses you want to send for this customer.

  • Location Submission Frequency — Sharing Interval: set how often updates are sent (for example, every 15 minutes).

Click Save. To turn the integration off for this customer, click Disable Integration.

What syncs

When a load is shared with FourKites, Alvys sends the following data:

  • The Alvys Customer ID, used by FourKites to identify which customer the load is shared with.

  • The tracking key (BOL) — the value from the load field selected under Tracking Key (BOL) for the customer. This defaults to the load's Order #.

  • Last known location — coordinates, city, state, and country.

  • Delivery status — confirmed or not confirmed.

  • Delivery time — the time the load was delivered.

Location updates are sent to FourKites automatically at the Sharing Interval you configure, based on the location sources and trip statuses enabled for each customer.

Location Sources to be Shared

  • Alvys Check Calls: location captured from check calls recorded in Alvys.

  • ELD Integrations: location parsed from the ELD providers you have integrated.

  • Alvys Driver App: location from the driver assigned to the trip when they are using the Alvys Driver Companion app.

  • Inbound Tracking Integrations: location from inbound tracking providers you have connected, such as MacroPoint, Project44, or Trucker Tools.

  • Stop Location (while at stop): location reported while the truck is at a stop.

Shareable Trip Statuses

  • Dispatched or Covered status: sends updates when the load is in Dispatched or Covered status and it is two hours or less before the scheduled pickup.

  • Dispatched status and the first stop is marked as Arrived: starts sending updates once an arrival time has been recorded at the first stop.

  • Load In Transit: sends updates for loads in In Transit status.

  • Load Delivered: sends updates for loads in Delivered status. Enable this option to notify FourKites when a load has been delivered.

Location Submission Frequency

  • Sharing Interval: controls how often Alvys pushes location updates to FourKites (for example, every 15 minutes).

Managing updates per load

You can pause or resume data sharing for a specific load directly from the load detail page. Open Auto Updates on the load. When sharing is active, the panel shows "Auto Updates are live" with a Pause Updates link; click it to stop sharing for that load, and click again to resume. You can also Add a Manual Update from this panel. Auto-updates are on by default for loads where the assigned customer has FourKites sharing enabled.

Verify it is working

  1. Open a load assigned to a customer you have activated FourKites sharing for.

  2. Confirm that Auto Updates are live on the load.

  3. Log in to FourKites and confirm the load is receiving location updates.

If the load is not appearing in FourKites or is not receiving updates, review the Troubleshooting section below.

Troubleshooting

No updates are reaching FourKites for a customer

  1. Confirm the FourKites Outbound credentials are saved correctly on the Credentials tab in Management > EDI & Visibility.

  2. Confirm the customer's Auto Update Settings: FourKites has Auto-send turned on, with at least one Location Source and at least one Shareable Trip Status selected.

  3. Confirm the Alvys Customer ID is linked to the correct customer in FourKites.

  4. Confirm the Tracking Key (BOL) is set to the value you expect FourKites to match on.

  5. If updates are still not reaching FourKites after confirming the above, contact Alvys support.

FourKites does not appear in a customer's Auto Updates Settings

  1. Confirm the FourKites Outbound integration is set up and saved in Management > EDI & Visibility for the subsidiary associated with the customer.

  2. Confirm the customer is assigned to the subsidiary that has FourKites enabled.

  3. If FourKites still does not appear after confirming the above, contact Alvys support.

Limits and unsupported

  • Data flows from Alvys to FourKites only. FourKites cannot update load status or modify any data in Alvys.

  • The integration is enabled per subsidiary. Enable each subsidiary you want to share from when entering credentials.

FAQs

Q: Can I pause updates for a specific load without disabling the integration?

A: Yes. Open Auto Updates on the load detail page and click Pause Updates; click again to resume. Auto-updates are on by default for loads where the customer has sharing enabled.

Q: Why doesn't FourKites appear in a customer's Auto Updates Settings?

A: FourKites appears in a customer's Auto Updates Settings only when the FourKites Outbound integration is configured in Management > EDI & Visibility for the subsidiary that the customer belongs to. Confirm the integration setup and that the customer is assigned to the correct subsidiary.

Q: Which sharing preferences should I enable?

A: This depends on your customer's requirements. Most carriers enable Load In Transit, Load Delivered, and Alvys Driver App at minimum. Contact your FourKites account representative for guidance on which location sources and trip statuses your customer requires.

Go Deeper

Did this answer your question?