What does the BD and BS API do?
APIs automatically import schedules created in BD and BS to related organiser accounts in Horse Monkey.
How does Horse Monkey connect an organiser account to BD and BS schedules?
We use the organiser's HM email address and the BD/BS email (the one you use to log in to their systems.
In relation to BD only, we check if the event has credentials of the BD organiser to get the HM organiser relationship. If these credentials do not exist we cannot create a relationship between a BD organiser and a Horse Monkey account.
Alternatively, if the system does not find or does not have the HM organiser yet, we
Check an enabled member with an HM organiser profile against the BS/BD event email
Check an enabled HM organiser against the BS/BD event email
Check an enabled HM organiser against an alternative email = the BS/BD event email
Check an enabled HM organiser against an alternative email = the BS/BD organiser email
Check an enabled HM member with an organiser profile against the BS/BD organiser email
Check an enabled HM organiser against the BS/BD organiser email
What happens when there are changes to BD and BS schedules?
1) BD only:
1a) If the event status has changed to cancelled, we update the status on HM and delete the HM event only if it doesn’t have any bookings.
1b) If the event status has changed to completed or draft, we update the status to draft on HM.
2) BS only:
2a) If the event status has changed to invalidated, we update the status on HM (to cancelled) and delete the HM event only if it doesn’t have any bookings.
3) For both:
3a) Check venue: if the venue has changed and does not exist on our database, we don't update the event
3b) Check organiser: if the organiser has changed we unlink the HM event from the BD/BS event, update the status to draft on HM event (if there are bookings processed the event will not be able to be deleted) and we create a new event for the new organiser.
3c) Update venue name and event notes.
3d) Update contact details: contact name, email and mobile.
3e) Update secretary details: contact name, email, phone and mobile.
4) Check all items:
4a) If it exists a new competition item it will be created
4b) If the competition item exists on HM, the system will update these fields:
notes,
order,
is_team (for TQ only),
prize notes (BD only),
sections/levels,
prize money and
sponsors (BD only).
4c) If the competition item has been deleted on BD / BS and it exists on HM, the system will not update the competition on HM, the organiser must update these items manually.
Are events claimed or do they automatically publish?
The events are claimed automatically if the organiser has established Import settings to “auto-accept” (it is not visible for the organiser yet so these settings were imported from HM1)
* NOTE: At the moment events are automatically claimed but not automatically published, this gives organisers the opportunity to review the details of the event before publishing.
What happens if I make changes to the event on Horse Monkey?
If you create a new competition or service item on HM, nothing happens to the BD / BS schedules. Results, however, will not be related to a competition ID on BD / BS which means no results will be automatically transferred back to the Association through the API, but they will be transferred in the supporting excel document.
If you update a competition item created by BD / BS, in HM the system will update these fields only :
notes,
order,
is_team (for TQ only),
prize notes (BD only),
sections/levels,
prize money and
sponsors (BD only).
Will the competition or service items I create in Horse Monkey for a BD / BS imported event be changed through an update?
No! They will not be changed or altered at all. The items created remain part of your event but are not connected to the imported schedule.