Invoice integration and note creation

Understand the customer billing address default

This guide explains that how the create form composes the initial delivery address. 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 → Delivery Address

What you’ll accomplish

Know how the create form composes the initial delivery address. This guide follows the supplied Delivery Note module’s live hooks, controller actions, model rules, views and stored side effects.

Follow these steps

  1. Go to the create form from the invoice.
  2. Check the prefilled Delivery Address.
  3. Compare it with the actual delivery location.
  4. Amend it before saving when the delivery location differs.
  5. Save and verify the stored address.

Fields and options to review

  • billing_street
  • billing_city
  • billing_state
  • billing_zip
  • billing_country
  • Blank components are omitted and remaining values are joined on separate lines

Rules the system enforces

  • The default is copied from the source client at form display time.
  • It is a convenience value, not a mandatory match to the invoice billing address.
  • Editing the note address does not update the client or invoice address.

How to confirm it worked

  • The note records the confirmed delivery location while preserving the client’s core address records unchanged.

Safety checks and troubleshooting

  • Always verify the physical delivery address rather than accepting a billing default blindly.
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.