Author: |
Therp BV,Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
10.0-better-postcode-api |
Repository: |
NL66278/l10n-netherlands |
Dependencies: |
partner_street_number |
Languages: |
PO File (29, 7.5%),
Python (293, 76.1%),
XML (9, 2.3%),
and
reStructuredText (54, 14.0%) |
Other branches: |
10.0-add-letsencrypt_transip-nl,
10.0-add_dutch_states-cuntry,
10.0-l10n_nl_partner_salutation-gender,
10.0-no-state-override,
11.0-backport-kvk-fix,
11.0-fix-ln10n_nl_postcodeapi,
11.0-letsencrypt-transip-nl-with_postcodeapi-changes,
11.0-mig-combined,
11.0-mig-letsencrypt_transip_nl,
12.0-fix-l10n_nl_partner_name-more-room,
12.0-fix-l10n_nl_postcodeapi,
12.0-integrated-postcode-modules,
12.0-mig-l10n_nl_country_states,
12.0-mig-l10n_nl_dutch_company_type,
12.0-mig-l10n_nl_partner_salutation,
7.0-l10n_nl_postcodeapi,
8.0-account-chart-rgs,
8.0-fast-auditfile-export,
and
8.0-l10n_nl_privacy |
Other repositories: |
AMhadhbi/l10n-netherlands,
CGenie/l10n-netherlands,
LogicQ/l10n-netherlands,
Noviat/l10n-netherlands,
OCA/l10n-netherlands,
StefanRijnhart/l10n-netherlands,
apetbiz/l10n-netherlands,
danger89/l10n-netherlands,
daramousk/l10n-netherlands,
elperrofarelo/l10n-netherlands,
espo-tony/l10n-netherlands,
gfcapalbo/l10n-netherlands,
gustavovalverde/l10n-netherlands,
hbrunn/l10n-netherlands,
hineshr/l10n-netherlands,
janverb/l10n-netherlands,
jeroen-vet/l10n-netherlands,
lfreeke/l10n-netherlands,
lideritjnma/l10n-netherlands,
myonnet/oca-l10n-netherlands,
onesteinbv/l10n-netherlands,
pscloud/l10n-netherlands,
rossasa/l10n-netherlands,
smetl/l10n-netherlands,
sunflowerit/l10n-netherlands,
tarteo/l10n-netherlands,
uktc87504/l10n-bulgaria,
xpansa/l10n-netherlands,
and
ydreves/l10n-netherlands |
<a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.svg">
</a>
<a name="auto-completion-for-dutch-addresses"></a>
<h2>Auto-completion for Dutch addresses</h2>
<p>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.</p>
<p>More info about the lookup service here: <a class="reference external" href="http://www.postcodeapi.nu/">http://www.postcodeapi.nu/</a></p>
<p>The check on zipcode will not throw Errors in the user-interface, for
conditons like invalid or not set Api key parameter, failing connections,
or errors like the maximum number of lookups done. But these will cause
warnings or errors in the log. User preventable errors, like wrong zipcodes
will lead to validation errors.</p>
<a name="installation"></a>
<h3>Installation</h3>
<p>This module depends on the module partner_street_number, which will split
up the street field into separate fields for street name and number.</p>
<p>This module can be gotten from <a class="reference external" href="https://github.com/oca/partner-contact/tree/10.0">https://github.com/oca/partner-contact/tree/10.0</a></p>
<p>You also need to have the 'pyPostcode' Python library by Stefan Jansen
installed (<a class="reference external" href="https://pypi.python.org/pypi/pyPostcode">https://pypi.python.org/pypi/pyPostcode</a>).</p>
<a name="configuration"></a>
<h3>Configuration</h3>
<p>Please enter the API key that you request from PostcodeAPI into the system
parameter 'l10n_nl_postcodeapi.apikey'</p>
<p>Provinces are autocompleted if a country state with the exact name is found in
the system. This module is not directly dependent on l10n_nl_country_states,
but it is advisable to install that module to make sure all dutch
provinces (contry states) are in the database.</p>
<a name="compatibility"></a>
<h3>Compatibility</h3>
<p>This module is compatible with Odoo 10.0.</p>
<a name="usage"></a>
<h3>Usage</h3>
<a class="reference external image-reference" href="https://runbot.odoo-community.org/runbot/176/10.0"><img alt="Try me on Runbot" src="https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas" /></a>
<a name="bug-tracker"></a>
<h3>Bug Tracker</h3>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/l10n-netherlands/issues">GitHub Issues</a>.
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.</p>
<a name="credits"></a>
<h3>Credits</h3>
<a name="contributors"></a>
<h4>Contributors</h4>
<ul class="simple">
<li>Stefan Rijnhart (Therp BV) <<a class="reference external" href="mailto:stefan@therp.nl">stefan@therp.nl</a>></li>
<li>Ronald Portier (Therp BV) <<a class="reference external" href="mailto:ronald@therp.nl">ronald@therp.nl</a>></li>
</ul>
<a name="maintainer"></a>
<h4>Maintainer</h4>
<a class="reference external image-reference" href="http://odoo-community.org"><img alt="Odoo Community Association" src="http://odoo-community.org/logo.png" /></a>
<p>This module is maintained by the OCA at <a class="reference external" href="https://github.com/OCA/l10n-netherlands">https://github.com/OCA/l10n-netherlands</a></p>
<p>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.</p>
<p>To contribute to this module, please visit <a class="reference external" href="http://odoo-community.org">http://odoo-community.org</a>.</p>