Skip to content
Dsposal
PaperworkPaperworkBeginner

Managing Customers

Add customers and their sites, set the tax rate and payment term that drive invoice VAT and due dates, and fix the customer and site checks that block jobs

9 min readUpdated 2026-10-26customerscustomer sites

Customers are the organisations you quote, collect from and invoice. Each customer can have any number of sites, and a sale or job points at one of them. Two optional fields on the customer, Tax rate and Payment term, quietly decide the VAT and due date on every invoice, so they are worth setting properly.

You will find customers under Relationships in the sidebar. What you can see and change depends on your role — see Members and Roles.

Set up your lists first

The customer form picks from lists you maintain in References, which only an organisation Owner can edit:

  • Tax rates and Payment terms can only be chosen, not created, on the customer. If the picker says "No tax rates found." or "No payment terms found.", add them in References first.
  • Sectors can be created as you go. Type a name into the picker and add it.

None of the three is required, which is exactly why it is easy to skip them. The section on tax rate and payment term below explains what happens if you do.

Add a customer

Open the customer form

Click Customers under Relationships, then New customer.

Fill in the identity

Name is the only required field. Account number is your own reference for the customer. If you have a Companies House number, enter it under Auto-populate from Companies House and click Look up to fill in the name, address and SIC codes. You will see "No company found for that number." if the number is wrong.

Add the trading address

Type a postcode into Find address by postcode to pick an address, or fill the address lines in yourself. Choosing a postcode also fills in the coordinates and, where the lookup knows them, Region and Country.

Add billing details

Under Billing, set Billing name if invoices go to a different name from the company, for example an accounts department. Leave Billing address is the same as the trading address ticked unless invoices go somewhere else.

Add company and finance details

Under Company details, add VAT number, Company registration number, SIC codes and Sector, then choose a Tax rate, Payment term and Credit limit. Notes are visible only to your team.

Create the customer

Click Create customer. If the customer should not be given new work yet, switch on Start this customer on stop first. You land on the customer's record, where you can add sites.

Choose a tax rate and payment term

These two fields do their work at invoicing time and give no warning when they are empty.

Payment term. The invoice due date comes from the customer's payment term. A customer with no payment term gets invoices with no due date at all.

Tax rate. For each line on an invoice, Paperwork looks for a VAT rate in this order and stops at the first one it finds:

  1. The tax rate on the customer's site.
  2. The tax rate on the customer.
  3. The default tax rate on the nominal code behind the line's container type or extra type.
  4. Nothing. The line is invoiced with no VAT.

So a customer-level Tax rate overrides the nominal code default, and a site-level rate overrides the customer. Set one on any customer who is zero-rated, reverse-charge or on a non-standard rate, and check a trial invoice for every new customer before you rely on it.

Add a customer site

A site is a physical location where you collect or deliver. Sales and jobs are raised against a customer site, so add them before you quote.

Open the Sites tab

Open the customer, then click the Sites tab and New site.

Fill in the site

Site name is required. You can copy details from the customer with Copy address from customer and Copy contact details from customer. Account number is your own reference.

Set the tax rate and consignment prefix if you need them

Tax rate on a site overrides the customer's rate for work at that site. Leave it blank to use the customer's. Consignment note code prefix is covered below.

Create the site

Click Create site. Switch on Start this site on stop first if the site should not take work yet.

Set the consignment note code prefix and country

These two site fields are only checked for hazardous waste. What happens depends on the country:

  • Country missing: the job is blocked.

  • Country not England: a warning only, and the prefix is not checked at all.

  • Country is England and there is no prefix: the job is blocked.

  • Country sits with the address. Choosing a postcode may fill it in, but not always, and the empty box suggests "e.g. United Kingdom". The check compares it with England, so a site whose country says "United Kingdom" gets the warning "Site is in United Kingdom, not England" and the advice "Consignment note rules differ outside England — check the paperwork applies." Whether or not you used the postcode lookup, check that Country reads England on every English site, or the prefix check is skipped and the warning stays.

  • Consignment note code prefix is the 6-character start of this site's consignment note codes, for example GREENW. Paperwork tidies what you type: it removes anything that is not a letter or number, makes it upper case, keeps the first 6 characters and pads a shorter one with Q. The form shows the result under the box as Code prefix:.

Fix a customer that blocks a job

When you raise a job from a sale, Paperwork checks the customer and site first. These are the customer and site messages and what to do about each. Anything marked as blocking has to be fixed before the job can be raised.

MessageWhat to do
This sale uses an unlisted customerPick or create a listed customer on the sale. "Assign a listed customer to the sale, or create one, before raising a job."
Customer 'name' is archivedThe message says "Restore"; the control is Unarchive. Unarchive the customer, or point the sale at an active one.
Customer 'name' is on stopTake the customer off stop: open the status pill on the customer and choose Active, or click Resume trading on the banner.
This sale uses an unlisted sitePick or create a listed customer site on the sale.
Site 'name' is archivedAgain the message says "Restore"; use Unarchive on the site, or use an active one.
Site 'name' is on stopTake the site off stop.
The site contact is unlistedA warning only. Choose a listed contact so the job keeps a maintainable record.

Someone with the Paperwork Owner role sees Bypass these failures, which lets them raise the job anyway by giving a Reason. The reason is recorded against the job with their name. That is the Paperwork role, not the organisation Owner in Account.

Put a customer on stop or archive it

The status pill at the top of the customer shows Active or On Stop. Click it to change it.

  • On Stop asks for a Reason for On Stop, then Put on stop. A banner shows the reason on the customer, with Resume trading to undo it. The menu describes it as blocking new jobs until resolved, and that is the job check above.
  • Archive takes a customer out of the Active list without deleting anything. It shows under Archived, and Unarchive brings it back.
  • Delete asks "Delete customer?" and removes the customer and its sites. People with delete permission can restore them from the Deleted view, but archive is almost always what you want.

Use the rest of the customer record

Besides Details and Sites, the customer record has these tabs:

  • Contacts lists the people linked to the customer, with Link a contact, and lets you build Groups of those contacts. See Managing Contacts.
  • Lists holds your own named lists of values for this customer, for example Departments, with Add list.
  • Purchase Orders holds the customer's own purchase orders, with a number, name, Valid from, Valid to and Order value.
  • Attachments holds files for the customer.
  • Opportunities, Sales, Jobs and Invoicing list that customer's records. Each appears only if your role can see it.
  • Portal access is where you give the customer a login to the customer portal. See Set up the Customer Portal.
  • Activity is the history of changes.

Create invoice at the top of the record starts an invoice for this customer if your role can create invoices.

If your organisation has connected Xero, an Accounting tab appears on each customer. It shows the linked Xero contact, how it was matched (Matched by account number, Matched by name, Chosen manually or Created from Paperwork) and who linked it.

A customer that is not linked says "Not linked to a Xero contact yet. Paperwork will try to match it automatically by account number or exact name when the first invoice is sent to Xero." Use Link to Xero contact to choose one yourself, Change to pick a different one, or Unlink. Unlinking does not touch invoices already in Xero. Change and Link to Xero contact are greyed out if Xero is not connected, with the hint "Reconnect Xero in Settings → Integrations to change the link."

Setting the customer's Account number to match the Xero contact's account number is the easiest way to get an automatic match.

Mark a customer as your own organisation

If you ever invoice your own company, switch on This is me on the customer. Paperwork also offers it with "This looks like you." when the name matches your organisation. Only one customer can be marked this way, and marking a second replaces the first after you confirm Mark as me. It labels the record "This is your organisation" and nothing else about sales or invoices changes.

What to do next

Keep moving

Next steps

Explore further

Related Guides