Third party integration

A third parry integration enables an external system to integrate with Evatic applications an integration must first be created in ESH.

Login to ESH, use the button New integration and choose Third party. Give the integration a unique name and description.

The application will make an unique system Id (ExternalSystemGuid), which will track the data in to Evatic Service. This unique system Id is used as a parameter when sending data thru the API. This ExternalSystemGuid will also be used as a key to get events from project/task that the external system has created.

Connect to the services

This assumes the Evatic Service Hub has been installed on you server. The endpoint is called M2M.svc and will have an url: (https://(your.server.com)/M2M.svc)

Functions

There are only two function that are required for sending data as a 3rd party:

• SaveDeviceWithMinimumData
• SaveMeterAndConsumablesReadings

SaveDevicesWithMinimumData

This function Save devices from an external system. (ExternalSystemId) ExternalDeviceId is mandatory or the device will not be created. Function input:

• ExternalDeviceId
• AssetNumber
• SerialNumber
• ModelName
• MacAddress
• LastActiveDate

SaveMeterAndConsumablesReadings

This function Save consumable and meters from an external system. Function input:

• ExternalDeviceId
• MeterReading
  • Label
  • MeterMapId
  • DateTime
  • ScanTime
• TonerLevels
  • ConsumableColorantType
  • ConsumableLevel
  • ConsumableName
  • ConsumableType
  • HistoricalCoverageFactor
  • LastUpdatedAt