📋 Applies to: Admins · Partner Admins · Dispatchers
Module: Management > Integrations
Provider: Orbcomm (Cargowatch) · Integration type: One-way · Direction: Orbcomm pushes asset location data to Alvys
Last reviewed: 2026-06 · Owner: Support team
Connect Orbcomm Cargowatch to Alvys to pull real-time GPS location data from your Orbcomm-equipped trucks and trailers automatically, giving you live asset visibility on the Asset Map and in dispatch planning.
Overview
Orbcomm Cargowatch (also called the Orbcomm ELD or telematics integration) is a telematics solution that provides real-time GPS tracking for trucks and trailers. Once connected, Alvys automatically pulls location data from your Orbcomm-equipped assets, making that data visible on the Asset Map and available for dispatch planning.
📋 Orbcomm Cargowatch uses XML credentials (a username and password). If your Orbcomm account uses the newer RESTful API, you are on Orbcomm Platform, not Orbcomm Cargowatch. Check with your Orbcomm representative if you are unsure which version you have.
Prerequisites
Before you begin, you need XML credentials from Orbcomm: a username and a password.
Contact Orbcomm at [email protected] and request XML credentials. Keep these credentials ready for the connection step below.
You also need the Orbcomm Unit number and Gateway ID for each truck or trailer you want to track. These are available in your Orbcomm portal or by request from Orbcomm support.
How to connect
Open Integrations for the correct subsidiary. Click your profile icon in the lower left corner of Alvys. Select the subsidiary you want to configure and click the Integrations tab. Expand the ELD section. Locate the Orbcomm Cargowatch card and click the pencil icon to open the configuration.
<image source="8e2e"></image>
Enter your XML credentials. Enter your Orbcomm Cargowatch XML Username and Password, then click Save. Alvys validates your credentials automatically. If the credentials are accepted, the integration becomes active.
<image source="4cce"></image>
What syncs
Orbcomm sends GPS location data to Alvys for each asset that has been mapped. The data includes the asset's current location coordinates, which Alvys uses to update the Asset Map and to support dispatch planning. Alvys does not send data back to Orbcomm. Location data flows one way: from Orbcomm into Alvys.
Only assets that have been explicitly mapped to an Orbcomm Unit number and Gateway ID will appear on the Asset Map.
Map assets for location tracking
After connecting, you need to tell Alvys which Orbcomm Unit ID and Gateway ID correspond to each truck or trailer.
Go to Assets in the left navigation and select Trucks or Trailers.
<image source="4308"></image>
Double-click the asset you want to configure, then scroll down to the ELD Integrations section and click Add Integration.
Select Orbcomm from the dropdown. Enter the Orbcomm Unit # in the Integration ID field and the Gateway ID in the Gateway ID field, then click Save.
<image source="4bad"></image>
Repeat this process for each truck or trailer you want to track. After saving, the asset should begin appearing on the Asset Map within a few minutes if the integration is active.
📋 Only assets with a mapped Orbcomm Unit number and Gateway ID will appear on the Asset Map; assets that are not mapped in Alvys will not receive location updates regardless of the integration being active. · The Orbcomm Cargowatch integration uses the older XML-based API. If you are connecting a new Orbcomm account, confirm with your Orbcomm representative whether you should use Orbcomm Cargowatch or the newer Orbcomm Platform integration.
Troubleshooting
Asset is not appearing on the Asset Map after mapping
Confirm the Orbcomm Unit number and Gateway ID entered in Alvys exactly match what is shown in your Orbcomm portal. A mismatch will prevent location data from being received.
Confirm the integration is active by checking the Orbcomm Cargowatch card in the ELD section under Integrations. It should show a connected state.
If the asset still does not appear, contact Orbcomm support to confirm the unit is transmitting location data from the vehicle.
If location data is transmitting from Orbcomm but the asset is still missing from the Asset Map in Alvys, contact Alvys Support.
Cannot find the Orbcomm Unit number or Gateway ID
Your Orbcomm Unit numbers and Gateway IDs are available in your Orbcomm portal. If you cannot locate them, contact Orbcomm at [email protected].
FAQs
Q: Where do I find my Orbcomm Unit numbers and Gateway IDs?
A: Your Orbcomm Unit numbers and Gateway IDs are available in your Orbcomm portal. You can also request them from Orbcomm support at [email protected].
Q: Can I track both trucks and trailers with Orbcomm Cargowatch?
A: Yes. You can configure Orbcomm Cargowatch tracking for both trucks and trailers by adding the integration to each asset individually.
Q: What is the difference between Orbcomm Cargowatch and Orbcomm Platform?
A: Orbcomm Cargowatch uses XML credentials (a username and password) and connects via an older API. Orbcomm Platform uses the newer RESTful API with different credentials. Check with your Orbcomm representative to confirm which version your account uses.
Q: Does Alvys send any data back to Orbcomm?
A: No. Location data flows one way: from Orbcomm into Alvys. Alvys does not send data to Orbcomm.