Customers and Projects

Open Plant Management reference tables in Samurai

Customer and Project records supply the invoice allocation, billing cycle and contact details. They are maintained under Reference Tables → Plant Management, separately from the operational Plant Management → Invoicing screen.

Customer setup

  1. Open Plant Management reference tables and select Customers.
  2. Find the Customer and open its editor, or add a new Customer where authorised.
  3. Check the invoice name/address, currency, accounts contact, invoice basis, and Billing start day.
  4. Review the structured Payment terms and select Save.

Billing start day applies to all of the Customer's Projects. It is a whole-number day from 1 to 31. A day that does not exist in a month is clamped to that month's final day; the next cycle is still calculated from the original configured day.

The selected invoicing month is the month in which that Customer cycle starts. For example, day 10 with September selected gives 10 September–9 October, inclusive. See Billing Periods and Calculation.

Payment terms determine the invoice due date from its issue date. One Invoice per Asset affects local PDF presentation; check the generated output rather than assuming it changes the customer/project grouping sent to Xero.

Project setup

  1. In Plant Management reference tables, select Projects.
  2. Find and edit the required Project, or add it where authorised.
  3. Confirm its Customer and Department or Site.
  4. Review Use customer invoice details. If it is disabled, complete the Project's own invoice details.
  5. Save and check the information before assigning Assets or calculating invoices.

The Project's Department supplies the billing timezone and relevant issuer details. Actual reading displays use the Asset Department/Site timezone, which can differ. Review the displayed reading targets and timestamps together.

Xero readiness

When using Xero, the Customer must map to a contact in the connected Xero organisation. Charges also need valid revenue External Account mappings. Ask the integration administrator to resolve organisation/contact mapping errors. See Print and Send Invoices.

Changes after calculation

Changing Customer or Project source information does not automatically rebuild saved invoice values. In particular, changing a Customer's billing start day leaves draft dates unchanged until an explicit recalculation, and existing billed dates can prevent an overlapping or incomplete transition.

Review the saved invoice and recalculate affected drafts as appropriate. Set or recheck invoice issue date, reference and customer-facing notes through Invoice Details after the final calculation.