| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Discuss (mail) |
| Lines of code | 156 |
| Technical Name |
currency_rate_bam |
| License | LGPL-3 |
| Website | https://www.softarena.ma |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Invoicing (account)
• Discuss (mail) |
| Lines of code | 156 |
| Technical Name |
currency_rate_bam |
| License | LGPL-3 |
| Website | https://www.softarena.ma |
Odoo Enterprise only
This module requires Odoo Enterprise with the Live Currency app
(currency_rate_live). It is not for Odoo Community â use the publisherâs
Community edition module instead.
Bank Al-Maghrib â Live Currency (Enterprise)
Adds the official Bank of Morocco (Bank Al-Maghrib) as an exchange-rate provider inside Odoo Enterprise Live Currency. Rates are loaded over HTTPS from the official API using your subscription key.
Key features
- Provider: [MA] Bank Al-Maghrib in currency provider settings.
- Configuration: API URL,
Ocp-Apim-Subscription-Key, and HTTP timeout in Settings. - Morocco-ready default: Moroccan companies can default to this provider (country MA).
- Parsing: Supports the official JSON list format and a legacy JSON object shape as fallback.
Requirements
- Odoo Enterprise 19.0 (or compatible Enterprise) with a valid Enterprise subscription, plus Accounting and Live Currency (
currency_rate_live). - External service: a valid Bank Al-Maghrib API subscription key (Azure API Management).
- Network: outbound HTTPS access to the configured API endpoint.
How to obtain an API subscription key
To use Bank Al-Maghrib web services, you must register on the official developer portal. The portal states that users need to subscribe free of charge for an API key to access the services.
-
Create an account on the API portal
Open the developer helpdesk portal at
https://apihelpdesk.centralbankofmorocco.ma(copy this address into your browser) and click Sign up. Complete the registration form and validate your e-mail address. -
Log in and subscribe to a product
After your account is active, sign in and select the product that matches the service you need (for example, Foreign exchange market / Marché des changes for transfer / virement rates). Developer documentation explains that you obtain unique keys through Bank Al-Maghribâs developer services portal.
-
Retrieve your key
Once subscribed to the product, a subscription key is generated in your developer area (often a primary and a secondary key). You must send this key on every API call using the HTTP header
Ocp-Apim-Subscription-Key, or using thesubscription-keyquery parameter; otherwise the API typically responds with 401 Unauthorized.
With that key, you can query the CoursVirement endpoint for transfer rates and paste the same value into
Odooâs Ocp-Apim-Subscription-Key field in settings.
Odoo Apps compliance note
If your database includes Live Currency, use this Enterprise provider module.
For Community databases without currency_rate_live, use the separate
Community edition module from the same publisher instead.
Screenshot (illustrative)
Support
For purchase-related issues and configuration help, contact: helpdesk@softarena.ma
BAM FX Rates (Enterprise)
Overview
Odoo Enterprise Edition only. This module is not for Community.
It registers Bank Al-Maghrib as a Live Currency exchange-rate provider (technical module: currency_rate_live). If you run Community, install the publisher’s Community BAM rates module instead.
Requirements
- Odoo Enterprise 19.0 (or compatible), with Enterprise licensing
- Modules: account, currency_rate_live
- A valid Bank Al-Maghrib API subscription key (Ocp-Apim-Subscription-Key)
- HTTPS egress to the Bank Al-Maghrib API host
Configuration
Accounting settings → enable the provider [MA] Bank Al-Maghrib and fill the subscription key (and optional URL / timeout) in Settings.
Support
See the support field in __manifest__.py (Odoo Apps).
Please log in to comment on this module