Meter Readings to BMS
To establish the webhook between 3manager and bms-audit
1. go to the top level Vendor in 3manager - Settings/Integrations
2. enable, then configure a Webhook - using https://yourdomain.audit.bmserp
3. Webhook endpoints are:
equipment: https://yourdomain.audit.bmserp.com/three_manager/equipment.json
3. then in 3manager - Reports/Equipment add new report
This is the equipment report, where you nominate BMS as the format, and webhook (the http endpoint) as the channel. Before step 3 in the above image, in the report definition - Columns - Click on the 'Configure' link. Tick the top right boxes to include All Counters - Main & Other.
You can then click Save & Run, where it saves the equipment report details, but then immediately runs it as well. Once configured, 3manager will prepare an equipment report, then post it via the specified webhook to the bms-audit service.
As the audit service processes the equipment report, it will query BMS for matching assets, if not found, the asset is listed in bms-audit as an Unknown Device. Periodically they can then choose to flag the device to be ignored, or re-query BMS for a match.
Matched assets will pass meter readings directly through to BMS.
Toner Alerts to BMS
Create a 3manager Alert Profile as required.
Then instead of adding an email address for the alert to be sent to, toggle the Webhook on-off switch.
The webhook used refers to the Webhook Settings/Alerts endpoint, shown above in the meter reading setup. Then click Enable in the top right hand corner to turn on the alert.
At this point we can only handle toner and waste bottle alerts. Machine error alerts are a work in progress.
Obviously, we require the toner products to be setup in BMS correctly.
The model of the Asset should have the correct supplies nominated as Related Products - Supply, with correct values for Supply Type: Toner/Developer/Waste, and Colour: black/cyan
