Browse the manual

Record a customer's address

The Address block on the customer form: when the postcode lookup fires, why the country on a contract can differ from the one on screen, and why the Addresses screen is a map

11 min read

What this page covers

  • Fill an address from a postcode
  • Country recorded twice
  • Why addresses accumulate

Introduction

A customer's address is not a screen of its own. It is a section headed Address partway down the customer form, between Blocked and the Birth section, holding Postal code, House number, House number addition, Street, City and Country, with PO Box appearing above them on business customers only. You reach it the same way you reach everything else about a customer: open the customer and scroll. Customers whose address has no city or country are collected on a list headed Incomplete addresses.

There is a second screen involved, and it is not what its name suggests. Addresses, the tile next to Customers in the customer menu, opens a screen headed Addresses that is a map. It drops a pin for every address your company has ever recorded and gives you nothing to click — no list, no search, no way to open or correct one of them. All the typing happens on the customer form.

You will use this when:

  • a new customer gives you their address at the desk
  • an invoice comes back undelivered and the address turns out to be wrong
  • a customer has moved and asks you to update their details
  • a payment or a document refuses to go out because the address is incomplete
  • a booking warns Address incomplete: city and country are needed for the invoice and the deposit refund.

Words used on these screens

The screen saysIt means
House number additionThe bit after the number — a letter, "bis", an apartment number
PO BoxA post-office box number, used instead of a street address for a business
Incomplete addressesThe list of customers whose address is missing a city or a country

Where an address can come from

Where you startWhat you get
The Address section on the customer formThe one address that belongs to that customer. This is the only place you can type one.
Incomplete addresses, below the Active list of customersThe customers whose address lacks a city or country. Click a row to open the form.
Addresses in the customer menuA map of every address your company holds. Look only — nothing on it can be opened or edited.
The postcode lookup, on Dutch addressesStreet and City filled in for you from Postal code and House number.

Every customer gets exactly one address when created, so you always fill one in rather than add one.

How to use

Configuration

One setting decides which country a new address starts on. From the main menu open Admin, then Settings, then click the Operational tile. On the screen headed Operational settings, on the General tab that opens first, set Default Country, then press Save at the bottom of the screen.

SettingDefaultWhat it does
Default CountryemptyThe country every new customer's address, dial code and nationality start on. Leave it empty and the app fills it in with the Netherlands the first time a customer is created, and saves that as your company's setting.

It applies from the moment you save it. Addresses already in the system keep the country they were given and are not looked up again.

The postcode lookup needs no setting: it is always on, and it asks the public Dutch address register, not one of the outside services on the Integrations screen.

Before you start: filling in an address needs nothing more than a normal staff account, because it is part of the customer form. Operational settings is limited to a company administrator, so ask them if new customers are starting on the wrong country.

Using the address block

From the main menu open Customers, then click the Customers tile. Find the customer on the list headed Customer and click their row, or press New Customer to make one. Scroll down the form past Notes and Blocked to the section headed Address.

  1. Type the Postal code. Lower-case letters are turned into capitals as you type.
  2. Type the House number, digits only — anything else goes in House number addition next to it.
  3. Wait a moment. On a Dutch postcode Street and City fill themselves in. If they do not, type them yourself.
  4. Check Country. It is a picker, and it already holds your company's default country. Pick a country after the lookup has run, not before — see Key details.
  5. On a business customer, fill in PO Box if invoices go to a box number rather than the street address. The box is not shown on private customers.
  6. Press Save at the top right of the customer form. Nothing in this section is stored until you do, and Cancel discards it.

To fix addresses missing a city or country: on the list headed Customer, click Incomplete addresses (warning-triangle icon) below the Active list. Click a row, fill in the missing boxes on the customer form, and press Save. The next time you open the list, that customer is no longer on it.

Skim the table below once; you will come back to particular rows as they come up:

FieldDefaultWhat it doesWhat it will accept
Postal codeemptyFeeds the lookup and the second address line on documentsAny text; only a code of exactly six characters triggers the lookup
House numberemptyThe number printed before the addition on documentsAny text up to 50 characters
House number additionemptyPrinted straight after the house number, with no spaceAny text up to 20 characters
Streetempty, or filled by the lookupThe first address line on documentsAny text up to 200 characters
Cityempty, or filled by the lookupPrinted after the postal code on documents; needed for invoices and deposit refundsAny text up to 100 characters
Countryyour company's default countryThe country shown on screen and, through its two-letter code, on documents; needed for invoices and deposit refundsPick from the country list
PO BoxemptyAn alternative delivery address for a businessAny text; shown only when is company is yes

