Company-level Case Changes - onboarding data, insurance policies, bank details - reported the same way as any other case change (see New CaseChanges). Some company case fields don't hold a text or number value - they hold a file. An insurance policy PDF, a signed contract, a scanned ID: these are reported the same way as any other case change, just with a documents array attached to the value instead of (or alongside) a value.
This is different from Outputs: outputs are files Ason generates (payslips, declarations). Documents are files you upload as evidence for a case value.
Attaching a document
Add a documents array to any CaseValueSetup in a case change. Each entry needs a name, a contentType (MIME type), and base64-encoded content.
_
The response echoes back each value with its own id - that id is the case value id, and it's what you need to retrieve or delete the document later. It is not the same as the case change id.
Retrieving documents
_
Supports the usual OData query parameters (filter, select, top, skip, ...). Each item in the list is a reference (id, name, contentType) - append /{documentId} to fetch the actual content.
Deleting a document
DELETE the same single-document URL (.../documents/{documentId}) to remove it. This is permanent - there's no separate archive step.
FAQ
Can I attach a document without also setting a value?
Yes - the example above sets value: null and only attaches the document.
Is there a file size or type limit?
Not documented here - check the API Reference for the specific case field's constraints.
How does this differ from what Quickstart step 4 does?
It's the same mechanism - Quickstart step 4 is a live example of exactly this.
Do I see all of the company's data under Company Data?
Yes - every company-level case field relevant to your assigned regulations.
As of which date are the values shown?
Today's currently active values - there's no "as of" date picker on the main screen.
Can I see values from the past?
Yes - any field with more than one recorded value gets a History view, listing every value with its Start/End/Created dates.
Can I see values that aren't valid yet (future-dated)?
Yes - the same History view includes future-dated values, not just the currently active one.
Which documents do I see under Documents?
Files attached to case values - insurance policies, signed contracts, scanned IDs, and similar evidence. This is different from Outputs, which Ason generates itself (payslips, declarations).
Can I upload documents myself? Where?
Yes - attach a documents array to a case value, either through CaseMan or the API (see "Attaching a document" above).
Can I delete documents?
Via the API, yes (DELETE .../documents/{documentId}, permanent). In the standard product frontend, the delete control on the documents list is only visible to Ason's internal support role - a normal Admin/Manager user won't see a delete button there.
Company events (Ereignisse)
The company's case-change history - what was reported, when, and why. Each entry shows the event/field/value with its Start/End/Created dates and reason. There's no "changed by" attribution in the underlying data - you see what changed, not necessarily who entered it.
API Endpoints
| What | Call |
|---|---|
| Report a company case change | POST /tenants/{orgId}/payrolls/{payrollId}/cases/sets |
| List case fields that hold documents | GET /tenants/{orgId}/payrolls/{payrollId}/casefields |
| Get a company document | GET /tenants/{orgId}/companycases/{caseValueId}/documents/{documentId} |
| Delete a document | DELETE (same URL as above) |