This module contains integration of the excellent 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/
auto_awesome What this module does
AI-generated from the code · Odoo 12.0Automatically fills in Dutch street name, city and province on a contact form as soon as you type a Dutch postcode and house number, using the PostcodeApi.nu lookup service.
When you enter or change the postcode and house number on a contact (partner) form, Odoo can look up the address through the PostcodeApi.nu service and fill in the street name, city and province for you. This only happens for Dutch addresses; addresses with a different country are left untouched.
The lookup is triggered automatically on the contact form when the postcode, house number or country is changed. If no address is found, nothing is changed and a warning is written to the log.
To use the service you must store a valid API key in the system parameter l10n_nl_postcodeapi.apikey. The module ships with a placeholder value ('Your API key') which is ignored. When the key is created or modified, the module clears its cached connection and immediately verifies the key by performing a test lookup; if the connection cannot be verified, an error message is shown telling you to correct or remove the parameter.
The module extends the contact model res.partner and the system parameter model ir.config_parameter. It relies on the extended address fields (street name, house number) and on Dutch country states, so the province returned by the service can be matched to the correct state record.
Depends on
Models and fields (2)
- res.partner · extends an existing model
- ir.config_parameter · extends an existing model
Text generated by AI (DeepSeek) from reading the Odoo 12.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 1 confirmed, 8 with no information of 9 versions.
Sources · Odoo 12.0
Confirmed on 2026-11-03 in branch 12.0 of OCA/l10n-netherlands.
terminal Installation and usage
OCA documentation · Odoo 12.0Installation
Source · Odoo 12.0This 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.
It now also depends on l10n_nl_country_states, to provide the names of the provinces, that will be added to the res_country_state model.
You also need to have the 'pyPostcode' Python library by Stefan Jansen installed (https://pypi.python.org/pypi/pyPostcode).
Configuration
Source · Odoo 12.0Please 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.
No verified information in OCA: Usage.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.