expense_claims contract v2

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/expense_claims/v2.json",
  "title": "expense_claims contract v2",
  "type": "object",
  "required": [
    "claim_amount",
    "external_id",
    "submitted_time",
    "worker_id"
  ],
  "properties": {
    "currency": {
      "type": "currency",
      "description": "the currency both amounts are stated in",
      "x-demiton-requiredness": "tenant-specific"
    },
    "worker_id": {
      "type": "integer",
      "description": "the worker who submitted the claim; the shelf's subject anchor",
      "x-demiton-requiredness": "required"
    },
    "gst_amount": {
      "type": "number",
      "description": "the tax component included in `claim_amount`",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "tenant currency (AUD cohort)",
      "x-demiton-type": "decimal"
    },
    "description": {
      "type": "string",
      "description": "the tenant's description of what was purchased",
      "x-demiton-requiredness": "optional"
    },
    "external_id": {
      "type": "string",
      "description": "the source system's own identifier for the claim submission",
      "x-demiton-requiredness": "required"
    },
    "incurred_on": {
      "type": "string",
      "description": "the date the expense was incurred, where the tenant form supplies it distinctly from the submission time",
      "x-demiton-requiredness": "optional",
      "format": "date",
      "x-demiton-type": "date"
    },
    "claim_amount": {
      "type": "number",
      "description": "the total amount claimed",
      "x-demiton-requiredness": "required",
      "x-demiton-unit": "tenant currency (unit **unverified**)",
      "x-demiton-type": "decimal"
    },
    "approval_state": {
      "type": "string",
      "description": "whether the claim was approved, and by whom",
      "x-demiton-requiredness": "optional"
    },
    "submitted_time": {
      "type": "string",
      "description": "when the claim was submitted; the event time",
      "x-demiton-requiredness": "required",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "expense_category": {
      "type": "string",
      "description": "the tenant's own classification of the expense",
      "x-demiton-requiredness": "tenant-specific"
    },
    "evidence_reference": {
      "type": "string",
      "description": "pointer to the receipt/invoice document the claim is substantiated by",
      "x-demiton-requiredness": "optional"
    }
  },
  "x-demiton-register-type": "expense_claims",
  "x-demiton-contract-version": "2.0.1",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [
    {
      "axis": "worker",
      "requirement": "required",
      "role": "subject"
    },
    {
      "axis": "financial_period",
      "requirement": "optional",
      "role": "context"
    }
  ],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "A New Tax System (Goods and Services Tax) Act 1999 (Cth)",
        "title": "GST tax invoice requirements (ATO tax invoice guidance)",
        "access": "public_summary",
        "clause": "s.29-70",
        "region": "Australia",
        "edition": "ATO guidance updated 25 Aug 2025",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Payday Super (ATO)",
        "title": "Single Touch Payroll reporting under Payday Super",
        "access": "public_summary",
        "region": "Australia",
        "edition": "from 1 Jul 2026",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Single Touch Payroll Phase 2 (ATO)",
        "title": "Single Touch Payroll Phase 2 employer reporting guidelines",
        "access": "public_summary",
        "region": "Australia",
        "edition": "Phase 2 (mandatory from 1 Jan 2022)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Council Directive 2006/112/EC",
        "title": "VAT Directive - invoice content Article 226",
        "access": "full_text_verified",
        "clause": "Art 226",
        "region": "European Union",
        "edition": "consolidated 1 Jan 2025",
        "checked_on": "2026-09-14"
      },
      {
        "code": "EN 16931-1:2017",
        "title": "Electronic invoicing - semantic data model (Peppol BIS Billing 3.0 base)",
        "access": "paywalled_secondary",
        "region": "European Union",
        "edition": "2017 (withdrawn; 2026 edition published)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Goods and Services Tax Act 1985 (NZ)",
        "title": "GST taxable supply information (IRD guidance)",
        "access": "public_summary",
        "region": "New Zealand",
        "edition": "regime from 1 Apr 2023",
        "checked_on": "2026-09-14"
      },
      {
        "code": "HMRC Real Time Information (RTI)",
        "title": "PAYE Real Time Information - Full Payment Submission and Employer Payment Summary",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "guidance updated 6 Apr 2026",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Employee expense claims, by worker and period.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/expense_claims/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}