This article explains how to set up the FMX-Zonar integration, which automatically creates a Work Request in FMX when a vehicle inspection in Zonar reports a defect.

What is the Zonar Integration?

The FMX-Zonar integration connects your FMX site directly to the Zonar Ground Traffic Control telematics system. It creates a seamless link between a failed vehicle inspection in Zonar and a trackable Work Request in FMX.

This helps you:

  • Turn Inspections into Action: Ensure every failed inspection automatically generates a work order (request) in FMX, eliminating the risk of lost paperwork or delayed verbal reports.
  • Create a Single Source of Truth: Capture detailed diagnostic data from Zonar directly in FMX, creating a permanent, auditable maintenance record for every vehicle.
  • Eliminate Manual Data Entry: Save time and reduce errors by automatically populating work order (request) with rich data from the vehicle inspection.

How it Works

The integration runs in the background automatically every 10 minutes to check for new vehicle inspection data from Zonar.

Example Work Request

When an inspection with defects is found, a new Work Request (e.g., Maintenance Requests, Inspection Requests, etc.) will be created in FMX.

  • Title: The title will be automatically generated using the status, fleet, and operator from the inspection data (e.g., "Red - Truck 101 - John Doe").
  • Equipment: The Work Request will be automatically linked to the correct FMX Equipment item (e.g., "Truck 101").
  • Details: All detailed information from the Zonar inspection—such as the inspection ID, mileage, operator, and a full list of defects—will be populated in the custom fields section of the Work Request.

How to Set Up the Integration

The Zonar integration is a "Feed" integration, which means the final activation and configuration are performed by your FMX implementation specialist. The setup process is a collaboration between your team and the FMX team.

Step 1: Contact FMX to Begin

To start the process, reach out to your FMX Account Manager or the FMX Support team. They will partner with you through the following steps to ensure your site is configured correctly.

Step 2: Map FMX Equipment to Zonar Vehicles

Your primary task is to ensure each Zonar-equipped vehicle is correctly mapped to its corresponding Equipment item in FMX. The integration identifies which vehicle to link by matching the Zonar Serial Number to the FMX Asset Tag.

  1. In FMX, select Equipment from the left-side menu.
  2. Locate and click on a vehicle you wish to map.
  3. On the Equipment item's detail page, find the standard Asset Tag field.
  4. Enter the vehicle's unique Serial Number from Zonar into this field. The value must be an exact match.
  5. Click Save.
  6. Repeat this process for all vehicles you wish to include in the integration.

Step 3: Create the Integration Data Fields

To ensure all the data from Zonar has a place to live in FMX, a series of custom fields must be created on your Work Request module. You can create these fields yourself ahead of time to prepare for the integration, or your FMX specialist can assist you during the setup process.

To learn how, please see our guide on Adding Custom Fields in FMX.

The following fields must be added to your Work Request module:

  • Zonar Inspection ID (Text): Stores the unique identifier for the inspection from Zonar.
  • Storetime (Text): Stores the timestamp of when the inspection event was recorded.
  • Fleet (Text): Stores the name of the vehicle's fleet as defined in Zonar.
  • Stat (Text): Stores the overall status of the inspection (e.g., "Red").
  • Mileage (Number): Stores the vehicle's mileage at the time of the inspection.
  • Operator (Text): Stores the name of the operator who performed the inspection.
  • Serial Number (Text): Stores the vehicle's unique serial number from Zonar.
  • Zones and defects (Text Area): Provides a detailed list of all reported defects, serving as the primary description of the work to be done.

Step 4: Finalize Configuration with FMX

During your conversation with your FMX specialist, you will finalize the following settings for the integration:

  • Default Building: Select a default Building in FMX that will be associated with new Work Requests if the mapped Equipment item does not have one assigned.
  • Default Request Type: Select a specific Request Type within your Work Request module (e.g., "Vehicle Maintenance") that the integration will use for all automatically created requests.
  • Default Due Date: Decide on a default due date, set as a number of days after the Work Request is created (e.g., 3 days).

Step 5: Provide Credentials to Activate

The final step is to provide your Zonar API credentials to the FMX team. For security, we recommend sharing these credentials using our Secure Messages feature.

You will need to provide the following:

  • Zonar username
  • Zonar password
  • Zonar customer code

After receiving your credentials, the FMX team will configure the backend connection and activate the feed.

After Activation

Once the FMX team notifies you that the integration is live, you can verify that it's working correctly:

  1. Perform a test vehicle inspection in your Zonar system, ensuring you mark at least one item as a defect.
  2. Wait 10-15 minutes for the integration to run.
  3. Check your FMX site for a new Work Request corresponding to your test inspection.

If you do not see a Work Request after 15 minutes, or if any information appears incorrect, please contact the FMX Support team for assistance.

Was this article helpful?

  • 0 out of 0 found this helpful