Boletos e CNAB de cobrança
El módulo implementa el CNAB, la generación del Boleto, del Archivo de Remesa e importa el Archivo de Retorno usando la Biblioteca BRCobranca a través del Micro-Servicio Boleto_CNAB_API.
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.0Genera boletos bancarios brasileños y archivos de remesa CNAB para facturas de cliente a través de un servicio externo BRCobrança, e importa archivos de retorno bancario para conciliar los pagos de los clientes automáticamente.
Este módulo conecta Odoo con un servicio externo de BRCobrança para gestionar documentos de cobro bancario brasileños. Funciona con facturas de cliente y órdenes de pago.
- En una factura confirmada, un botón genera el PDF del boleto, que se almacena como adjunto en la factura. El PDF se solicita al servicio externo utilizando el modo de pago, la cuenta bancaria, la cartera, nuestro número, la fecha de vencimiento y los datos del pagador de la factura.
- Las órdenes de pago producen el archivo de remesa (CNAB 240 o 400) enviado al banco. El archivo también lo construye el servicio externo, con detalles específicos de cada banco para Banco do Brasil, Santander, Caixa, Ailos, Unicred, Sicredi, Bradesco y otros. Si el banco o el tipo de CNAB no es compatible, se muestra un mensaje de error.
- Un nuevo menú "Import Batch File" bajo el menú CNAB permite a los usuarios subir un archivo de retorno bancario. La importación crea un registro de retorno CNAB con sus eventos y totales (recibido, comisiones, intereses, descuento, bonificación), adjunta el archivo original y crea los asientos contables relacionados.
- En el diario bancario, los usuarios eligen el tipo de importación (CNAB 400 o CNAB 240) y pueden activar "Automatic Reconcile payment returns". Cuando está activado, los asientos de retorno importados se contabilizan y se concilian con la línea de cobro pendiente correspondiente, que queda marcada como liquidada.
- Un campo "CNAB Returned Reference" en los apuntes contables vincula una línea de retorno con el cobro original.
- La opción BRCobrança se añade como procesador de CNAB en la configuración de CNAB, y la dirección del servicio debe configurarse en los ajustes de Odoo o en los parámetros del sistema.
Menús que añade
Modelos y campos (6)
- account.move · amplía un modelo existente
- account.journal · amplía un modelo existenteimport_type, return_auto_reconcile (Automatic Reconcile payment returns)
- account.move.line · amplía un modelo existentecnab_returned_ref (CNAB Returned Reference)
- account.payment.line · amplía un modelo existente
- account.payment.order · amplía un modelo existente
- credit.statement.import · 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. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 4 confirmadas, 5 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.0Instalación
Fuente · Odoo 18.0El módulo depende de:
- l10n_br_account_payment_order
- account_move_base_import
Configuración
Fuente · Odoo 18.0Para configurar este módulo es necesario:
Ejecutar la biblioteca BRCobranca como un microservicio Boleto_CNAB_API.
Informar la variable de entorno BRCOBRANCA_API_URL, existen tres opciones:
- En el archivo de configuración del Docker Compose File en la sección enviroment, por ejemplo https://github.com/akretion/docky-odoo-brasil/blob/12.0/docker-compose.yml#L3 , incluir: BRCOBRANCA_API_URL=http://boleto_cnab_api:9292
- En el archivo de Configuración de Odoo, incluir: brcobranca_api_url=http://boleto_cnab_api:9292
- En Odoo cree un Parámetro de Sistema como: brcobranca_api_url=http://boleto_cnab_api:9292
Verifique si los Códigos del CNAB del Banco que se usará existen en:
Facturación > Configuraciones > Administración > Códigos CNAB
En caso de que sea necesario crearlos, por favor considere hacer un PR en este módulo añadiendo los Códigos en l10n_br_account_payment_order/data/cnab_codes/banco_X_cnab_Y_Z.xml de esta forma en las próximas implementaciones ya no será necesario registrarlos, esto ayuda en la construcción de una base de conocimiento, ahorrando tanto horas de implementación por no ser necesario revisar o rehacer lo que se hizo como poder usar lo que otros hicieron, esto también es importante porque permite probar y evaluar las diferencias entre cada caso haciendo la implementación más robusta, puede ver los casos que ya existen hoy en el módulo l10n_br_account_payment_order.
Cree una Configuración CNAB, es donde se almacenará la información específica de cada caso como la Cartera, Convenio, Código del Beneficiario, Códigos de Instrucción y Retorno del Movimiento, etc., en:
Facturación > Configuración > Administración > Configuraciones CNAB
Verifique si la Cuenta Bancaria referente al CNAB ya fue registrada en:
Configuraciones > Usuarios y Empresas > Empresas
Haga clic en el Contacto asociado, y en la pestaña Facturación vea si la Cuenta Bancaria referente al CNAB ya existe y si la información es correcta, si no existe vea crearla informando los datos Número de Cuenta, Agencia, etc.
Al registrar la Cuenta Bancaria debe crearse automáticamente un Diario Contable, o si ya había sido registrada el Diario ya debe existir, verifique en:
Facturación > Configuraciones > Financiero > Diarios
Confirme si la información es correcta, el campo Tipo debe estar como Banco, en la pestaña Asientos del Diario en Número de Cuenta Bancaria debe estar rellenado con la Cuenta Bancaria del CNAB y en la pestaña Configuración de Pagos los Métodos que se usarán, 240 o 400, deben estar marcados.
En la pestaña Información Referente a la Importación informe las configuraciones de Retorno del CNAB en los campos Tipo de Importación, Cuenta de Recepción/Pago, Creación de Contrapartida y si debe hacerse la conciliación automática al importar el archivo en Conciliar Automáticamente el Retorno de Pago.
Cree un Modo de Pago o use uno existente en:
Facturación > Configuración > Administración > Modos de Pago
Informe el Diario Contable referente al Banco y la Configuración CNAB que deberá utilizarse, en el campo Diario de Banco Fijo informar el Diario Contable de la Cuenta Bancaria y si fuera el caso, y es recomendado, marcar la opción Añadir automáticamente al validar la factura para no tener que hacerlo manualmente.
En caso de que el CNAB y Banco elegidos posean un campo específico que sea necesario implementar considere hacer un PR en el módulo l10n_br_account_payment_order aquí https://github.com/OCA/l10n-brazil/blob/16.0/l10n_br_account_payment_order/models/l10n_br_cnab_boleto_fields.py#L307 .
Configure los permisos de acceso de los usuarios, las opciones son CNAB Usuario y Gerente.
Al crear y Confirmar una Factura que tiene un Modo de Pago que tiene una Configuración CNAB definida deberá aparecer el botón de Imprimir Boleto, si está marcada en el Modo de Pago la opción de Añadir automáticamente al validar la factura se creará o añadirá en una Orden de Pago las líneas de pagos del CNAB, si la opción no está marcada será necesario hacerlo manualmente pudiendo hacerse tanto en la Factura como en la Orden de Pago.
Al Confirmar esa Orden de Pago será posible generar el Archivo de Remesa CNAB a enviar al Banco, es importante confirmar el envío del archivo cambiando el estado de la orden a Archivo Enviado, esa información se usa para validar si existe una instrucción CNAB pendiente antes de poder crear otra.
Alteraciones de CNAB como Cambio de la Fecha de Vencimiento, Protesto, Conceder Descuento y etc pueden hacerse en la propia Factura en:
Facturación > Clientes > Facturas
En la pestaña Recepciones en la última columna existe el botón Actualizar Información CNAB al hacer clic en una línea esa opción también aparece, al hacer una alteración se crea o añade en una Orden de Pago la Instrucción de Movimiento CNAB seleccionada.
La importación del Archivo CNAB de Retorno puede hacerse en:
Facturación > Financiero > CNAB > Importar Archivo de Lote
o en el propio Diario en:
Facturación > Configuraciones > Financiero > Diarios
En la pestaña Informaciones Referentes a la Importación en el botón Archivo de lote de importación.
Toda importación de archivo de retorno crea un LOG que puede consultarse en:
Facturación > Financiero > CNAB > Registro de Retorno de CNAB
Si el Código de Retorno CNAB recibido es uno de los Códigos de Liquidación del Retorno del Movimiento, definidos en la Configuración CNAB usada en el Modo de Pago, se creará un Asiento de Diario con los valores, cuando existan de Descuento, Intereses/Mora, Tarifa Bancaria, Descuento y el Valor Recibido a reconciliar con la línea de la Factura referente, los asientos se separan de acuerdo con las Cuentas Contables definidas en la Configuración CNAB, la línea para reconciliar la Factura necesitan ser iguales por eso el valor es:
valor_recibido_calculado = valor_recibido + valor_descuento + valor_abatimiento - valor_intereses_mora
Cuando está marcada la opción de Reconciliación Automática el Asiento de Diario se moverá al estado Publicado automáticamente al importar el archivo, si esa opción no está marcada esto deberá hacerse manualmente.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.
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.