Invoice integration and note creation

Create a Delivery Note from the module form

Follow this guide to use the invoice-linked create controller reached through the module’s invoice resolver. The guide then takes you through the correct route, the checks to complete before making changes, the workflow in order, and the evidence to review afterwards.

Audience: Delivery operations staffPermission: Delivery Note: CreateModule v1.0.0
Jump to steps
Where to goAdmin Area → Invoices → Open invoice → Create Delivery Note

What you’ll accomplish

Use the invoice-linked create controller reached through the module’s invoice resolver. This guide follows the supplied Delivery Note module’s live hooks, controller actions, model rules, views and stored side effects.

Follow these steps

  1. Start from the invoice because the create form requires an invoice ID.
  2. Go to the Create Delivery Note action.
  3. Check the right-hand Invoice Snapshot panel.
  4. Complete the form and save.
  5. Go to the new note from the success redirect.

Fields and options to review

  • Invoice ID and number
  • Client company and invoice total shown for context
  • Delivery date, method, delivered by, tracking, recipient, email, address and notes

Rules the system enforces

  • There is no free-standing create button that creates a note without an invoice.
  • The create controller builds its form from `invoice_snapshot(invoiceId)`.
  • The source invoice ID is determined by the route and is not an editable form field.

How to confirm it worked

  • The note is created against the intended invoice with an immutable creation-time snapshot.

Safety checks and troubleshooting

  • Reject any workflow that asks users to type an arbitrary invoice ID into a hidden or unsupported field.
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.