使用BRCobranca库接收Boletos和CNAB
项目描述
葡萄牙语： 此模块通过BRCobranca库实现CNAB https://github.com/kivanio/brcobranca。
英语： 此模块通过BRCobranca (https://github.com/kivanio/brcobranca)实现巴西银行汇票。
目录
安装
葡萄牙语： 模块依赖于
l10n_br_account_payment_order
account_move_base_import
英语： 此模块依赖于
l10n_br_account_payment_order
account_move_base_import
配置
葡萄牙语： 要配置此模块，需要
以微服务方式运行BRCobranca库 https://github.com/akretion/boleto_cnab_api。
在Odoo的配置文件中指定环境变量 BRCOBRANCA_API_URL，或者如果正在使用docky，在环境部分 https://github.com/akretion/docky-odoo-brasil/blob/12.0/docker-compose.yml#L3 中，例如：BRCOBRANCA_API_URL=http://boleto_cnab_api:9292
请检查要使用的CNAB运动代码是否在“发票”>“配置”>“管理”>“CNAB运动指令代码”中存在，如果需要创建，请考虑创建一个PR以在此处添加数据 https://github.com/OCA/l10n-brazil/blob/12.0/l10n_br_account_payment_order/data/l10n_br_cnab_mov_instruction_code_data.xml。
请检查将要使用的CNAB返回代码是否存在于“开票”>“配置”>“管理”>“CNAB返回代码”，如果需要创建，请考虑在此处添加数据以创建PR https://github.com/OCA/l10n-brazil/blob/12.0/l10n_br_account_payment_order/data/l10n_br_cnab_return_move_code_data.xml。
在“开票”>“配置”>“会计”>“银行账户”中创建与CNAB相关的银行账户。
系统将自动在“开票”>“配置”>“会计”>“日记账”中为银行账户创建一个日记账。在“导入相关信息”标签页中，在“导入类型”、“收款/付款账户”、“创建对方账户”字段中填写CNAB返回参数，并在“导入文件时自动核对付款返回”中设置是否自动核对。
在“开票”>“配置”>“管理”>“支付方式”中创建一个带有CNAB信息的支付方式，在“固定银行日记账”字段中填写银行账户的日记账，并根据需要勾选“在验证发票时自动添加”，以便无需手动操作。
如果所选CNAB和银行有一个需要实现的特定字段，请考虑在此处模块l10n_br_account_payment_order中创建一个PR https://github.com/OCA/l10n-brazil/blob/12.0/l10n_br_account_payment_order/models/l10n_br_cnab_boleto_fields.py#L307。
配置用户访问权限，CNAB选项有“用户”和“经理”。
英文 配置此模块需要
运行BRCobranca作为微服务 https://github.com/akretion/boleto_cnab_api。
在Odoo配置文件中或在使用doky的情况下，在环境变量部分设置BRCOBRANCA_API_URL，例如：BRCOBRANCA_API_URL=http://boleto_cnab_api:9292
检查将要使用的CNAB指令代码是否存在于“开票”>“配置”>“管理”>“CNAB指令代码”，如果需要创建，请考虑在此处添加数据以创建PR https://github.com/OCA/l10n-brazil/blob/12.0/l10n_br_account_payment_order/data/l10n_br_cnab_mov_instruction_code_data.xml。
检查将要使用的CNAB返回代码是否存在于“开票”>“配置”>“管理”>“CNAB返回代码”，如果需要创建，请考虑在此处添加数据以创建PR https://github.com/OCA/l10n-brazil/blob/12.0/l10n_br_account_payment_order/data/l10n_br_cnab_return_move_code_data.xml。
在“开票”>“配置”>“会计”>“银行账户”中创建与CNAB相关的银行账户。
系统将自动在“开票”>“配置”>“会计”>“日记账”中为银行账户创建一个日记账。在“导入相关信息”标签页中，在“导入类型”、“收款/付款账户”、“创建对方账户”字段中填写CNAB返回参数，并在“导入文件时自动核对付款返回”中设置是否自动核对。
在“开票”>“配置”>“管理”>“支付方式”中创建一个带有CNAB信息的支付方式，在“固定银行日记账”字段中填写银行账户的日记账，并根据需要勾选“在验证发票时自动添加”，以便无需手动操作。
配置用户访问权限，CNAB选项有“用户”和“经理”。
使用
葡萄牙语
创建并确认一个具有CNAB支付方式的发票时，应出现“打印支票”按钮。
如果支付方式中勾选了“在验证发票时自动添加”选项，则会在支付订单中创建或添加CNAB支付行，如果未勾选，则需要手动操作，这可以在发票或支付订单中完成。
确认支付订单后，可以生成要发送给银行的CNAB汇款文件，重要的是要确认上传文件，通过将订单状态更改为“文件已上传”来完成，此信息用于验证在创建另一个之前是否存在待处理的CNAB指令。
如更改到期日期、抗议、授予折扣等CNAB变更，可以在“开票”>“客户”>“发票”的“收款”选项卡中直接在发票上操作，在最后一列存在“更新CNAB信息”按钮，点击行时此选项也会出现，进行更改时会在支付订单中创建或添加选定的CNAB移动指令。
在“支付”>“批量文件导入”或“开票”>“配置”>“会计”>“日记账”的“导入相关信息”选项卡中，可以通过“批量文件导入”按钮导入CNAB退回文件。
每次导入退回文件都会创建一个日志，可以在“支付”>“CNAB退回日志”中查阅。
如果收到的CNAB退回代码是支付方式中的“退回移动结算代码”之一，则会创建日记账入账，包括折扣、利息/滞纳金、银行手续费、折扣和与发票行核对的价值，根据支付方式中定义的会计账户进行分录，为了核对发票行的价值，因此公式为：值_收到_计算 = (值_收到 + 值_折扣 + 值_折扣) - 值_利息_滞纳金
如果勾选了“自动核对”选项，则日记账入账将在导入文件时自动转为“已发布”状态，如果没有勾选，则必须手动完成。
English
在创建和确认具有CNAB支付方式的发票时，应显示“打印汇票”按钮。
如果支付方式中勾选了“在验证发票时自动添加”选项，则CNAB支付行将在支付订单中创建或添加，如果未勾选，则需要手动操作，这可以在发票和支付订单中完成。
通过确认支付订单，可以生成要发送给银行的CNAB汇款文件，重要的是要确认上传文件，通过将订单状态更改为“文件已上传”来完成，此信息用于验证在创建另一个之前是否存在待处理的CNAB指令。
如更改到期日期、抗议、授予折扣等CNAB变更，可以在“开票”>“客户”>“发票”的“收款”选项卡中直接在发票上操作，在最后一列存在“更新CNAB信息”按钮，点击行时此选项也会出现，进行更改时会在支付订单中创建或添加选定的CNAB移动指令。
在“支付”>“批量文件导入”或“开票”>“配置”>“会计”>“日记账”的“导入相关信息”选项卡中，可以通过“批量文件导入”按钮导入CNAB退回文件。
每次导入退回文件都会创建一个日志，可以在“支付”>“CNAB退回日志”中查阅。
如果接收到的CNAB返回码是支付方式中的“CNAB流动性返回移动代码”之一，则将创建一个日记账条目，其中包含折扣、利息、关税费用、退款和与参考发票行对账的金额。根据支付方式中定义的科目进行分离，对账行的金额需要相等，所以值为：calculated_value_receive = (receive_amount + discount_amount + rebate_amount) - interest_amount
当勾选“自动对账”选项时，在导入文件时，日记账条目将自动移动到已过账状态，如果没有勾选，则应手动完成。
已知问题/路线图
在v12版本中，似乎无法仅通过QWeb调用方法来打印账单菜单中的收据，请在迁移到其他版本时进行检查。
变更日志
14.0.1.0.0 (2022-05-26)
[MIG] 迁移
12.0.1.0.0 (2021-05-07)
[MIG] 完成迁移
[IMP] 与用于导入CNAB文件的模块account_move_base_import集成
[IMP] 实现自动对账，并在配置的账户中登记手续费、关税银行、退款等值。
12.0.1.0.0 (2020-06-12)
[MIG] 开始迁移
10.0.1.0.0 (2019-05-30)
[MIG] 迁移
8.0.1.0.0 (2018-01-29)
[REF] 使打印Boleto、创建CNAB文件和将CNAB作为银行对账单导入的功能正常，用户应手动解决值之间的差异（手续费、关税银行、退款等）。
8.0.1.0.0 (2017-07-01)
[NEW] 第一个版本
错误跟踪器
错误在GitHub问题上追踪。如果遇到问题，请检查是否已经报告了您的问题。如果您是第一个发现它的人，请通过提供详细和受欢迎的反馈来帮助我们将其解决。
请勿直接联系贡献者以寻求支持或帮助解决技术问题。
致谢
贡献者
Akretion: * Raphaël Valyi <raphael.valyi@akretion.com.br> * Magno Costa <magno.costa@akretion.com.br>
Engenere: * Antônio S. Pereira Neto <neto@engenere.one>
其他致谢
本模块的开发得到了以下机构的财务支持
AKRETION LTDA - https://akretion.com/pt-BR
维护者
本模块由OCA维护。
OCA，即Odoo社区协会，是一个非营利组织，其使命是支持Odoo功能的协作开发并推广其广泛应用。
当前 维护者
本模块是GitHub上OCA/l10n-brazil项目的一部分。
欢迎您贡献力量。了解如何贡献请访问https://odoo-community.org/page/Contribute。
哈希值 for odoo14_addon_l10n_br_account_payment_brcobranca-14.0.7.0.3-py3-none-any.whl
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | a0b79a02c8c450a32c37368bc4115d9e111076e053386f9828c5ec85499094a2 |
|
| MD5 | 0d2e571ddde4c4bd5ef364dfc4752787 |
|
| BLAKE2b-256 | ceac4a4e9b72074464e954804f353833dde28e4c26a9677f450ec613a44770e4 |
