Brazilian Localization QR Code EMV (Pix)
El Pix BR Code es el perfil brasileño del estándar EMV de QR presentado por el comerciante. account_qr_code_emv ya construye esa carga útil: serialización TLV, CRC16 y las etiquetas comunes. Lo que no puede conocer es la parte del país, la etiqueta 26, que para Pix lleva el GUI br.gov.bcb.pix y la clave de direccionamiento.
Este módulo cubre esa carencia, de modo que una factura de cliente puede pagarse escaneando el código QR con cualquier aplicación bancaria brasileña.
La clave de direccionamiento no se duplica aquí: se lee de res.partner.pix, que l10n_br_base ya valida para los cuatro tipos de clave que define el Banco Central.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 18.0Añade códigos QR de Pix (pago instantáneo brasileño) a las facturas de cliente, para que los clientes puedan pagar escaneando el código con cualquier aplicación bancaria brasileña.
Este módulo hace que el código QR impreso en las facturas funcione como un Pix BR Code, la versión brasileña del estándar EMV de códigos QR de pago. Solo se aplica a cuentas bancarias cuyo país sea Brasil.
Dónde aparece: - En las facturas de cliente, la opción de código QR pasa a estar disponible para cuentas bancarias brasileñas. - La clave Pix se toma de las claves Pix registradas del partner (gestionadas por el módulo base de localización brasileña) y se vincula a la cuenta bancaria.
Reglas de negocio y comportamiento automático: - El código QR solo se genera cuando la moneda de la factura es el Real brasileño (BRL). - Debe existir una clave Pix para la cuenta bancaria, o para el partner; de lo contrario, un mensaje de error explica que se debe registrar y vincular una clave. - La ciudad del partner debe estar rellenada; de lo contrario, se muestra un error "Missing Merchant City". - El importe del pago siempre se escribe con exactamente dos decimales, y el campo de referencia siempre se incluye (usando *** cuando está vacío), porque las apps bancarias brasileñas rechazan los códigos que no siguen estas reglas. - Se utiliza un código de categoría de comercio predeterminado para las cuentas brasileñas.
Extiende el modelo res.partner.bank para construir la parte brasileña del payload del código QR, reutilizando el módulo genérico de códigos QR EMV para el resto.
Depende de
Modelos y campos (1)
- res.partner.bank · amplía un modelo existente
Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 1 confirmada, 8 sin información de 9 versiones.
Fuentes · Odoo 18.0
Confirmado el 2026-11-03 en la rama 18.0 de OCA/l10n-brazil.
terminal Instalación y uso
Documentación de OCA · Odoo 18.0Configuración
Fuente · Odoo 18.0- Registre la clave Pix en el partner de la compañía, en Ventas y compras > Claves Pix, y vincúlela a la cuenta bancaria que debe recibir el pago.
- En la cuenta bancaria, establezca QR Code en EMV Merchant-Presented QR-code.
- En el diario de esa cuenta bancaria, active QR Code para que el enlace de pago y el informe de la factura lo ofrezcan.
El código QR se ofrece donde Odoo ya ofrece uno: en el informe de la factura de cliente y en la página de pago. Nada más cambia.
Debe existir una clave Pix en la cuenta bancaria; de lo contrario, Odoo recurre al siguiente método QR disponible e informa por qué.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.