Regulations are the country-specific payroll ruleset (e.g. Swissdec) a payroll follows - also referred to as 'Payroll Logic'. They cover national, cantonal and best-practice rules, and are kept up to date automatically with daily updates as laws change.
Additional logic such as collective labour agreements is available on request.
FAQ
How often are regulations updated?
Daily, automatically - you don't need to track legal changes yourself.
Can I add custom logic on top of the standard regulations?
Yes - collective labour agreements, ERP interfaces and custom contract types are available on request.
Do regulations affect which case fields are available?
Yes - see New CaseChanges for how case fields vary by regulation.
Where do I assign regulations to a payroll?
On the Payroll's settings screen - it's the same operation as "Update a payroll's assigned regulations" above (PUT .../regulations), where you pick the country, industry (optional, multiple), and accounting-related regulations.
What do accountingDocument and accountingData refer to?
Both are regulation names, not literal filenames or free text - they're picked from a catalog, the same way countryRegulation and industries are. accountingDocument selects which template Ason uses when generating the accounting posting document on period close. accountingData selects which accounting-data scheme to use - this is the regulation behind your Chart of Accounts.
Where do I find the valid values for accountingDocument and accountingData?
Don't hardcode them from an example - list them for your own country regulation via GET /regulations/available, under that regulation's accountingDocument and accountingData arrays (each entry has a name and a displayName). Use the exact name value in PUT .../regulations.
What's the Switzerland regulation?
The country regulation containing Swiss payroll logic (Swissdec-based) - exactly one country regulation is assigned per payroll.
What are industry regulations?
Additional rulesets layered on top of the country regulation for a specific industry - you can add more than one, and they combine rather than replace each other.
Can an assigned regulation be removed again?
The country regulation can only be set once - it can't be swapped or removed afterwards. Industry and ERP regulations can be added over time but not removed once added. The accounting-related regulations (chart of accounts, accounting document) are replaceable (effective-date in actual open period).
Can I see what a specific regulation contains before assigning it?
Not as a dedicated preview screen - you see its effects afterwards, in the Wage Type Master and in which case fields become available.
API Endpoints
| What | Call |
|---|---|
| List available regulations | GET /regulations/available |
| Get a payroll's assigned regulations | GET /tenants/{orgId}/payrolls/{payrollId}/regulations |
| Update a payroll's assigned regulations | PUT /tenants/{orgId}/payrolls/{payrollId}/regulations |