Sona
Sona is a workforce management platform for frontline teams, covering rotas and shifts, absences, employment records and payroll. With Weld you can sync your Sona data into your data warehouse and combine it with your finance, HR and operational data to report on staffing levels, hours worked, absence and labour cost across your locations.
Features
| Feature name | Supported | |
|---|---|---|
| Column Hashing | True | Column level |
| Blocking | True | Column level |
| Incremental | True | |
| Custom data | False | |
| History | True | |
| ReSync | True | Table level |
| Templates | False |
Data Schema
Setup Guide - ELT
Prerequisites
You need a Sona API token for your organisation. Sona issues API tokens on request — contact your Sona representative or Sona support to get one. Weld only reads from Sona — it never writes back.
Step 1 - Request a Sona API token
- Ask Sona to issue a client API token for your organisation, for use with Weld.
- Ask for the token to have read access to the data you want to sync — shifts, pay lines, payroll, absences, users, employment periods, org units, metrics and the related reference data.
- Store the token somewhere safe until you have created the connection.
If a table fails with a message that the token does not have access to it, ask Sona to add that data to the token's permissions, then run the table again. You do not need to recreate the connection.
Step 2 - Create the connection
- In the Weld app, navigate to Connections and click + New Connection.
- Search for Sona and select it.
- Enter the destination schema name of your choice. This name is used to identify the connection in future syncs.
- Paste your API Token.
- Click Connect to validate the token and establish the connection.
Step 3 - Data To Sync
Select the tables you wish to include in the sync. You can view the schema, remove columns or hash sensitive information.
The connector exposes 17 tables, grouped below by area. Some tables bring related tables along with them — those are listed underneath.
- Shifts and pay —
shifts,pay_lines,payroll_submission_statuses,locked_periodsshiftsalso syncsshift_breaksandshift_people_we_supportpayroll_submission_statusesalso syncspayroll_submission_status_exceptions
- Absences —
absences,absence_typesabsencesalso syncsabsence_days,absence_documents,absence_linked_shiftsandabsence_linked_shift_payroll_run_rows
- People and employment —
users,employment_periodsusersalso syncsuser_manager_org_units,user_read_only_org_units,user_blocked_for_org_units,user_receives_content_for_org_units,user_home_tier_org_units,user_appears_on_roster_for_org_units,user_assignable_org_units,user_types_of_work,user_pay_groups,user_base_roles,user_skills_and_attributesanduser_auth_strategiesemployment_periodsalso syncsemployment_period_specs,employment_spec_contract_types,employment_spec_contracted_hours,employment_spec_rates_of_pay,employment_period_permission_roles,employment_period_permission_role_org_unitsandemployment_period_types_of_work
- Organisation —
org_unitsorg_unitsalso syncsorg_unit_external_connections,org_unit_public_holidaysandorg_unit_public_holiday_regions
- Metrics —
metrics,metric_values - Reference data —
contract_types,jobs,levels,rates_of_pay,shift_types,types_of_workshift_typesalso syncsshift_type_tags
Weld does not sync users' bank account details, home addresses or next of kin, or the download links of absence documents. The absence_documents table lists each document without its link.
Step 4 - Configure sync
- Select how often you would like the data to sync.
- Choose a start date to set how far back the initial sync goes for
shifts,pay_lines,payroll_submission_statusesandmetric_values. Without a start date,shifts,pay_linesandpayroll_submission_statusesgo back one year, andmetric_valuesgoes back two weeks. All other tables are synced in full. - Provide a unique destination table name.
shifts and metric_values also include the next two weeks, so rotas and metric values that are already planned in Sona appear in your warehouse ahead of time.
Weld will take over from here and commence syncing data from your Sona account.