Invoice integration and note creation

Open the Delivery Note details modal on a new invoice

Use the optional modal to prepare delivery data before the invoice is saved.

Audience: Invoice staffPermission: Invoices: Create and Delivery Note: CreateModule v1.0.0
Exact navigationAdmin Area → Invoices → New Invoice → Delivery Note Details

What this guide covers

Use the optional modal to prepare delivery data before the invoice is saved. 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. Locate the Add Delivery Note panel on the new-invoice screen.
  2. Select Delivery Note Details.
  3. Review the modal title and guidance.
  4. Enter or amend the delivery values.
  5. Choose Use These Details to retain them and close the modal.
  6. Confirm Add Delivery Note is selected before saving the invoice.

Fields, choices and supported possibilities

  • Modal is created by module JavaScript
  • Delivery Date defaults to today
  • Textarea fields support address and notes
  • Use These Details selects the checkbox
  • Closing without selecting the feature must not create a note

Code-backed validations and workflow rules

  • The modal is injected only on the new-invoice editor.
  • It does not independently save a database record.
  • Values become hidden invoice-form fields only for the selected add-note branch.
  • Client-side UI is supplementary; the server-side model remains the record authority.

Expected result and verification

  • Prepared delivery details accompany the invoice save and are available to the after-invoice creation flow.

Checks, security and troubleshooting

  • Do not treat modal completion as final evidence until the saved note is opened.
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.