Integration
OWNA
Two-way: staff and credentials in, alerts out.
How to map OWNA staff profiles and attached certificates onto Ratio's open API, so Ratio watches every expiry date on a roster you already maintain.
What comes into Ratio
- Staff profiles, roles and start dates
- Certificates with issue and expiry dates
- Uploaded certificate images and PDFs
What Ratio sends back
- Compliance summary per centre
- Expiring and expired credential lists
- Signed, time-limited evidence file links
How the fields map
Each record from OWNA lands on a specific field in Ratio. Status is calculated from the expiry date every time a page or report is opened.
| OWNA field | Ratio field | What happens |
|---|---|---|
| Employee / educator record | Staff record | Matched on work email first, then full name. Existing staff are updated, not duplicated. |
| Employee ID or payroll number | Contract number | Kept on the staff record and printed on the assessor evidence pack. |
| Position / role title | Role | Free text. Used for grouping the roster and for first aid coverage counts. |
| Qualification or certificate name | Credential type | Mapped to Ratio's credential catalogue (WWCC/Blue Card, first aid, anaphylaxis, asthma, CPR, qualification, police check). |
| Card / certificate number | Credential number | Stored as entered. Ratio records it; it does not verify it against a register. |
| Issue and expiry dates | Issued / expires | Expiry drives the live 90/30/7-day status at render time. Missing expiry shows as incomplete. |
| Attached certificate file | Evidence file | Images and PDFs up to 15 MB are stored against the credential. |
| Site / centre | Centre | Staff can belong to more than one centre in a group. |
Webhooks you can subscribe to
- credential.expiring
- credential.expired
- evidence.added
Every delivery is signed so your system can verify it came from Ratio.
Worth knowing
- This page is an integration guide for Ratio's open REST API and webhooks — not a turnkey connector installed with one click. Your platform contact or IT person wires it up once.
- Duplicate staff are merged on email, then name. You choose update or skip in the preview step.
- Credential types that do not match Ratio's catalogue import as 'Other' for you to reclassify.