巴西¶
参见
巴西本地化的有用资源，包括入门材料和视频：
模块¶
以下与巴西本地化相关的模块可用：
名称 |
技术名称 |
描述 |
|---|---|---|
巴西 - 会计 |
|
巴西 财务本地化包 ，包含巴西科目表、税项、税务报告、财务位置以及文档和身份类型。 |
巴西 - 会计报告 |
|
巴西的会计报告。 |
AvaTax 巴西 、 Avatax 巴西销售 和 巴西 Avatax 测试销售订单 |
|
通过 Avalara 计算商品和服务税。 |
巴西会计 EDI |
|
通过 Avatax 提供电子发票。 |
巴西会计 EDI 销售 |
|
向销售订单添加一些字段，这些字段会结转到发票上。 |
巴西会计 EDI 销售点 |
|
在销售点通过 Avatax 提供电子发票。 |
巴西会计 EDI 电子商务 |
|
允许电子商务用户进行税务计算和 EDI。 |
巴西会计 EDI 库存 |
|
向 NF-e 添加与交付相关的信息。 |
巴西 - 网站销售 |
|
允许电子商务用户进行税务计算和 EDI。 |
巴西 - 销售 |
|
巴西销售修改 |
巴西 - 销售订阅 |
|
巴西销售订阅修改 |
注解
本地化的核心模块会随本地化自动安装。其余的可以手动 安装 。
本地化概述¶
巴西本地化包确保符合巴西财政和会计法规。它包括管理税款、财政状况、报告以及符合巴西标准的预定义会计科目的工具。
巴西本地化包提供以下关键功能以确保符合当地财政和会计法规：
科目表¶
在 会计科目表 中，账户会自动映射到其相应的税款以及默认的应付账款和应收账款字段。
注解
巴西会计科目表基于 SPED 会计科目表，它提供了必要账户的基线。
税项¶
安装巴西本地化时， 税款 会自动创建和配置。Avalara 使用其中一些来计算销售订单或发票的税款。
用于服务的税款必须手动添加和配置，因为税率可能因提供服务所在城市而异。
重要
无法为手动创建的服务税开具 NFS-e。要 电子发送 NFS-e ，请使用 Avalara 计算税款。
警告
不要删除税款，因为它们用于 AvaTax 税款计算。如果删除，Odoo 在销售订单或发票中使用时会再次创建它们，并使用 AvaTax 计算税款。但是，用于登记税款的账户必须在税款的 定义 标签页下的 发票分配 和 退款分配 部分重新配置。
公司和联系人¶
要使用此财税本地化的所有功能，需要在 公司记录 中填写以下字段：
名称
地址 ：添加 城市 、 州/省 、 邮政编码 、 国家/地区
在 街道 字段中，输入街道名称、编号和其他地址信息。
在 街道 2 字段中，输入街区信息。
识别号码 ：CNPJ 或 CPF
税号 ：与识别类型相关联
IE ：州/省注册
IM ：市级登记
SUFRAMA 编码 ：马瑙斯自由贸易区监管 - 如适用可加入
电话
电子邮件
配置 销售及采购 选项卡中的 财务信息 ：
为 AvaTax 巴西添加 财政状况 。
财务制度 ：联邦税务制度
ICMS 纳税人类型 ：表示 ICMS 制度 、 豁免状态 或 非纳税人 。
主要活动部门
配置以下额外的 财政信息 以签发 NFS-e：
为 AvaTax 巴西添加 财政状况 。
COFINS 详情 ：应税、非应税、税率 0% 应税、免税、暂停
PIS 详情 ：应税、非应税、税率 0% 应税、免税、暂停
CSLL 应税 如果公司是否受 CSLL 约束
小技巧
如果是简化制度，必须配置 ICMS 税率。为此，请转到 ，向下滚动到 税款 部分，并在 默认税款 部分设置 销售税 和 采购税 字段。
使用 AvaTax 集成时，相同的配置适用于相关的 联系人 表单。
注解
如果联系人有税号（CNPJ），请选择 公司 选项；如果联系人有 CPF，请选择 个人 。
AvaTax 整合功能¶
注解
确保 安装 AvaTax 巴西 （
l10n_br_avatax）模块。Odoo 是 Avalara Brazil 公司的认证合作伙伴。
Avalara AvaTax 集成 使用 应用内购买 (IAPs) 来计算税款和处理电子文档（例如， NF-e 、 NFS-e ）。每个操作都会消耗 IAP 信用余额 中的信用点。创建时，新数据库会收到 500 个免费信用点。
要计算商品和服务税并处理电子发票，需要以下配置：
配置¶
授权认证¶
在 Odoo 中激活 AvaTax ，并在 AvaTax 巴西 部分，在 AvaTax 门户电子邮件 字段中添加 AvaTax 门户的管理员电子邮件地址，然后单击 创建账户 。
警告
在沙盒或生产数据库中 测试 或 创建生产 AvaTax 门户电子邮件 集成时，请使用真实的电子邮件地址，因为需要它来 连接到 Avalara 并设置证书，无论是在测试还是生产中使用。
有两个不同的巴西 Avalara 门户：
从 Odoo 创建账户时，请选择正确的环境。此外，用于开设账户的电子邮件不能用于开设另一个账户。从 Odoo 创建账户时，请保存 API ID 和 API 密钥 。
从 Odoo 创建账户后，转到 Avalara 门户设置密码：
访问 Avalara 门户网站 。
单击 Meu primeiro acesso 。
添加在 Odoo 中用于创建 Avalara/AvaTax 账户的电子邮件地址，然后单击 Solicitar Senha 。
然后会收到一封包含令牌和创建密码链接的电子邮件。单击此链接并复制粘贴令牌以分配所需密码。
小技巧
如果您在 Odoo 中 仅将 AvaTax 用于税款计算 ，则无需设置密码或访问 Avalara 门户。但是，要使用电子发票服务，需要访问 AvaTax，并且必须 上传证书 。
注解
API 凭据可以转移。此选项仅当已在另一个 Odoo 实例中创建账户并且必须重用时才应使用。
A1 证书上传¶
要签发电子发票，必须将证书上传到 AvaTax 门户 。
只要 AvaTax 门户中的外部标识符号码与 CNPJ 号码匹配（无特殊字符），并且 Odoo 中的标识号码 (CNPJ) 与 AvaTax 中的 CNPJ 匹配，证书将与 Odoo 同步。
重要
某些城市要求在从 Odoo 签发 NFS-e 之前，将证书链接到城市门户系统内。
如果收到来自城市的错误消息，显示 您的证书未链接到用户 ，则需要在城市门户中完成此过程。
财政状况¶
要设置 自动税务映射 (Avalara Brazil) 财务位置 ，请启用 自动检测 和 使用 AvaTax Brazil API 选项。
参见
产品¶
要在销售订单和发票上使用 AvaTax 集成，请根据产品的使用方式，在产品表单的 销售 选项卡下的 巴西会计 部分输入以下信息。
商品电子发票 (NF-e)¶
重要
Avalara 集成 基于信用系统工作，每次与 Avalara 的交互都会消耗一个信用。以下是主要的消耗信用操作：
销售应用
报价单和销售订单上的税务计算。
会计应用
发票上的税务计算。
电子发票提交（NF-e 或 NFS-e）。
偶尔操作 ：（每个步骤单独计费）
注解
如果在 销售 应用中计算了税款，并且后来在 会计 应用中开具了发票，则计算会发生两次，消耗两个信用。
Example
CEST 代码 ：税务分类代码，用于识别根据 ICMS 法规需进行税务替代的商品和产品，并有助于确定特定项目的适用税务处理和程序。产品对此要求的适用性可在 https://www.codigocest.com.br/ 验证。
Mercosul NCM 代码 ： 南方共同市场产品共同命名代码
来源地 ：产品的原产地，可以是国外或国内，以及其他可能的选项，具体取决于特定用例
SPED 财政产品类型 ：根据 SPED 列表表的财政产品类型
使用目的 ：此产品的预期使用目的
注解
Odoo 会自动创建三个产品，用于与销售相关的运输成本。这些产品名为 运费 、 保险费 和 其他费用 ，并且已经配置好。如果需要创建更多，请复制并使用相同的配置：
产品类型 服务
运输成本类型 ：保险 、 运费 或 其他费用
服务电子发票 (NFS-e)¶
重要
Avalara 集成 基于信用系统工作，每次与 Avalara 的交互都会消耗一个信用。以下是主要的消耗信用操作：
销售应用
报价单和销售订单上的税务计算。
会计应用
发票上的税务计算。
电子发票提交（NF-e 或 NFS-e）。
发票状态检查（每次检查发票状态都会消耗 1 个信用）。
偶尔操作 ：（每个步骤单独计费）
注解
如果在 销售 应用中计算了税款，并且后来在 会计 应用中开具了发票，则计算会发生两次，消耗两个信用。
Example
Mercosul NCM 代码 ： 南方共同市场产品共同命名代码
使用目的 ：此产品的预期使用目的
服务代码来源 ：提供商注册的城市服务代码
劳务分配 ：复选框，用于选择服务是否涉及劳务
运输成本类型 ：要选择的运输成本类型
服务代码 ：将提供服务的城市服务代码；如果未添加代码，则将使用 服务代码来源 。
税费计算¶
参见
报价单和销售订单的税款计算¶
通过以下任一方式触发 API 调用，使用 AvaTax 自动计算报价单或销售订单上的税款：
- 报价确认
将报价单确认为销售订单。
- 手动触发
单击 使用 AvaTax 计算税款 。
- 预览
单击 预览 。
- 通过电子邮件发送报价单/销售订单
通过电子邮件向客户发送报价单或销售订单。
- 在线报价
当客户在线访问报价单时（通过门户视图），就会触发 API 调用。
Mirto Bonan¶
通过以下任一方式触发 API 呼叫，使用 AvaTax 自动计算客户发票上的税款：
- 手动触发
单击 使用 AvaTax 计算税款 。
- 预览
单击 预览 。
- 在线发票访问
当客户在线（通过门户视图）访问发票时，就会触发 API 调用。
注解
必须将 财政状况 设为 自动税收映射（Avalara Brazil） ，这些操作才能自动计算税款。
会计¶
电子文档¶
配置¶
系列 号与电子发票的序列号范围相关联。要在销售日记账上配置系列号，请转到 并在 系列 字段中设置。如果需要多个系列，必须创建新的销售日记账，并为每个系列分配新的系列号。
启用 使用文档？ 选项，因为只有在日记账上选择了 使用文档？ 选项时， 系列 字段才会显示。
在开具电子和非电子发票时， 类型 字段选择创建发票时使用的文档类型。
注解
创建日记账时，请确保 会计信息 部分中的 专用贷项通知单序列 字段未勾选，因为在巴西，发票、贷项通知单和借项通知单之间的序列是按系列号共享的，也就是按日记账共享。
客户发票¶
要处理商品（NF-e）或服务（NFS-e）的电子发票，必须确认发票并由 Avalara 计算税款。必须填写以下字段：
客户 ，包含所有客户信息
付款方式：巴西 ：指定预期的付款方式。
文档类型 ：选择 (55) 电子发票 (NF-e) 或 (SE) 电子服务发票 (NFS-e) 。
其他信息 标签页：
税务位置 设置为 自动税务映射 (Avalara Brazil) 。
一些可选字段取决于交易的性质。 其他信息 标签页中的这些字段不是必需的，因此在大多数情况下，留空不会在提交发票时导致政府错误：
运费模式 决定货物计划如何运输 - 国内。
巴西运输商 决定谁负责运输。
然后，单击 发送 。在 打印和发送 窗口中，单击 处理电子发票 和任何其他选项，例如 下载 或 电子邮件 。最后，单击 发送 以向政府处理发票。
注解
用于开具电子发票的发票上所有可用的字段在销售订单上也可用（如果需要）。创建第一张发票时， 文档编号 字段会显示并分配为后续发票顺序使用的第一个编号。
贷记单¶
如果需要登记销售退货，可以在 Odoo 中 创建贷项通知单 并发送给政府进行验证。
注解
贷记单仅适用于货物电子发票 (NF-e)。
借记单¶
如果需要包含其他信息或更正原始发票中未准确提供的值，可以 开具借项通知单 。
注解
借项通知单仅适用于商品的电子发票（NF-e）。
只有原始发票中包含的产品才能包含在借项通知单中。虽然可以更改产品的单价或数量，但 不能 将产品添加到借项通知单中。此文档的目的仅是为相同或更少的产品声明要添加到原始发票的金额。
开票取消¶
可以取消政府已验证的电子发票。
注解
检查电子发票是否仍在取消期限内，该期限可能因各州立法而异。
商品电子发票 (NF-e)¶
要在 Odoo 中取消商品电子发票（NF-e），请单击 请求取消 并在出现的弹出窗口中添加取消 原因 。要通过电子邮件将此取消原因发送给客户，请启用 电子邮件 复选框。
注解
这是一个电子取消，意味着 Odoo 将向政府发送取消 NF-e 的请求。然后它将消耗一个 IAP 积分，因为会发生 API 调用。
服务电子发票 (NFS-e)¶
要在 Odoo 中取消服务电子发票（NFS-e），请单击 请求取消 。在这种情况下没有电子取消流程，因为并非每个城市都提供此服务。用户需要在城市门户上手动取消此 NFS-e。完成该步骤后，他们可以在 Odoo 中请求取消，这将取消发票。
更正信¶
可以创建更正信并将其链接到政府已验证的商品电子发票（NF-e）。
要在 Odoo 中执行此操作，请单击 更正信 并向弹出窗口添加更正 原因 。要通过电子邮件将更正原因发送给客户，请启用 电子邮件 复选框。
注解
更正信仅适用于电子货物发票 (NF-e)。
发票编号范围作废¶
如果分配给销售日记账的一系列序列当前未使用 且 将来也不会使用，政府可以使其作废。要执行此操作，请转到 ，打开日记账，单击 （齿轮）图标，然后选择 作废编号范围 (BR) 。在 作废编号范围 (BR) 向导中，添加应取消范围的 起始编号 和 结束编号 ，并输入作废 原因 。
注解
发票编号范围作废仅适用于商品电子发票（NF-e）。
日记账的讨论记录记录了已取消编号的日志以及 XML 文件。
供应商账单¶
收到供应商发票时，通过在 Odoo 中添加所有商业信息和与 客户发票 上记录的相同的巴西特定信息来编码账单。
这些巴西特定字段是：
付款方式：巴西 ：指定预期的付款方式。
文档类型 ：供应商使用
文档编号 ：供应商的发票编号
货运模式 ：特定于 NF-e 计划如何运输货物 - 国内
巴西运输服务商 （ 特定于 NF-e ）：负责运输的服务商。
销售点 NFC-e¶
NFC-e 是一种法律文件，支持向最终客户销售商品或货物。与 NF-e 类似，电子客户发票也以 XML 文件格式签发，并有一个辅助文件 (DANFC-e)，称为 NFC-e 摘要 。此电子文件可以通过 Odoo 销售点 签发。
其法律有效性由数字签名和每个巴西州的 SEFAZ（财政秘书处）保证。
注解
每个步骤单独计费。例如，为同一 POS 交易计算税款和签发发票会消耗两个信用。
参见
配置¶
CSC 详细信息¶
转到 并滚动到 税项 部分。在 NFC-e 配置 部分，填写以下 CSC（纳税人安全代码）字段：
CSC ID ： CSC ID 或 CSC Token 是纳税人安全代码的标识，可以有 1 到 6 位数字，可在您所在州的财政局 (SEFAZ) 官方网站上获取。
CSC 号码 ： CSC 号码 是一个最多 36 个字符的代码，只有您和财政局知道。它用于生成 NFC-e 的二维码并确保 DANFE 的真实性。
注解
这些字段所需的信息可以由公司会计师通过每个巴西州的 SEFAZ 网站生成。
产品配置¶
访问相关的 POS 中的产品表单 ，然后配置 产品 的 巴西会计 字段。
销售点¶
转到 并确保相关的销售点已在 屏幕顶部选择 。然后，滚动到 会计 部分并配置 巴西 EDI 字段：
系列
下一个号码 ：要签发的序列中的下一个 NFC-e 号码，例如，如果在 SEFAZ 中最后签发的号码是
100，则 下一个号码 将是101。
工作流¶
生成 NFC-e¶
要生成 NFC-e，请按照以下步骤操作：
验证付款以计算税款并签发 NFC-e。有效的 NFC-e 会出现在屏幕右侧。
注解
也可以签发通过 CPF/CNPJ 识别客户的 NFC-e。为此，请单击 客户 ，搜索客户或创建新客户。
以下是签发 CPF/CNPJ 识别的 NFC-e 的必填字段：
名称
签发发票的 城市 和 州
CPF/CNPJ
单击 验证 。NFC-e 会出现，并在打印件上高亮显示客户的 CPF。
单击 打印 或 通过电子邮件发送 将发票交付给客户。
NFC-e 票据打印¶
生成并验证 NFC-e 后，单击 打印 以交付发票。
注解
Odoo NFC-e 功能兼容任何热敏打印机，并且不需要 Odoo IoT Box 。
重新签发带有 NFC-e 错误的 PoS 订单¶
如果 NFC-e 返回错误，请按照以下步骤操作：
纠正错误。
通过单击 (菜单) 图标并选择 订单 来重新签发 NFC-e。
过滤列表以仅显示 已付款 订单，然后单击 详细信息 。错误会显示出来。
单击 发送 NFC-e 。
注解
如果错误已纠正且 PoS 会话已关闭，Odoo 会在相关日记账分录的讨论区中记录税款调整。该订单的日记账分录表明税款计算不正确。在这种情况下，需要重新处理 NFC-e。
NFC-e 退款和取消¶
退款可以直接在 Odoo 中处理 ，但 取消 必须通过官方政府门户网站执行。
当流程完成时，会创建已批准的退货 NF-e，这意味着 先前的 NFC-e 被取消 。
重要
SEFAZ 仅允许在 NFC-e 在 SEFAZ 网站上签发后 30 分钟内 取消。在此期限之后，必须处理手动退款，并签发 货物退货 NF-e 。