$ 80.00
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
eCommerce (website_sale)
• Invoicing (account) • Discuss (mail) • Website (website) |
| Lines of code | 333 |
| Technical Name |
an_national_address |
| License | OPL-1 |
| Website | https://idealitsetup.com |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
eCommerce (website_sale)
• Invoicing (account) • Discuss (mail) • Website (website) |
| Lines of code | 333 |
| Technical Name |
an_national_address |
| License | OPL-1 |
| Website | https://idealitsetup.com |
| Versions | 18.0 19.0 |
Saudi National Address Lookup
العنوان الوطني السعودي
Auto-fill partner address from Saudi National Address API using Short Address code
تعبئة تلقائية لعنوان العميل من واجهة برمجة العنوان الوطني السعودي باستخدام العنوان المختصر
Screenshots
1. Partner Form - Short Address & Fetch Button | نموذج العميل
The Short Address field and "Fetch Address" button on the partner form in Odoo backend.
حقل العنوان المختصر وزر "جلب العنوان" في نموذج العميل في لوحة التحكم.
2. Website Checkout - Short Address on Delivery Page | صفحة الدفع
The Short Address field integrated into the website eCommerce checkout address form.
حقل العنوان المختصر مدمج في نموذج العنوان بصفحة الدفع في المتجر الإلكتروني.
3. API Key Configuration | إعداد مفتاح API
Simple API key configuration in General Settings.
إعداد بسيط لمفتاح API من الإعدادات العامة.
Overview
This module integrates the Saudi National Address API (العنوان الوطني) with Odoo 18, allowing you to automatically fill in partner address fields by simply entering a Short Address code (e.g., RRRD1234).
It works on both the Backend (Partner/Contact form) and Frontend (Website eCommerce Checkout page), saving time and ensuring address accuracy for Saudi Arabian partners and customers.
Use Case: A company operating in Saudi Arabia needs to quickly and accurately capture customer addresses. Instead of manually typing full addresses, users simply enter the Short Address code and click "Fetch Address" - the system automatically fills in Street, District, City, ZIP, State, Country, Building Number, and Plot Identification.
نظرة عامة
هذا الموديول يربط واجهة برمجة العنوان الوطني السعودي مع أودو 18، مما يتيح لك تعبئة حقول عنوان العميل تلقائيا بمجرد إدخال رمز العنوان المختصر (مثال: RRRD1234).
يعمل على كل من الواجهة الخلفية (نموذج العميل/جهة الاتصال) والواجهة الأمامية (صفحة الدفع في المتجر الإلكتروني)، مما يوفر الوقت ويضمن دقة العناوين للعملاء والشركاء في المملكة العربية السعودية.
حالة الاستخدام: شركة تعمل في المملكة العربية السعودية تحتاج لالتقاط عناوين العملاء بسرعة ودقة. بدلا من كتابة العناوين الكاملة يدويا، يقوم المستخدم ببساطة بإدخال رمز العنوان المختصر والضغط على "جلب العنوان" - ويقوم النظام تلقائيا بملء الشارع، الحي، المدينة، الرمز البريدي، المنطقة، الدولة، رقم المبنى، ورقم القطعة.
Key Features
| ✔ Short Address Field - Added to the partner form for quick address lookup |
| ✔ One-Click Fetch - Click "Fetch Address" to auto-fill all address fields instantly |
| ✔ Full Address Mapping - Street, District, City, ZIP, State, Country, Building Number, Plot ID |
| ✔ l10n_sa_edi Integration - Maps to Saudi e-Invoicing fields (Building Number, Plot Identification) |
| ✔ Backend Support - Works on the partner/contact form in Odoo backend |
| ✔ Website Checkout - Works on the eCommerce checkout address form |
| ✔ Easy Configuration - Simple API key setup in General Settings |
المميزات الرئيسية
| ✔ حقل العنوان المختصر - مضاف في نموذج العميل للبحث السريع عن العنوان |
| ✔ جلب بضغطة واحدة - اضغط "جلب العنوان" لملء جميع حقول العنوان تلقائيا |
| ✔ ربط كامل للعنوان - الشارع، الحي، المدينة، الرمز البريدي، المنطقة، الدولة، رقم المبنى، رقم القطعة |
| ✔ تكامل مع الفوترة الإلكترونية - يربط مع حقول l10n_sa_edi (رقم المبنى، رقم القطعة) |
| ✔ دعم الواجهة الخلفية - يعمل على نموذج العميل في لوحة التحكم |
| ✔ صفحة الدفع - يعمل على نموذج العنوان في صفحة الدفع بالمتجر الإلكتروني |
| ✔ إعداد سهل - ضبط مفتاح API بسيط من الإعدادات العامة |
How It Works
| Step 1: Get your API key from api.address.gov.sa |
| Step 2: Go to Settings > General Settings > National Address API and enter your API key |
| Step 3: Open any partner/contact form and enter a Short Address code (e.g., RRRD1234) |
| Step 4: Click "Fetch Address" - all address fields will be filled automatically! |
طريقة العمل
| الخطوة 1: احصل على مفتاح API من api.address.gov.sa |
| الخطوة 2: اذهب إلى الإعدادات > الإعدادات العامة > واجهة العنوان الوطني وأدخل مفتاح API |
| الخطوة 3: افتح نموذج أي عميل/جهة اتصال وأدخل رمز العنوان المختصر (مثال: RRRD1234) |
| الخطوة 4: اضغط "جلب العنوان" - سيتم ملء جميع حقول العنوان تلقائيا! |
Technical Information
| Attribute | Value |
|---|---|
| Technical Name | an_national_address |
| Version | 18.0.1.0.0 |
| Dependencies | base_setup, l10n_sa_edi, website_sale |
| License | OPL-1 (Odoo Proprietary License) |
| API Used | Saudi National Address API v3.1 |
| Models Extended | res.partner, res.config.settings |
| Views Extended | Partner Form, Settings Form, Website Checkout |
Contact & Support
$80 USD
Get professional support and customization services
| Developer: | Ahmed Magdy |
| Email: | qarsan4@gmail.com |
| Website: | idealitsetup.com |
| WhatsApp: | +966 509818413 |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module