A Payroll (sometimes called an Organization Unit) is a company within a tenant, with its own regulations, employees and payrun periods.
Important: currently, only one Payroll per Tenant is actually supported in practice - see Tenant for details.
FAQ
What's the difference between a Tenant and a Payroll?
A Tenant is technically the container for one or more Payrolls (companies), each with its own regulations, employees and payrun periods - but currently, only one Payroll per Tenant is actually supported in practice.
How do I switch a payroll to production/live?
Set transmissionStartDate - see Outputs.
Can a payroll be deleted?
DELETE /tenants/{orgId}/payrolls/{payrollId} exists at the API level - treat it as a support/API-level operation rather than a routine self-service action.
How many payrolls can I have per tenant?
No documented limit at the API level - but currently, only one Payroll per Tenant is actually supported in practice.
Is the payroll's name functionally important, or just a label?
Just a display label - it doesn't affect Swissdec submissions or any calculation logic.
What is a Division?
A scoping unit that's effectively 1:1 with a payroll - it's auto-provisioned when you create the payroll, and employees/case values are tagged with it internally. It's not a separately managed multi-location or cost-allocation feature.
What is the accounting start date for, and which date should I set there?
accountingStartDate is the earliest date the payroll can calculate or post anything - no case change, event, or payrun period can be dated before it. Set it to the first date you want Ason to actually start accounting for this company (e.g. your go-live date with Ason, or the start of the data you're migrating).
Can the accounting start date be changed afterwards?
Not through the standard Settings screen - it's fixed once the payroll exists. The API has a dedicated operation to rebase it, but that deletes all payrun periods and reopens one with the new date, and only works before the payroll goes live - treat this as a support-assisted operation, not routine self-service.
What is the "language of documents", and can it be changed?
A payroll-level setting controlling the language of generated documents (payslips, etc.) - separate from each user's own CaseMan interface language. It can be changed any time in Payroll settings.
What is "Go live"?
Setting transmissionStartDate on the payroll - the one-time switch after which closing a period also submits to Swissdec. See Outputs.
By when do I need to switch on "Go live" during onboarding?
There's no enforced deadline - it's a manual step you trigger once you're ready for periods to actually be submitted to Swissdec. Periods close normally before that; the Swissdec-specific documents just aren't generated yet.
Can "Go live" be undone?
No - once transmissionStartDate is set, it can't be changed back through the standard product flow.
API Endpoints
| What | Call |
|---|---|
| List payrolls | GET /tenants/{orgId}/payrolls |
| Get a payroll | GET /tenants/{orgId}/payrolls/{payrollId} |
| Create a payroll | POST /tenants/{orgId}/payrolls/simple |
| Update a payroll (e.g. set the go-live date) | PUT /tenants/{orgId}/payrolls/{payrollId} |