# DebitNote

object type

A DebitNote — the INCREASING corrective twin of the CreditNote (customer owes MORE — an undercharge correction, post-billing freight, an upward price adjustment): identical lifecycle + delta mechanics, OPPOSITE sign (every figure strictly POSITIVE). The tax delta recomputes over the invoice line's CAPTURED components; NO over-credit ceiling (an increase raises the invoice's remaining net — the CreditNote guard reads the raised headroom via the same cumulative stamps). NO inventory movement. Reuses the CreditNote's NoteDeltaLine/NoteDeltaTaxComponent SDL types (the /VendorInvoice entry-order precedent).

## Fields

| Field | Type | Notes |
| --- | --- | --- |
| `id` | [ID](/types/#scalars) `ID!` | The record’s id — a UUID the platform assigned when the record was created; every reference to this record uses it. |
| `sysId` | [String](/types/#scalars) `String!` | The group-scoped human-facing system id (DN-…). |
| `type` | [String](/types/#scalars) `String!` | The kind of record — always `DebitNote` here. |
| `caption` | [String](/types/#scalars) `String!` | The record’s display name — what people see it called. |
| `status` | [String](/types/#scalars) `String!` | The FSM state: issued \| closed \| voided. |
| `parentId` | [ID](/types/#scalars) `ID!` | The corrected Invoice's parent — the LF or org: an order-context SIBLING (the invoiceId ref binds); for a DebitNote parentId!== rootId. |
| `rootId` | [ID](/types/#scalars) `ID!` | The org-group family root. |
| `createdAt` | [String](/types/#scalars) `String!` | When the record was created, as a UTC timestamp. |
| `updatedAt` | [String](/types/#scalars) `String!` | When the record last changed, as a UTC timestamp. |
| `revisionNum` | [Int](/types/#scalars) `Int!` | How many times this record has been edited; the first save is 0. |
| `revision` | [ID](/types/#scalars) `ID!` | The OCC revision token — supply it on every mutation of this record; rotates on every write. |
| `refCaptions` | [RefCaption](/types/RefCaption/) `[RefCaption!]!` | The server-composed captions of this record's declared references (the referenced-caption rule) — one row per referenced id; see RefCaption. |
| `invoiceId` | [ID](/types/#scalars) `ID!` | The superseded Invoice. |
| `orderId` | [ID](/types/#scalars) `ID!` | The invoiced Order (copied from the invoice — the document-graph audit chain). |
| `organizationId` | [ID](/types/#scalars) `ID!` | The selling Organization (copied — attribution). |
| `currency` | [String](/types/#scalars) `String!` | The invoice currency (copied — deltas re-price the SAME fact in the SAME currency). |
| `reason` | [String](/types/#scalars) `String!` | The REQUIRED audit reason. |
| `settlementState` | [String](/types/#scalars) `String!` | The settlement rollup — born unsettled (the / writers widen it; dormant). |
| `baseDeltaTotalMinor` | [Int](/types/#scalars) `Int!` | Σ line base deltas (SIGNED — strictly positive here). |
| `taxDeltaTotalMinor` | [Int](/types/#scalars) `Int!` | Σ line tax deltas (SIGNED — the recompute mirror). |
| `totalDeltaMinor` | [Int](/types/#scalars) `Int!` | Σ line total deltas (SIGNED) — the note's net effect on what the customer owes. |
| `lines` | [NoteDeltaLine](/types/NoteDeltaLine/) `[NoteDeltaLine!]!` | The signed delta lines (1..45; every base delta strictly positive — the increasing arm). |

## Used by

- [debitNote](/reference/debit-note/debitNote/)
- [issueDebitNote](/reference/refunds-and-payment-corrections/issueDebitNote/)
- [settleDebitNoteToAr](/reference/refunds-and-payment-corrections/settleDebitNoteToAr/)
- [voidDebitNote](/reference/debit-note/voidDebitNote/)