Metadata-Version: 2.1
Name: odoo-addon-currency_rate_update_bi
Version: 16.0.1.0.0.3
Summary: Update exchange rates using Bank Indonesia (BI) official rates
Home-page: https://github.com/OCA/l10n-indonesia
Author: PT Solusi Aglis Indonesia, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
License: AGPL-3
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 16.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Requires-Python: >=3.10
Requires-Dist: odoo-addon-currency-rate-update<16.1dev,>=16.0dev
Requires-Dist: odoo<16.1dev,>=16.0a

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

====================================
Currency Rate Update: Bank Indonesia
====================================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:cc3c074bc8f90c604795a321b1f666b77a2248a5da22189f87b8c90d165e1237
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--indonesia-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-indonesia/tree/16.0/currency_rate_update_bi
    :alt: OCA/l10n-indonesia
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/l10n-indonesia-16-0/l10n-indonesia-16-0-currency_rate_update_bi
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/l10n-indonesia&target_branch=16.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

Adds **Bank Indonesia (BI)** as a currency rates provider for the
``currency_rate_update`` module. Exchange rates are fetched from
Bank Indonesia's official SOAP webservice (wsKursBI) using the
``getSubKursLokal3`` method.

**Data Source:** Bank Indonesia — https://www.bi.go.id

**Rate Type:** Kurs Transaksi BI (Transaction Rates — middle rate / kurs tengah)

**Update Frequency:** Daily on business days (Mon–Fri, excluding Indonesian national holidays)

**Supported Currencies (vs IDR):**

+-----+----------------------------+
| USD | United States Dollar       |
+-----+----------------------------+
| EUR | Euro                       |
+-----+----------------------------+
| GBP | British Pound              |
+-----+----------------------------+
| JPY | Japanese Yen               |
+-----+----------------------------+
| SGD | Singapore Dollar           |
+-----+----------------------------+
| AUD | Australian Dollar          |
+-----+----------------------------+
| BND | Brunei Dollar              |
+-----+----------------------------+
| CAD | Canadian Dollar            |
+-----+----------------------------+
| CHF | Swiss Franc                |
+-----+----------------------------+
| CNY | Chinese Yuan               |
+-----+----------------------------+
| DKK | Danish Krone               |
+-----+----------------------------+
| HKD | Hong Kong Dollar           |
+-----+----------------------------+
| KRW | South Korean Won           |
+-----+----------------------------+
| MYR | Malaysian Ringgit          |
+-----+----------------------------+
| NOK | Norwegian Krone            |
+-----+----------------------------+
| NZD | New Zealand Dollar         |
+-----+----------------------------+
| SAR | Saudi Riyal                |
+-----+----------------------------+
| SEK | Swedish Krona              |
+-----+----------------------------+
| THB | Thai Baht                  |
+-----+----------------------------+

**Note:** This module is designed primarily for Indonesian companies
using **IDR (Indonesian Rupiah)** as their base currency. Cross-rate
calculations (e.g. USD base company wanting EUR rates) are supported
as long as the base currency is in the list above.

**Table of contents**

.. contents::
   :local:

Configuration
=============

To configure Bank Indonesia currency rates provider:

#. Go to *Invoicing > Configuration > Settings*
#. Ensure *Automatic Currency Rates (OCA)* is checked
#. Go to *Invoicing > Configuration > Currency Rates Providers*
#. Create a new provider with *Provider: Bank Indonesia (Kurs Transaksi)*
#. Select the currencies you want to update (USD, EUR, SGD, etc.)
#. Configure the update schedule (e.g., daily, weekly)
#. Save the provider

.. note::
   Your company's base currency should be **IDR (Indonesian Rupiah)**
   or one of the supported foreign currencies if you need cross-rate
   calculations.

Usage
=====

After configuration, currency rates are automatically updated based on
your schedule. To manually update rates:

#. Go to *Invoicing > Configuration > Currency Rates Providers*
#. Select the Bank Indonesia provider
#. Click *Action > Update Rates Wizard*
#. Set the date range (From/To dates)
#. Click *Update* to fetch rates from Bank Indonesia

To view the fetched rates:

#. Go to *Invoicing > Configuration > Currencies*
#. Select a currency (e.g., USD)
#. Open the *Rates* tab to see historical exchange rates

The rates are fetched from Bank Indonesia's official webservice at
https://www.bi.go.id/biwebservice/wskursbi.asmx and represent the
middle rate (average of buy/sell rates) for each currency pair.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-indonesia/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/l10n-indonesia/issues/new?body=module:%20currency_rate_update_bi%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
~~~~~~~

* PT Solusi Aglis Indonesia

Maintainers
~~~~~~~~~~~

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

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.

.. |maintainer-hitrosol| image:: https://github.com/hitrosol.png?size=40px
    :target: https://github.com/hitrosol
    :alt: hitrosol

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-hitrosol| 

This module is part of the `OCA/l10n-indonesia <https://github.com/OCA/l10n-indonesia/tree/16.0/currency_rate_update_bi>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
