Skip to content
Demiton

Credit note (v2)

Credit note is one of Demiton's published registers for Australian civil construction. Credit notes issued against invoices. Demiton keeps it current from the systems a contractor already runs and publishes the record's shape as a versioned JSON Schema, so the same question works whichever system produced the record.

Part of Financials in the register catalog.

Register ID
credit_noteUse this name to ask for the register. The API calls it a shelf ID.
Status
PlannedDefined ahead of the connector that will fill it.
Data
OrganisationPrivate to each organisation's own workspace.
Version
v2 (2.0.1)Superseded by v3.

Standards

This register's contract was designed against these standards and laws. Holding these records does not by itself certify compliance.

  • ATO record-keeping rulesATO business record-keeping rules (ITAA 1936 s 262A; TAA 1953 Sch 1 s 382-5)Australia · ATO page updated 2025-08-01 · public summary
  • Corporations Act 2001 (Cth) s 286Corporations Act 2001 (Cth) - obligation to keep financial recordsAustralia · current · clause s 286(1), 286(2) (7 years) · verified against full text
  • PINT A-NZ Billing BISPeppol PINT A-NZ Billing BISAustralia · 1.1.3 · clause preceding-invoice reference for credit notes · verified against full text
  • EN 16931-1:2017CEN EN 16931-1 semantic data model (covers invoice and credit note)European Union · 2017 (2026 edition published) · public summary
  • Peppol BIS Billing 3.0Peppol BIS Billing 3.0 (CIUS of EN 16931)International · 3.0.21 (May 2026 release) · clause conformance statement; business requirement groups · verified against full text
  • GST Act 1985 (NZ)Goods and Services Tax Act 1985 (NZ) - supply correction informationNew Zealand · from 1 Apr 2023 · clause supply correction information (s 19N per legislation index) · public summary
  • PINT A-NZ Billing BISPeppol PINT A-NZ Billing BISNew Zealand · 1.1.3 · clause preceding-invoice reference for credit notes · verified against full text

Connectors

Connected today

Demiton keeps this register current from these systems now.

No system fills this register yet.

On the roadmap

Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.

None planned yet.

Fields

19 fields: 7 required, 12 optional.

Required

Every record carries these fields.

totalMoney amount

The credit note total including tax.

Example: 8250

statusText

Draft, authorised, paid or voided.

Example: authorised

currencycurrency

The currency the credit note is in.

Example: AUD

directionText

Whether this is a receivable credit or a payable credit.

Example: payable

issued_onDateYYYY-MM-DD

The credit note's date.

Example: 2026-06-18

external_idText

The source system's own credit note id.

Example: BC-CN-100542

counterpartyText

The customer or supplier the credit is with.

Example: Sunshine Coast Quarries Pty Ltd

Optional

Present when the source system records them.

due_onDateYYYY-MM-DD

When the credit falls due.

numberText

The credit note number.

Example: CN-100542

subtotalMoney amount

The total before tax.

Example: 7500

referenceText

The counterparty's reference.

Example: Returned aggregate - PO 44120

total_taxMoney amount

The tax on the credit note.

Example: 750

line_itemsList

The credit note's lines.

allocationsList

Which invoices the credit was applied to.

currency_rateDecimal number

The exchange rate applied.

fully_paid_onDateYYYY-MM-DD

When the credit was fully used.

applied_amountMoney amount

Credit already applied.

remaining_creditMoney amount

Credit not yet allocated.

Example: 8250

Example record

A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.

credit_note.example.json
{
"counterparty": "Sunshine Coast Quarries Pty Ltd",
"currency": "AUD",
"direction": "payable",
"external_id": "BC-CN-100542",
"issued_on": "2026-06-18",
"legal_entity": "Bridgeworks Group Pty Ltd",
"number": "CN-100542",
"reference": "Returned aggregate - PO 44120",
"remaining_credit": 8250,
"source_system": "D365_BUSINESS_CENTRAL",
"status": "authorised",
"subtotal": 7500,
"total": 8250,
"total_tax": 750
}

Version history

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.

Schema URL
https://docs.demiton.io/registers/credit_note/v2.json
Show 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 fill from them, on your data, in a 30-minute call.

Book a 30-minute callStart free