Skip to main content

Holds, notes and external references

Where: a customer → Records. The add forms are the tabs Add hold, Add note and Add external reference.

Holds​

Who: customer.credit.view to see; customer.hold.manage to add; feature Holds.

A hold stops one kind of activity. It is separate from the account status: an ACTIVE customer can have a CREDIT hold.

Hold typeStops
CREDITNew orders (credit check fails)
ORDERNew orders
ACCOUNTAll ordering on the account
INVOICEInvoicing (recorded for Invoicing to respect)
DELIVERYDeliveries (recorded for dispatch to respect)

Add a hold​

  1. Records → Add hold.
  2. Choose the Type and enter the Reason (up to 500 characters).
  3. Save. "Created successfully. Account status and typed holds remain separate."

Example: Harbour Bistro (CUST-0023) has an invoice over 90 days late. Farah adds a CREDIT hold: "Invoice INV-0021 over 90 days overdue; account review 15 Nov." Nadia's next order for Harbour Bistro is refused: "Customer is on credit hold".

The Holds table shows Type, Reason, Active, Applied, Released and Release reason. Only one active hold of each type is allowed ("An active hold of this type already exists").

Releasing a hold isn't on the screen yet (see Help).

Internal notes​

Who: customer.note.view to see; customer.note.manage to add; feature Notes.

Notes are for staff only; customers never see them and the register search doesn't search them.

FieldRuleExample
TypeGENERAL, SALES, CREDIT, DELIVERY, INVOICING, COMPLIANCE, INTERNAL_WARNINGDELIVERY
Internal noteUp to 4000 charactersDeliveries before 10:00 only; use the rear entrance.
Effective fromOptional2026-11-01
Effective toOptional, not before Effective from(empty)

INTERNAL_WARNING notes are never shown in quick customer lookups used by other screens. Notes are never deleted.

External references​

Who: customer.view to see; customer.update to add; feature External references.

Link the customer to its ID in another system: your old ERP, an e-commerce shop, a marketplace.

FieldExample
System codeSHOPIFY
Reference typeCUSTOMER_ID
External reference7729913844

The register Search customers finds customers by an active external reference. The same reference can be active on only one customer. Passwords or keys must not be stored in references.

Next: Groups.