巴西

更多内容

有关巴西本地化资源的有用资源，包括入门材料和视频：

• 新用户入职清单。

• YouTube 播放列表 - 巴西（本地化）。

• YouTube 播放列表 - Tutoriais Odoo em Português。

• 有关巴西本地化的文档 有关电子发票的合规性和合规性

模块

以下模块是巴西本地化的一部分：

名称	技术名称	说明
巴西 - 会计	l10n_br	巴西 财税本地化软件包，包含巴西会计科目表、税项、税务报表、税务位置以及单据和身份类型。
巴西 - 会计报告	l10n_br_reports	巴西的会计报告。
AvaTax Brazil and Avatax Brazil Sale	l10n_br_avatax and l10n_br_avatax_sale	通过 Avalara 计算商品和服务税。
巴西会计 EDI	l10n_br_edi	通过 Avalara 为销售提供电子发票。
巴西会计 EDI-销售	l10n_br_edi_sale	为销售订单添加一些字段，这些字段将复制到发票。
巴西会计 EDI-POS	l10n_br_edi_pos	通过 Avalara 为 POS 提供电子发票。
巴西会计 EDI-eCommerce	l10n_br_edi_website_sale	为 eCommerce 用户提供税计算和 EDI。
巴西会计 EDI-库存	l10n_br_edi_stock	为 NF-e 添加与配送相关的信息。
巴西 - 网站销售	l10n_br_website_sale	为 eCommerce 用户提供税计算和 EDI。
巴西 - 销售	l10n_br_sales	巴西销售修改
巴西 - 销售订阅	l10n_br_sale_subscription	巴西销售订阅修改
Brazil - NFS-e Bill OCR	l10n_br_edi_extract	Extracts NFE-s vendor bills using OCR to fill them automatically

注解

本 localization 的核心模块将自动安装。其他模块可以手动 安装。

本地化摘要

巴西本地化软件包确保遵守巴西的 Fiscal 和会计法规。它包括用于管理税、 Fiscal 位置、报表和针对巴西标准的预定义会计科目的工具。

巴西本地化软件包提供了以下关键功能，以确保遵守本地 Fiscal 和会计法规：

• 会计科目: 一个针对巴西会计标准的预定义结构

• 税项：预配置的税率，包括标准增值税、零税率和免税选项。

• 薪资

• 报告

会计科目表

在 会计科目表 中，科目会自动映射到对应的税项，并设置默认的应付科目和应收科目字段。

注解

巴西的会计科目表基于 SPED 科目表（CoA），提供了所需科目的基准。

税率

安装巴西财税本地化时，税项 会自动创建并配置。Avalara 使用其中部分税项计算销售订单或发票的税额。

服务类税项必须手动添加并配置，因为税率可能因服务提供的城市而异。

重要

手动创建的服务税项无法开具 NFS-e。要 以电子方式发送 NFS-e，请使用 Avalara 计算税额。

警告

请勿删除税项，因为它们用于 AvaTax 税额计算。如果删除，当在 SO 或发票中再次使用时，Odoo 会通过 AvaTax 计算税额并重新创建它们。但是，必须在税项的 定义 页签下，于 发票分配 和 退款分配 部分重新配置用于登记该税项的科目。

公司与联系人

要使用此财税本地化的全部功能，公司记录 上必须填写以下字段：

• 名称

• 地址: 添加 城市 、 州/省 、 邮政编码 、 国家/地区

  • 在 街道 字段中，输入街道名称、编号和其他地址信息。

  • 在 街道 2 字段中，输入街区信息。

• 识别号码: CNPJ 或 CPF

• 税号: 与识别类型相关联

• IE: 州/省注册

• IM: 市级登记

• SUFRAMA 编码: 马瑙斯自由贸易区监管 - 如适用可加入

• 电话

• 电子邮件

配置 销售及采购 选项卡中的 财务信息:

• 添加用于 AvaTax Brazil 的 税务位置。

• 财务制度: 联邦税务制度

• ICMS 纳税人类型: 表示 ICMS 制度 、 豁免状态 或 非纳税人 。

• 主要活动部门

要开具 NFS-e，请配置以下额外的 财税信息：

• 添加用于 AvaTax Brazil 的 税务位置。

• COFINS 明细：应税、非应税、税率 0% 应税、免税、暂挂

• PIS 明细 应税、非应税、税率 0% 应税、免税、暂挂

• CSLL 应税：表示公司是否需要缴纳 CSLL

小技巧

如果属于简化税制，则必须配置 ICMS 税率。为此，前往 会计 ‣ 配置 ‣ 设置，向下滚动到 税项 部分，并在 默认税项 部分中设置 销售税 和 采购税 字段。

使用 AvaTax 集成时，同样的配置也适用于相应的 联系人 表单。

注解

如果联系人有税号（CNPJ），请选择 公司 选项；如果联系人有 CPF，请选择 个人 。

AvaTax 整合功能

注解

• 请务必 安装 AvaTax Brazil （l10n_br_avatax）模块。

• Odoo 是 Avalara Brazil 公司的认证合作伙伴。

