Invoice integration and note creation

Understand one active Delivery Note per invoice

Understand the model rule that prevents duplicate non-void notes.

Audience: Administrators and delivery staffPermission: Delivery Note: ViewModule v1.0.0
Exact navigationAdmin Area → Invoices → Open invoice → Create or View Delivery Note

What this guide covers

Understand the model rule that prevents duplicate non-void notes. This guide follows the supplied Delivery Note module’s live hooks, controller actions, model rules, views and stored side effects.

Exact step-by-step process

  1. Open the invoice.
  2. Use the Delivery Note action.
  3. If a note exists, review or edit that record rather than creating another.
  4. Void the unsigned note only when replacement is authorised.
  5. After voiding, use Create Delivery Note to make the replacement.

Fields, choices and supported possibilities

  • Active lookup excludes records whose status is `void`
  • Invoice resolver redirects to existing active note
  • Creation hook checks for an existing non-void note

Code-backed validations and workflow rules

  • Open and signed notes are treated as active.
  • The database does not enforce a unique invoice ID; the application model enforces the active-note rule.
  • Direct database inserts can bypass this control and are unsupported.

Expected result and verification

  • Normal code flows maintain one current non-void note for each invoice.

Checks, security and troubleshooting

  • Do not duplicate delivery evidence to correct a typo; edit an open note or use the approved void-and-replace process.
Stay within the supported flowDo not force database values, expose secure tokens, bypass permission checks, replace a stored signature or invent a status or interface that the supplied code does not implement.