v 8.0 v 9.0 v 10.0 v 11.0 v 12.0 Third Party 298
Download for v 11.0 Deploy on Odoo.sh
Lines of code 102
Technical Name l10n_nl_postcodeapi
Also available in version v 8.0 v 9.0 v 12.0 v 10.0
You bought this module and need support? Click here!

Integration with PostcodeApi.nu

Beta License: AGPL-3 OCA/l10n-netherlands Translate me on Weblate Try me on Runbot

This module contains integration of the excellent and free address completion service ‘PostcodeAPI’. The service allows lookups by zip code and house number, providing street name and city. The lookups will be triggered in the partner form views when a zip code or house number is entered or modified. Only Dutch addresses (which is assumed to include addresses with no country) are auto-completed.

More info about the lookup service here: http://www.postcodeapi.nu/

Table of contents


This module depends on the standard Odoo module base_address_extended, which will split up the street field into separate fields for street name and number.

You also need to have the ‘pyPostcode’ Python library by Stefan Jansen installed (https://pypi.python.org/pypi/pyPostcode).


Please enter the API key that you request from PostcodeAPI into the system parameter ‘l10n_nl_postcodeapi.apikey’

Provinces are auto-completed if a country state with the exact name is found in the system. A CSV file with the Dutch provinces is included in the data directory, but not loaded by default. You can import the file manually.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.



  • Therp BV



This module is maintained by the OCA.

Odoo Community Association

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

This module is part of the OCA/l10n-netherlands project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.
There are no ratings yet!
Nieuwe versie PostcodeApi
on 9/19/19, 2:56 PM

Deze module is gebouwd voor versie 2 van de PostcodeApi. Deze gaat verdwijnen. Inmiddels is er versie 3, maar daar is deze module niet op gebouwd, want de versie zit hard gecodeerd in de code. Kan het versie nummer niet, net als de apikey, als parameter worden meegegeven? Ik bedoel: is deze module op deze manier aan te passen, zodat hij in de toekomst ook geschikt is voor versie 4. NB: Versie 3 bevat ook de postbussen, versie 2 echter niet. Upgraden dus! De PostcodeApi is overigens niet meer gratis, maar wel goedkoop.