• Avalara Brazil usage is free of charge with Odoo.

要计算商品和服务税并处理电子发票，需要进行以下配置：

• 公司

• 联系人

• AvaTax 配置。

• A1 数字证书

• 税项映射

• 产品

配置

授权认证

在 Odoo 中启用 AvaTax，然后在 AvaTax Brazil 部分，将 AvaTax 门户的管理员电子邮件地址添加到 AvaTax 门户电子邮件 字段中，再点击 创建账户。

警告

在测试或生产数据库中 测试 或 创建生产 AvaTax 门户电子邮件 集成时，请使用真实的电子邮件地址，因为无论是要测试还是在生产中使用，都需要用它连接 Avalara 并设置证书。

巴西有两个不同的 Avalara 门户：

• 一个用于测试：https://portal.sandbox.avalarabrasil.com.br/

• 一个用于生产：https://portal.avalarabrasil.com.br/

从 Odoo 创建账户后，请选择正确的环境。此外，用于开设账户的电子邮件地址不能用于开设另一个账户。从 Odoo 创建账户时，请保存 API ID 和 API Key。

从 Odoo 创建账户后，前往 Avalara 门户设置密码：

1. 访问 Avalara 门户网站 。

2. 点击 Meu primeiro acesso。

3. 添加在 Odoo 中用于创建 Avalara/AvaTax 账户的电子邮件地址，并点击 Solicitar Senha。

4. 随后将收到一封电子邮件，其中包含令牌和用于创建密码的链接。点击此链接并复制粘贴令牌以分配所需的密码。

小技巧

如果您在 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）

• CEST 编码：税务分类代码，用于识别受 ICMS 法规下税务替代约束的货物和产品，并帮助确定特定商品适用的税务处理和流程。可在 https://www.codigocest.com.br/ 查询产品是否符合此要求。

• Mercosul NCM 代码: 南方共同市场产品共同命名代码

• 来源产地：产品的产地，视具体使用场景可为外国或国产等其他选项

• SPED 财政产品类型：按照 SPED 列表表格划分的财政产品类型

• 使用用途：该产品的预期使用用途

注解

Odoo 会自动创建三个产品，用于与销售相关的运输费用。它们分别命名为 运费、保险费 和 其他费用，且已完成配置。如需创建更多，请复制并使用相同的配置：

• 产品类型 服务

• 运输费用类型：保险费、运费 或 其他费用

服务电子发票 (NFS-e)

• Mercosul NCM 代码: 南方共同市场产品共同命名代码

• 使用用途：该产品的预期使用用途

• 服务代码来源: 提供商注册的城市服务代码

• 劳务分摊：勾选此复选框以表示服务包含劳务

• 运输成本类型：选择运输成本的类型

• 服务代码：将提供服务所在城市的市政服务代码；如果未添加代码，则使用 服务代码来源。

税费计算

更多内容

税额计算

报价单和销售订单的税款计算

通过以下任一方式触发 API 调用，使用 AvaTax 自动计算报价单或销售订单上的税款：

• 报价确认

  将报价单确认为销售订单。

• 手动触发

  点击 使用 AvaTax 计算税额。

• 预览

  点击 预览。

• 通过电子邮件发送报价单/销售订单

  通过电子邮件向客户发送报价单或销售订单。

• 在线报价

  当客户在线访问报价单时（通过门户视图），就会触发 API 调用。

发票上的税额计算

通过以下任一方式触发 API 呼叫，使用 AvaTax 自动计算客户发票上的税款：

• 手动触发

  点击 使用 AvaTax 计算税额。

• 预览

  点击 预览。

• 在线发票访问

  当客户在线（通过门户视图）访问发票时，就会触发 API 调用。

注解

必须将 税务规则 设为 自动税收映射（Avalara Brazil） ，这些操作才能自动计算税款。

更多内容

税务规则（税项科目映射）

会计

电子文档

配置

系列 号码与电子发票的序号范围相关联。要在销售日记账上配置系列号码，请前往 会计 ‣ 配置 ‣ 日记账 并在 系列 字段中设置。如果需要多个系列，则必须创建新的销售日记账，并为每个系列分配新的系列号码。

请启用 使用单据？ 选项，因为只有当该选项在日记账上被选中时，系列 字段才会显示。

开具电子和非电子发票时，通过 类型 字段选择创建发票时使用的单据类型。

注解

创建日记账时，请确保 会计信息 部分中的 专用贷记凭证序号 字段未被勾选，因为在巴西，发票、贷记凭证和借记凭证的序号是按系列号码共享的，也就是按日记账共享。

客户往来账

要处理商品（NF-e）或服务（NFS-e）的电子发票，发票必须已确认且税额已由 Avalara 计算。必须填写以下字段：

• 客户，包含全部客户信息

• 付款方式：巴西：指明预期的付款方式。

• Document Type: Select (55) Electronic Invoice (NF-e) or (SE) Electronic Service Invoice (NFS-e).

其他信息 页签：

• Fiscal Position set as Automatic Tax Mapping (Avalara Brazil).