A worked example. The lookup fires when you leave Postal code or change House number, if the postcode is exactly six characters and a house number is filled in. Type 1012AB with house number 7 and Street and City arrive on their own. Type 1012 AB, as printed on an envelope, and the space makes it seven characters — nothing happens, and no message says why. 1012ab works, because the box capitalises it first. A Belgian 1000 never triggers the lookup; fill in Street and City by hand.

Key details

The country is stored twice, and documents print the copy you cannot see. The Country picker on the customer form is what staff read on screen. Alongside it the app keeps a two-letter code, and contracts and invoices print that code. Picking a country in the picker sets the code to match, so the two normally agree.

The lookup writes the country too. When the postcode lookup runs it forces the hidden two-letter code to NL, because it only ever looks up Dutch addresses, and it leaves the picker alone. So a customer whose picker says Belgium can still print NL if the lookup ran after the country was picked. Picking the country last keeps the two in step.

A missing city or country is flagged, not refused. The form saves without them. The customer on a booking — on both booking screens — then shows Address incomplete: city and country are needed for the invoice and the deposit refund., and once they have a booking or an invoice they are on Incomplete addresses. Their invoices go out without an address and their deposit cannot be refunded until both are filled in.

Addresses are printed as two lines: street, house number and addition run together, then postal code and city. An addition typed with a leading space, or "7 bis" in one box, looks wrong on the contract rather than on screen.

Nothing here can be deleted. No account, not even a company administrator's, can remove an address once it exists, and nothing removes one when a customer is archived or merged away. That is why the map under Addresses keeps growing and shows pins for customers you no longer deal with.

What to do next: with the address in place the customer can be invoiced. Go back to Create a customer record for the rest of the form, or open the customer's booking if you came here to get a payment out.

Q&A

Why does the wrong country come out on a customer's contract? The contract prints the hidden two-letter code, and the postcode lookup sets that code to NL without changing the Country picker. Open the customer, choose the right country in Country again — if the picker already shows it, pick another country first and then the right one, so the change registers — and press Save before the next contract goes out.

Why does a booking say "Address incomplete: city and country are needed for the invoice and the deposit refund."? The customer's address has no City or no Country. Open the customer from the booking, fill in both in the Address section, and press Save. The warning goes once the booking screen is opened again.

Why do Street and City not fill themselves in? Two things have to be true, and the screen tells you which one failed for neither of them. The postcode must be exactly six characters, so no space; and House number must not be empty. Check the space in the postcode first — it is the usual cause. The lookup only knows Dutch addresses.

Why did Street and City go blank after I typed a foreign postcode? Any postcode of exactly six characters starts the Dutch lookup. When the Dutch register does not know it, the lookup empties Street and City and sets the country code to NL. Type the street and city again after the postcode and house number, then pick the country, and press Save.

Why did the lookup overwrite a street I had already typed? The lookup replaces Street and City with whatever it finds, so anything you typed by hand goes. Fill in Postal code and House number first and let it run, then correct what it brought back.

Where do I add a second address for a customer? You cannot. Each customer carries one address and the form shows only that one, so a customer with a separate invoice address has to be handled another way — use PO Box on a business customer, or keep the second address in Notes on the customer form.

The Addresses screen shows pins in the wrong places. The map places each pin from the street name alone, without the house number, postcode or city, so pins land on any street of that name anywhere. Treat the map as a rough picture of where your customers are, not as a way to find one.

Why does an online payment fail with "Cannot create payment"? The bank needs a complete address, and the app sends whatever it has without checking first. If Street, Postal code, City, Country or House number is blank the payment is refused at the bank's end, and the message that comes back does not say which one was missing. Fill in all five on the customer form, press Save, and send the payment link again.

Can I clean up old addresses? No. Nobody can delete an address, and nothing clears them out when a customer leaves. Leave them; they do no harm beyond crowding the map.

Related pages: Create a customer record for the rest of the form this section sits in. Confirm a booking for the checks a booking runs against the customer once the details are in. Refund deposits and overpayments to customers for the refund that needs the city and country.