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:
- The tax rate on the customer's site.
- The tax rate on the customer.
- The default tax rate on the nominal code behind the line's container type or extra type.
- 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 withQ. 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.
| Message | What to do |
|---|---|
| This sale uses an unlisted customer | Pick 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 archived | The message says "Restore"; the control is Unarchive. Unarchive the customer, or point the sale at an active one. |
| Customer 'name' is on stop | Take 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 site | Pick or create a listed customer site on the sale. |
| Site 'name' is archived | Again the message says "Restore"; use Unarchive on the site, or use an active one. |
| Site 'name' is on stop | Take the site off stop. |
| The site contact is unlisted | A 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.
Link a customer to a Xero contact
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
- Manage contacts and link them to your customers and sites
- Set up your reference data, including tax rates, payment terms and sectors
- Create sales for your customers
- Review finance settings before you send your first invoice
- Connect Xero so invoices reach your accounts
- Give customers portal access
- Setup guide, step 9: Add your customers and sites if you are setting Paperwork up for the first time
Keep moving
Next steps
Explore further
Related Guides
Keep the people and businesses you deal with, link them to customers, suppliers and sites, and mark drivers so they can be booked on the scheduling board
Create a sale, add waste lines, extras, carriers and disposal sites, send the quote, turn it into an agreement and raise a job from it
Raise a job from a sale, fix what the job check blocks, print the transfer paperwork, record what was collected and hand the job to invoicing
Set up the lists Paperwork uses — tax rates, nominal codes, containers, departments, vehicles and more — and learn what depends on what
Set invoicing rules, bank details, invoice terms and the default invoice email in the Invoicing & Finance tab
Connect Paperwork to Xero, map your nominal codes and tax rates, authorise invoices into Xero, and fix invoices that fail to sync
Invite customers and suppliers to the read-only portal, choose which sites and areas they can see, and know what they will and will not be shown
Add customers and their sites, set the tax rate and payment term that decide invoice VAT and due dates, and fill in the country and consignment note prefix that hazardous jobs need