某些可选字段取决于交易的性质。其他信息 页签中的这些字段并非必填，因此在大多数情况下，将它们留空不会在提交发票时导致政府端报错：

• 运输方式 决定计划的货物运输方式 - 国内运输。

• 承运人（巴西） 决定由谁执行运输。

然后，点击发送。在弹出窗口中，点击处理电子发票以及其他选项，例如下载或电子邮件。最后，点击发送以向政府机构处理发票。

注解

用于开具电子发票的发票上的所有字段，在需要时也可用于销售订单。创建第一张发票时，会显示 单据编号 字段，并将其分配为后续发票按顺序使用的第一个号码。

红冲发票

如果需要登记销售退货，可以在 Odoo 中 创建贷记凭证 并发送给政府验证。

注解

红冲发票仅适用于货物电子发票 (NF-e)。

借记单

如果需要补充信息，或更正原发票中未准确提供的数值，可以开具 借记凭证。

注解

• 借记凭证仅适用于商品（NF-e）电子发票。

• 借记凭证只能包含原发票中已包含的产品。虽然可以更改产品的单价或数量，但 不能 向借记凭证中添加产品。该单据的作用仅在于声明在原发票基础上、就相同或更少产品需要增加的金额。

开票取消

可以撤销经政府验证的电子发票。

注解

请检查电子发票是否仍在撤销期限内，该期限因各州法规而异。

商品电子发票（NF-e）

要在 Odoo 中撤销商品（NF-e）电子发票，请点击 申请撤销，并在弹出的窗口中添加撤销 原因。如需通过电子邮件将此撤销原因发送给客户，请勾选 电子邮件 复选框。

注解

This is an electronic cancellation, which means that Odoo will send a request to the government to cancel the NF-e.

服务电子发票 (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 (Secretaria da Fazenda) 保障。

更多内容

销售终端

配置

请 安装 Brazilian Accounting EDI for POS (l10nbr_edi_pos) 模块，并确保激活 AvaTax。

CSC 详细信息

前往 会计 ‣ 配置 ‣ 设置 并滚动到 税项 部分。在 NFC-e 配置 部分中，完成以下 CSC（纳税人安全编码）字段的填写：

• CSC ID：CSC ID 或 CSC 令牌 是纳税人安全编码的标识，可包含 1 至 6 位数字，可在您所在州的财政厅（SEFAZ）官方网站获取。

• CSC 编号：CSC 编号 是一串最长 36 个字符、仅您与财政厅知晓的代码。它用于生成 NFC-e 的二维码并确保 DANFE 的真实性。

注解

这些字段所需的信息可由公司会计师通过各巴西州的 SEFAZ 网站生成。

产品配置

访问POS 中相关的产品表单，然后配置该产品的巴西会计字段。

门店收银POS

转到POS ‣ 配置 ‣ 设置，确保在屏幕顶部选中了相关的 POS。然后，向下滚动到会计部分，并配置巴西 EDI字段：

• Series

• 下一号码：序列中即将开具的下一个 NFC-e 号码。例如，如果在 SEFAZ 最后开具的号码是 100，则 下一号码 为 101。

工作流

生成 NFC-e

要生成 NFC-e，请按照以下步骤操作：

1. 開啟相關的銷售點商店並進行銷售。

2. 验证付款以计算税额并开具 NFC-e。有效的 NFC-e 会显示在屏幕右侧。

注解

也可以开具以 CPF/CNPJ 识别客户的 NFC-e。为此，请点击 客户，搜索客户或新建一位客户。

开具以 CPF/CNPJ 识别的 NFC-e 需要以下必填字段：

• 名称

• 开具发票所在的 城市 和 州

• CPF/CNPJ

1. 点击 验证。NFC-e 随即出现，并在打印件上突出显示客户的 CPF。

2. 点击 打印 或 通过电子邮件发送，将发票交付给客户。

NFC-e 票据打印

在 生成并验证 NFC-e 之后，点击 打印 交付发票。

注解

Odoo 的 NFC-e 功能兼容任何热敏打印机，且无需 Odoo IoT Box。

重新开具出现 NFC-e 错误的 POS 订单

如果 NFC-e 返回错误，请按照以下步骤操作：

1. 更正错误。

2. 点击 (菜单) 图标并选择 订单，重新开具 NFC-e。

3. 筛选列表仅显示 已付款 订单，并点击 详情。此时会显示错误信息。

4. 点击 发送 NFC-e。

注解

如果錯誤已更正且POS收銀機已關閉，Odoo會在相關日記帳分錄的討論串中記錄稅務調整。訂單的日記帳分錄表示稅款計算錯誤。在這種情況下，需要重新處理NFC-e。

NFC-e 退款与撤销

退款可以直接在Odoo中處理，但 取消 必須透過官方政府門戶執行。

流程完成后，即创建已批准的退货 NF-e，意味着 先前的 NFC-e 被撤销。

重要

SEFAZ 仅允许在其网站上撤销开具 30 分钟内 的 NFC-e。超过该期限后，必须手动办理退货，并开具一张 货物退货 NF-e。