Integration

OWNA logo

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 fieldRatio fieldWhat happens
Employee / educator recordStaff recordMatched on work email first, then full name. Existing staff are updated, not duplicated.
Employee ID or payroll numberContract numberKept on the staff record and printed on the assessor evidence pack.
Position / role titleRoleFree text. Used for grouping the roster and for first aid coverage counts.
Qualification or certificate nameCredential typeMapped to Ratio's credential catalogue (WWCC/Blue Card, first aid, anaphylaxis, asthma, CPR, qualification, police check).
Card / certificate numberCredential numberStored as entered. Ratio records it; it does not verify it against a register.
Issue and expiry datesIssued / expiresExpiry drives the live 90/30/7-day status at render time. Missing expiry shows as incomplete.
Attached certificate fileEvidence fileImages and PDFs up to 15 MB are stored against the credential.
Site / centreCentreStaff 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.