Unify - ERPs Integration: ADD Systems

Unify supports integration with the ADD System.

SUPPORTED FEATURES

• Automatically push tank volume readings to the ADD System whenever a new reading is recorded for a device.

PAYLOAD FORMAT

1. Request the ERP address, examples:

• 192.69.20.68/WSSmartConnect/
• 75.145.245.194/WSSmartConnect20

2. Ask customer to white list our outbound IP address on their system.

• US: 52.224.73.98
• EU: 20.93.48.183

NOTE: Adds doesn't have authentication, they only use IP white list.

3. The customer must give the ProductSupplementalTable to configure the integration with the units to be sent by product ID. Otherwise all reading will be sent with a default unit, that must be set in the integration. Usually it is percentage. The ProductSupplemental is like:

The integration should be configured as follows:

"erpConfig": {
        "ticketThreshold": 0.0,
        "sendUnitDefault": "Volume",
        "sendUnit": {
          "79": "Percentage"
        }
      },

NOTE: Some Customers only accept readings after they made as the set up of the SETD process to update table 0 in the overnight processes. This will move the inventory date forward and allow readings to be pushed. This is a manual process done by the customer (might not be applicable to all customers, it might be required to send the same reading more than once, until it is accepted).

FIELD MAPPINGS

For the integration to work, there are fields that must be configured in unify:

INTEGRATION BEHAVIOR

• Whenever a new volume reading is recorded in Unify, the platform checks if the ADD System integration is configured for the associated asset.

• If configured, the integration constructs the payload and sends it to the ADD System endpoint.

• Configuration errors are logged for review and may trigger retry logic or email notifications, depending on system settings.

CONFIGURATION GUIDE

REQUIRED INPUTS

• ADD System IP address (in the URL Field box)

• Client's companyID (provided by the client or ADD System)

STEPS TO CREATE AN ADD SYSTEM 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: ADDS

  

4. Click on ACTIVATE INTEGRATION, and click CONTINUE.

5. Enter the ADD System URL, then click on CONTINUE.

6. Enter COMPANYID, 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 ADD system. Click on SAVE.

5. Repeat for all tanks you want to sync.

Once configured, live readings from these tanks will automatically be pushed to ADD System.