Expense claims
Employee expense claims, by worker and period.
Part of Payroll in the register catalog.
- Register ID
expense_claimsUse this name to ask for the register. The API calls it a shelf ID.- Each record is
- An eventSomething that happened at a point in time.
- Status
- AvailableFilled today from connected systems, uploads or public data.
- Data
- OrganisationPrivate to each organisation's own workspace.
- Version
- v1Current version.
Connectors
On the roadmap
Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.
- MYOB Acumatica
- Xero Payroll AUPartial
Fields
11 fields: 4 required, 5 optional, 2 defined by each organisation.
Required
Every record carries these fields.
- external_idText
The source system's own identifier for the claim submission.
Example:
KP-EXP-90142- worker_idWhole number
The worker who submitted the claim; the shelf's subject anchor.
Example:
5502- submitted_timeDate and time
When the claim was submitted; the event time.
Example:
2026-06-12T17:30:00- claim_amountDecimal number
The total amount claimed.
Example:
186.4
Optional
Present when the source system records them.
- gst_amountDecimal number
The tax component included in
claim_amountExample:
16.95- incurred_onDate
The date the expense was incurred, where the tenant form supplies it distinctly from the submission time.
Example:
2026-06-11- descriptionText
The tenant's description of what was purchased.
Example:
Fuel for personal vehicle - Bundaberg site visit- evidence_referenceText
Pointer to the receipt/invoice document the claim is substantiated by.
- approval_stateText
Whether the claim was approved, and by whom.
Example:
approved
Defined by each organisation
Their contents come from the organisation's own forms or systems, so they differ between organisations.
- currencyCurrency code
The currency both amounts are stated in.
Example:
AUD- expense_categoryText
The tenant's own classification of the expense.
Example:
Travel - fuel
Example record
A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.
{ "approval_state": "approved", "claim_amount": 186.4, "currency": "AUD", "description": "Fuel for personal vehicle - Bundaberg site visit", "expense_category": "Travel - fuel", "external_id": "KP-EXP-90142", "gst_amount": 16.95, "incurred_on": "2026-06-11", "submitted_time": "2026-06-12T17:30:00", "worker_id": 5502}Use this contract
The contract is a standard JSON Schema (draft 2020-12) document, so any JSON Schema validator can check a record against it. Keywords starting with x-demiton- add Demiton's own meaning, such as units and requiredness, and validators ignore them.
https://docs.demiton.io/registers/expense_claims/v1.jsonShow the full JSON Schema
Loading the schema…
Talk to the team
Tell us what you run - your ERP, field, payroll and document systems - and we will show you the registers Demiton would keep current from them, on your data, in a 30-minute call.