Fill Peppol Endpoints in Bulk
Fill Peppol Endpoints looks up every Belgian customer and vendor that has no Peppol endpoint yet and fills in the one that is actually published in the public Peppol Directory. It is the fastest way to get an existing database ready, instead of opening cards one at a time.
Nothing is guessed. A party whose identifier is not published is left empty and listed with the reason, because a wrong endpoint looks finished and then fails at the first real send.
Before you start
- Outbound calls must be allowed for the extension, because this queries the public Peppol Directory.
- The parties need something to look up by: a Belgian Enterprise No. or a VAT Registration No. A party carrying neither is skipped and reported as such.
A party counts as Belgian when its country code is BE or blank.
Fill endpoints for everyone
- Choose the
Search icon, enter E-Invoice Platform Setup, and then choose the related link. - Choose the Fill Peppol Endpoints action.
- Read the confirmation, which tells you how many Belgian parties will be checked, and continue.
Each party costs up to two directory lookups, so on a large database this takes a moment. A progress bar shows how far it has got.
Fill endpoints for a selection
You do not have to do the whole database. The same action is available on the list pages, where it runs over the rows you selected:
- On the Customer List, select the customers and choose Fill Peppol Endpoints.
- On the Vendor List, select the vendors and choose Fill Peppol Endpoints.
Use this when you have just imported a batch of new parties, or when you want to try the feature on a handful of records before running it across everything.
Read the result
When the run finishes you get a summary counting the parties checked, filled, already set, not registered, without a Belgian identifier, failed lookups, and any that could not be written. If nothing needed doing, you are told so instead:
No Belgian customer or vendor has an empty Peppol endpoint, so there is nothing to fill.
For the detail, open the Peppol Endpoint Fill Results page, which keeps a row per party with one of these outcomes:
| Outcome | What it means | What to do |
|---|---|---|
| Filled | An endpoint was found and written | Nothing |
| Already set | The party already had one | Nothing |
| No identifier | Neither a Belgian enterprise number nor a BE VAT number on the party | Fill one in, then run again |
| Not registered | The identifier is not published in the directory | Ask the party for their participant identifier, or use Verify Recipient once you have one |
| Lookup failed | The directory could not be reached for this party | Run again later |
| Write failed | An endpoint was found but could not be saved to the party | Read the reason on the row; usually a permission or validation issue |
The page opens filtered to the run you just did. Choose Show All Runs to see earlier ones, and Open Party to jump straight to the customer or vendor that needs fixing.
Not registered is the outcome worth understanding. Registration in the Peppol Directory is optional, so it does not prove the party cannot receive documents — it only means the directory has nothing published for them. Many companies exchange invoices without appearing in it.
Where both the enterprise number and the VAT number are published, the enterprise number is written, because Belgium uses it as the default endpoint. The VAT one would deliver too.
What happens next
Parties that came back as Not registered or No identifier still need attention one by one. Open the party, fill in what is missing, and use Find in Peppol Directory or Verify Recipient on the card. See Set Peppol Endpoints on Customers and Vendors.
You can run the bulk fill again as often as you like. Parties that already have an endpoint are reported as Already set and are never overwritten.