Metadata-Version: 2.1
Name: odoo-addon-currency_rate_update_banxico
Version: 19.0.1.0.0.3
Requires-Dist: odoo-addon-currency_rate_update==19.0.*
Requires-Dist: odoo==19.0.*
Requires-Dist: requests-mock
Summary: Update exchange rates using Banxico
Home-page: https://github.com/OCA/l10n-mexico
License: AGPL-3
Author: Jarsa, AMOdoo, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 19.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

.. 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: Banxico
=============================

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

.. |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--mexico-lightgray.png?logo=github
    :target: https://github.com/OCA/l10n-mexico/tree/19.0/currency_rate_update_banxico
    :alt: OCA/l10n-mexico
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/l10n-mexico-19-0/l10n-mexico-19-0-currency_rate_update_banxico
    :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-mexico&target_branch=19.0
    :alt: Try me on Runboat

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

This module extends *Currency Rate Update* with the
`Banxico <https://www.banxico.org.mx/>`__ exchange rate web service for
Mexican companies.

It adds **Bank of Mexico** as a currency rate provider and supports EUR,
CAD, JPY, GBP, and USD rates published by Banxico.

**Table of contents**

.. contents::
   :local:

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

To enable scheduled currency rates update:

1. Go to *Invoicing > Configuration > Settings*.
2. Ensure *Automatic Currency Rates (OCA)* is checked.

To configure the Banxico provider:

1. Go to
   `Banxico <https://www.banxico.org.mx/SieAPIRest/service/v1/token>`__
   to generate an API token.
2. Go to *Invoicing > Configuration > Currency Rates Providers*.
3. Create a provider or edit an existing one, select **Bank of Mexico**
   as the *Source Service*, and paste the token in *Banxico Token*.
4. Select the currencies to update and save the provider.

Usage
=====

After configuration, currency rates are updated like any other OCA
provider:

- On the provider form, use *Update Rates* to fetch rates for a date
  range.
- When automatic updates are enabled, the scheduled job refreshes rates
  according to the provider interval.

If your company currency is not MXN, Banxico rates are still fetched in
MXN and recalculated for your base currency. A warning is shown on the
provider form in that case.

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-mexico/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-mexico/issues/new?body=module:%20currency_rate_update_banxico%0Aversion:%2019.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
-------

* Jarsa
* AMOdoo

Contributors
------------

- `Jarsa <https://www.jarsa.com>`__:

  - Alan Ramos

- `AMOdoo <https://amodoo.org/>`__
- `Gray Matter Logic <https://www.graymatterlogic.com>`__:

  - Maxime Chambreuil <maxime.chambreuil@graymatterlogic.com>

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.

This module is part of the `OCA/l10n-mexico <https://github.com/OCA/l10n-mexico/tree/19.0/currency_rate_update_banxico>`_ project on GitHub.

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