Unify supports integration with the Agvance platform.
SUPPORTED FEATURES
Automatically push tank volume readings to the Agvance API whenever a new reading is recorded for a device.
PAYLOAD FORMAT
When the integration is enabled, each new volume reading is sent to Agvance using the following JSON structure:
{
"TankNumber": "string",
"TransmitterID": "string",
"ReadingDate": "2025-01-01T00:00:00Z",
"TankPercentage": 0,
"InTank": 0
}
FIELD MAPPINGS
AGVANCE FIELD |
UNIFY DATA SOURCE |
NOTES |
| TankNumber | Asset ERP external ID | Must match the tank number identifier in Agvance. |
| TransmitterID | protocol-serialNumber |
Example: CTM-12345678. |
| ReadingDate | Reading timestamp | Must be in ISO 8601 UTC format. |
| TankPercentage | Reading percentage | Rounded to 3 decimal places. |
| InTank | Reading volume | Converted to gallons. Rounded to 3 decimal places. |
INTEGRATION BEHAVIOR
Whenever a new volume reading is recorded in Unify, the platform checks if the Agvance integration is configured for the associated asset.
If configured, the integration constructs the payload and sends it to the Agvance API endpoint.
Configuration errors are logged for review and may trigger retry logic or email notifications, depending on system settings.
CONFIGURATION GUIDE
REQUIRED INPUTS
Agvance URL (usually
https://api.agvance.net)Client's username, password, databaseID, and API key (provided by the client or Agvance)
STEPS TO CREATE AN AGVANCE INTEGRATION
1. In Unify, select the desired Tenant.
2. Navigate to Settings Menu on the bottom left corner, select the Integrations tab and click on NEW INTEGRATION.
3. Set:
Type: ERP
-
System: Agvance
4. Click on ACTIVATE INTEGRATION, and click CONTINUE.
5. Enter the Agvance URL (https://api.agvance.net), username and password, then click on CONTINUE.
6. Enter databaseID and API key, then continue through the remaining steps to finalize the integration.
CONFIGURE ASSETS FOR PUSHING READINGS
1. Go to OPERATIONS MENU, then go to TANKS LIST in the sidebar.
2. Select the tank(s) you want to sync.
3. Its Tank Page will open. Click the three dots icon next to the tank name and choose Edit.
4. Set the ERP External ID to match the TankNumber in Agvance. Click on SAVE.
5. Repeat for all tanks you want to sync.
Once configured, live readings from these tanks will automatically be pushed to Agvance.
Comments
0 comments
Please sign in to leave a comment.