The RUC Monkey platform provides a system for managing Road User Charges (RUC), trip reporting, and automated compliance processing for fleet operators in New Zealand.

This article explains how to integrate Telematics Guru (TG) with RUC Monkey using webhooks to send Odometer and other data at the end of each trip. More information on setting up Webhooks can be found here - Alert Notifications through WebHooks

1) Enable the HTTP POST API Provider:

 Before setting up the webhook, make sure that the “API Provider” is set to "TG Default (HTTP POST). This setting can be found when you edit an organisation.

2) Create the Webhook:

Provide a Name for the Webhook (Required). A Comment is not required.

Provide the URL/Server address where the data must be sent. Check with RUC Monkey for the right URL.
eg. https://api.rucmonkey.co.nz/collector/v1/telematicsguru/submit/tripenddata

Add the following Headers:
Content-Type = application/json
Authorization = basic KEY
Reach out to RUC Monkey for the Authorization KEY.

Add the following to the Webhook Body.
Depending on your requirements, the body may need to change.

{{
"AssetPlateNumber": "{Asset.RegistrationNumber}",
"TimestampUtc": "{Event.DateUtc:default:dd/MM/yyyy HH:mm}",
"OdometerKm": {Trip.End.Odometer},
"HasGpsSync": true,
"Latitude": {Event.Latitude},
"Longitude": {Event.Longitude},
"SpeedKmh": {Event.SpeedKmH},
"HeadingDegrees": {Event.HeadingDegrees},
"IgnitionOn": true,
}}


3) Create the Alert:
Now that the Webhook is ready to go, an Alert that triggers at the end of each trip must be configured.

Set the Alert Condition to “In Trip”.

Select the Webhook that you created in step 2 from the Address book.

Select the "Send Notification When Alert Condition End' option.