OdooWiki OCA HUB

Brazilian Localization QR Code EMV (Pix)

l10n_br_qr_code_emv folder_open OCA/l10n-brazil open_in_new
Localization License: AGPL-3

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.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Adds Pix (Brazilian instant payment) QR codes to customer invoices, so customers can pay by scanning the code with any Brazilian bank app.

This module makes the QR code printed on invoices work as a Pix BR Code, the Brazilian version of the EMV payment QR standard. It only applies to bank accounts whose country is Brazil.

Where it appears: - On customer invoices, the QR code option becomes available for Brazilian bank accounts. - The Pix key is taken from the partner's registered Pix keys (managed by the Brazilian localization base module) and linked to the bank account.

Business rules and automatic behaviour: - The QR code is only generated when the invoice currency is Brazilian Real (BRL). - A Pix key must exist for the bank account, or for the partner; otherwise an error message explains that a key must be registered and linked. - The partner's city must be filled in, otherwise a "Missing Merchant City" error is shown. - The payment amount is always written with exactly two decimals, and the reference field is always included (using *** when empty), because Brazilian bank apps reject codes that do not follow these rules. - A default merchant category code is used for Brazilian accounts.

It extends the res.partner.bank model to build the Brazilian part of the QR payload, reusing the generic EMV QR code module for the rest.

Depends on

account_qr_code_emvl10n_br_base
Models and fields (1)
  • res.partner.bank · extends an existing model

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 1 confirmed, 8 with no information of 9 versions.

Sources · Odoo 18.0

Confirmed on 2026-11-03 in branch 18.0 of OCA/l10n-brazil.

terminal Installation and usage

OCA documentation · Odoo 18.0

Configuration

Source · Odoo 18.0
  • 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.
  • On the bank account, set QR Code to EMV Merchant-Presented QR-code.
  • On the journal of that bank account, enable QR Code so the payment link and the invoice report offer it.

Usage

Source · Odoo 18.0

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.

No verified information in OCA: Installation.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.