| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Lines of code | 1061 |
| Technical Name |
tcmb_currency_rates |
| License | LGPL-3 |
| Website | https://github.com |
TCMB Currency Rates
Official Turkish Central Bank Exchange Rate Integration
Automatically fetch official exchange rates from Turkey's Central Bank (TCMB/CBRT) and sync them to your Odoo currencies. No manual data entry, no third-party APIs.
β¨ Key Features
π Daily Automatic Updates
Scheduled action runs daily at 15:45 (TCMB publishing time) to fetch the latest rates. Set it and forget it β your currency rates stay current automatically.
π Historical Data Import
Import exchange rates from 16 April 1996 onwards. Perfect for:
- Financial reporting and analysis
- Historical invoice recalculation
- Compliance with tax regulations
- Multi-year financial statements
π― Per-Currency Control
Enable TCMB Auto toggle for each currency individually. Only selected currencies sync from TCMB β keep full control over your exchange rates.
π Complete Audit Trail
Run History logs every update (scheduled and manual) with detailed chatter messages:
- Success/Skipped/Error status
- Rates created and updated counts
- TCMB rate date and timestamps
- Detailed error messages for troubleshooting
βοΈ Configuration Options
Rate Type Choose which TCMB rate to use:
- Forex Buying β Bank buying rate for foreign exchange
- Forex Selling (default) β Bank selling rate
- Banknote Buying β Physical cash buying rate
- Banknote Selling β Physical cash selling rate
Retry Logic Configurable retries on network failures:
- Retry count (default: 3 attempts)
- Retry delay (default: 5 minutes between attempts)
Holiday Skip Automatically skip Turkey public holidays when TCMB is closed.
π Quick Start
- Install β Install Python dependencies:
pip install requests holidays - Configure β Go to Accounting β Configuration β Settings β TCMB Currency Rates
- Enable β Turn on "TCMB Auto" for currencies you want to sync (USD, EUR, etc.)
- Update β Click "Update from TCMB" button or wait for scheduled run
- Verify β Check Run History and Exchange Rates list
π Where to Find
- Main Menu: Accounting β Configuration β TCMB Rates
- Currencies: Accounting β Configuration β Currencies (button + columns)
- Settings: Accounting β Configuration β Settings β Invoicing
- Cron: Settings β Technical β Automation β Scheduled Actions
π― Use Cases
- Multi-currency Invoicing: Always use official TCMB rates
- Financial Reporting: Historical rate data for comparative analysis
- Tax Compliance: Use rates accepted by Turkish tax authorities
- Accounting Automation: Eliminate manual rate entry errors
- Multi-company: Different rate configurations per company
π Documentation
Complete user manuals available in the repository:
- User Manual (English) β Detailed text guide
- User Manual (Turkish) β TΓΌrkΓ§e detaylΔ± kΔ±lavuz
- Professional PDF Guide β Illustrated manual with graphics and tables
π§ Technical Details
Data Source: https://www.tcmb.gov.tr/kurlar/today.xml
Supported Currencies: All TCMB-published currencies (USD, EUR, GBP, CHF, AUD, etc.)
Rate Format: TCMB format (1 USD = X TRY) automatically converted to Odoo format
Storage: Rates stored in dedicated tcmb.currency.rate model before sync
π Support
- Issues: GitHub Issues for bug reports and feature requests
- Documentation: Comprehensive guides in /docs folder
- Source Code: Open source on GitHub
β’ Odoo 19 Community Edition
β’ Python packages:
requests, holidaysβ’ Active internet connection for TCMB API access
π License
LGPL-3.0 β Free and open source
Made with β€οΈ for the Odoo community
TCMB Currency Rates β Official Turkish Central Bank Integration
Please log in to comment on this module