Integration
QikKids
One-way in, with status readable back through the API.
The field mapping for bringing a QikKids staff list and qualification records in through Ratio's open API, instead of retyping a roster you already maintain.
What comes into Ratio
- Staff list with roles and employment status
- Qualification records and unit codes
- First aid, anaphylaxis, asthma and CPR currency dates
What Ratio sends back
- Compliance summary
- Alerts feed
- Staff and credential status
How the fields map
Each record from QikKids lands on a specific field in Ratio. Status is calculated from the expiry date every time a page or report is opened.
| QikKids 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
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.
- Archived staff import as archived and stay out of your live compliance counts.
- Evidence files are not pulled automatically where the source system has none attached.