Set Peppol Endpoints on Customers and Vendors
A Peppol endpoint is the address a document is delivered to. Without one on the customer card, a posted sales invoice for that customer cannot be sent. The Peppol Endpoint field is added to the customer and vendor cards, and four actions next to it help you find the right value and confirm it works.
To fill in many parties at once instead of one by one, see Fill Peppol Endpoints in Bulk.
Before you start
The lookup and verification actions call the public Peppol Directory and the Peppol network, so outbound calls must be allowed for the extension. See Set Up the Platform Connection.
Set the endpoint
- Open the Customer Card or Vendor Card.
- On the Peppol Endpoint field, choose the lookup, or choose the Find in Peppol Directory action.
- Search by name, and pick the entity from the results.
- Choose Verify Recipient to confirm the address resolves on the network.
You can also type the value directly. It has the form scheme:value — for example 0208:0802046676 for a Belgian enterprise number, or 9925:BE0802046676 for a Belgian VAT number. Other schemes are recognized too, including GLN (0088), Netherlands KvK and OIN, France SIRET and Germany Leitweg-ID.
A value in the wrong shape is refused straight away:
The Peppol endpoint "value" is not valid. Use scheme:value, for example 0208:0802046676 (Belgian enterprise number) or 9925:BE0802046676 (Belgian VAT).
Which check to use
There are two different questions here, and they have different answers. Getting them the wrong way round is the most common confusion on this page.
| Action | Question it answers | Authoritative? |
|---|---|---|
| Check Peppol Endpoint | Is this party published in the public Peppol Directory? | No |
| Show Peppol Details | Which document types has it published there? | No |
| Verify Recipient | Does this address resolve on the Peppol network, so a document would be delivered? | Yes |
Registration in the Peppol Directory is optional. Plenty of companies receive invoices without appearing in it, so a not published result does not mean the party is unreachable — it means the directory has nothing to say. Verify Recipient is the check that tells you whether a document would actually arrive.
When a party is not in the directory you get a message that says so and adds why it is not necessarily a problem, together with a suggestion to use Verify Recipient instead. When it does resolve on the network, verification confirms it; when it does not, you are told the document would not be delivered.
What the checks show you
Find in Peppol Directory and Search Directory open the Peppol Directory page. Type a name, address or identifier in Search For, choose Search, and the result count appears in Result. Each row shows the participant identifier, the registered name, the scheme, the country, and whether the party has published an invoice and a credit note type. Show Details opens Supported Document Types for the full list.
Verify Recipient opens Recipient Verification, which reports the registered name, the country, whether the address is reachable, and the document types it can receive. Read the registered name: a name you do not recognize means the identifier belongs to somebody else, and that is worth stopping for.
One limit to know: the Peppol Endpoint field is validated for format when you type it, never for reachability. A value can save cleanly and still fail at the first real send, which is why the verification step exists.
Vendors need a second look
For ordinary purchase invoices you receive, a vendor's endpoint is what lets Business Central recognize later documents from that supplier automatically.
For self-billed documents, the vendor must also be registered on the Peppol network as a receiver of those document types, which is a different registration from ordinary invoicing. A vendor who sends you invoices over Peppol is not necessarily set up to receive one from you. Use Verify Recipient on the vendor card before you rely on it — the error you get otherwise names this explicitly.
What happens next
With an endpoint set, a posted sales invoice for that customer can be sent, and the readiness box on the unposted document shows it as sendable before you post. To fill in the rest of your customers and vendors in one go, use Fill Peppol Endpoints in Bulk.