This module introduces a function that automatically retrieves and fills in the Japanese address details for a partner using the zipcloud service, provided that the following conditions are met.
- Country is Japan or no country is set for the partner.
- A valid postcode is entered for the partner.
Note that in order to have the prefecture proposed automatically, you need to have the prefecture records in Japanese (e.g. "福岡県" instead of "Fukuoka"). This can be done by overriding the name of correspoinding res.country.state records, or by installing the l10n_jp_country_state module.
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Automatically fills in Japanese address details (prefecture, city, street) for a partner when a 7-digit Japanese postcode is entered, using the zipcloud lookup service.
When you type a postcode on a partner form, this module can look up the Japanese address and fill in the prefecture, city and street for you.
- It only runs when the partner's country is Japan or left empty, and a postcode is present.
- The postcode is cleaned first: full-width digits are converted to normal digits and hyphens are removed. Only digits are accepted, and the postcode must be exactly 7 digits, otherwise an error message is shown.
- The module then queries the zipcloud service. If the service returns an error, a message is displayed.
- On a successful match, the prefecture is set in
state_id, the city incity, the street instreet, and the country is set to Japan. - If the prefecture name is not found in the current language, the module tries to find it using Japanese language records, so prefectures stored in Japanese (for example "福岡県") can still be matched.
- Existing values for prefecture, city and street are cleared before the new values are filled in.
This affects the partner form (res.partner) and uses the country and state reference data (res.country, res.country.state). It requires the external Python library jaconv to be installed.
Depends on
Models and fields (2)
- res.partner · new model
- zip.search.mixin · new model
Text generated by AI (DeepSeek) from reading the Odoo 18.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: 4 confirmed, 5 with no information of 9 versions.
Sources · Odoo 18.0
Confirmed on 2026-11-03 in branch 18.0 of OCA/l10n-japan.
terminal Installation and usage
No verified informationInstallation 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.