Skip to main content

Brazilian Localization QR Code EMV (Pix)

Beta License: AGPL-3 OCA/l10n-brazil Translate me on Weblate Try me on Runboat

The Pix BR Code is the Brazilian profile of the EMV merchant-presented QR standard. account_qr_code_emv already builds that payload: TLV serialization, CRC16 and the common tags. What it cannot know is the country part, tag 26, which for Pix carries the br.gov.bcb.pix GUI and the addressing key.

This module fills that gap, so a customer invoice can be paid by scanning the QR code with any Brazilian bank app.

The addressing key is not duplicated here: it is read from res.partner.pix, which l10n_br_base already validates for the four key types the Central Bank defines.

Table of contents

Configuration

  1. Register the Pix key on the company partner, under Sales & Purchase > Pix Keys, and link it to the bank account that should receive the payment.

  2. On the bank account, set QR Code to EMV Merchant-Presented QR-code.

  3. On the journal of that bank account, enable QR Code so the payment link and the invoice report offer it.

Usage

The QR code is offered wherever Odoo already offers one: on the customer invoice report and on the payment page. Nothing else changes.

A Pix key must exist on the bank account, otherwise Odoo falls back to the next available QR method and reports why.

Bug Tracker

Bugs are tracked on GitHub 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.

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

Credits

Authors

  • KMEE

Contributors

Maintainers

This module is maintained by the OCA.

Odoo Community Association

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.

Current maintainer:

ygcarvalh

This module is part of the OCA/l10n-brazil project on GitHub.

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

Release files for odoo-addon-l10n-br-qr-code-emv 18.0.1.0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for odoo-addon-l10n-br-qr-code-emv 18.0.1.0.0.3
File Interpreter ABI Platform
odoo_addon_l10n_br_qr_code_emv-18.0.1.0.0.3-py3-none-any.whl Python 3 none any Details

Release files / odoo_addon_l10n_br_qr_code_emv-18.0.1.0.0.3-py3-none-any.whl

Download URL odoo_addon_l10n_br_qr_code_emv-18.0.1.0.0.3-py3-none-any.whl
Size 27.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
06f1995bbe256830744f222277822631c88bedd430e4b7f17627373c03ba6b39
BLAKE2b-256 checksum
How to use checksums
5295f988e1cbd316b6f1fc529d9bd32ade458ae9ddbc464aa4ef1b481d3e8f3f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release history Release notifications | RSS feed

This release

18.0.1.0.0.3 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page