Invoice types & data standards

Credit and debit notes: the edge cases that actually cause rejections.

Adjustment documents inherit every constraint of the invoice they reference — plus a few of their own.

Credit note

Reduces a previously issued invoice

Must reference the original invoice's UUID and hash. If the original invoice hasn't cleared yet, or cleared with warnings, the credit note can be rejected or flagged for manual review depending on the authority's rules.

Debit note

Increases a previously issued invoice

Same referencing requirement as a credit note, plus its own tax calculation on the additional amount — rounding must be consistent with how the original invoice calculated tax.

Common pitfall

Out-of-order submission

If a credit note is submitted before its original invoice has fully cleared, the reference lookup fails. dsFatoora enforces submission order so this can't happen even under high concurrency.

Common pitfall

Partial credits against consolidated invoices

Crediting a single line item out of a large consolidated/summary invoice requires precise line-level referencing — a common source of validation failures at high line-item volumes.