巴西

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

以下与巴西本地化相关的模块可供使用：

名称技术名称描述
巴西会计l10n_br巴西 财政本地化包，包括巴西科目表、税种、税务报表、财政位置以及文档和身份识别类型。
巴西会计报告l10n_br_reports巴西的会计报表。
AvaTax 巴西l10n_br_avatax通过 Avalara 计算商品与服务税。
AvaTax 巴西销售l10n_br_avatax_sale巴西 AvaTax 的销售示例。
AvaTax 测试单l10n_br_test_avatax_sale巴西 AvaTax 的测试单。
巴西会计 EDIl10n_br_edi通过 AvaTax 提供电子发票。
巴西会计 EDI 销售l10n_br_edi_sale为销售订单添加发票所需字段。
巴西会计 EDI POSl10n_br_edi_pos在 POS 中通过 AvaTax 提供电子发票。
巴西会计 EDI 电商l10n_br_edi_website_sale为电商用户提供税费计算与 EDI。
巴西会计 EDI 库存l10n_br_edi_stock为 NF‑e 添加交付相关信息。
巴西网站销售l10n_br_website_sale为电商用户提供税费计算与 EDI。
巴西销售l10n_br_sales巴西的销售模块修改。
巴西销售订阅l10n_br_sale_subscription巴西的销售订阅模块修改。

:::: note ::: title 注意 ::: 核心本地化模块会随本地化一起自动安装，其余模块需要手动 安装 </applications/general/apps_modules>。 ::::

巴西本地化包确保符合巴西的财政与会计法规，提供管理税务、财政位置、报表以及预设的科目表等工具。

关键特性：

  • 科目表 <localizations/brazil/chart-of-accounts>：符合巴西会计标准的预设科目结构
  • 税种 <localizations/brazil/taxes>：预配置的税率（标准 VAT、零税率、免税等）
  • 工资 <../applications/hr/payroll>
  • 报表 <../accounting/reporting>

在 科目表 <../accounting/get_started/chart_of_accounts> 中，科目会自动映射对应税种，并设定默认的应付/应收科目。

:::: note ::: title 注意 ::: 巴西科目表基于 SPED CoA，提供所需的基本科目。 ::::

安装巴西本地化时，税种 <../accounting/taxes> 会自动创建并配置。AvaTax 会使用部分税种计算销售订单或发票的税费。

  • 服务类税种需要手动添加并根据所在城市调整税率。
  • 重要：手动创建的服务税种无法用于 NFS‑e，若需电子服务发票，请使用 AvaTax 计算税费。

:::: important ::: title 重要 ::: NFS‑e 只能通过 Avalara 计算税费后再电子发送。
::::

:::: warning ::: title 警告 ::: 不要删除税种，否则 AvaTax 会在下次使用时重新创建，但需要重新配置税种的“发票分配”和“退款分配”。
::::

使用巴西本地化的全部功能，需要在 公司记录 中填写以下必填字段：

  • 名称
  • 地址（城市、州、邮编、国家、街道、街道 2）
  • 身份证号：CNPJ 或 CPF
  • 税号（关联身份类型）
  • IE：州登记号
  • IM：市登记号
  • SUFRAMA 代码（如适用）
  • 电话、电子邮件

在 销售与采购 标签页中设置 财政信息：

  • 添加 财政位置 <localizations/brazil/fiscal-positions>（用于 AvaTax 巴西）
  • 税收制度：联邦税收制度
  • ICMS 纳税人类型：ICMS 制度、免税或非纳税人
  • 主营业务行业

若要开具 NFS‑e，还需配置：

  • COFINS 细节（应税、免税、0% 等）
  • PIS 细节（同上）
  • CSLL 是否适用

:::: tip ::: title 技巧 ::: 简化制度下，需要在 会计 → 配置 → 设置 → 税务 中设置默认的 销售税 与 采购税。
::::

同样的配置也适用于 联系人 表单，使用 AvaTax 时请确保联系人选择 公司（CNPJ）或 个人（CPF）。

:::: note ::: title 注意 :::

  • 确保已 安装 AvaTax Brazil（l10n_br_avatax）模块。
  • Odoo 是 Avalara 巴西的认证合作伙伴。
  • AvaTax 使用 应用内购买 (IAP) 计费，每次税费计算或电子发票提交都会消耗信用点。首次创建的数据库默认获得 500 免费信用点。
    ::::

要使用商品与服务税费计算以及电子发票，需要完成以下配置：

  • 公司信息（见上文）
  • 联系人信息（见上文）
  • AvaTax 配置 <localizations/brazil/avatax-credentials>
  • A1 数字证书 <localizations/brazil/certificate-upload>
  • 税务映射 <localizations/brazil/fiscal-positions>
  • 产品信息 <localizations/brazil/products>

在 会计 → 配置 → 设置 中激活 AvaTax，随后在 AvaTax 巴西 区域填写 AvaTax 门户邮箱，点击 fa-plug 创建账户。

:::: warning ::: title 警告 :::

  • 测试或生产环境均需使用真实邮箱，以便连接 Avalara 并完成证书配置。
  • 测试门户：https://portal.sandbox.avalarabrasil.com.br/
  • 生产门户：https://portal.avalarabrasil.com.br/
  • 创建账户后请保存 API ID 与 API Key。

::::

创建账户后，在 Avalara 门户设置密码：

  1. 访问 Avalara 门户。
  2. 点击 Meu primeiro acesso。
  3. 输入 Odoo 中使用的邮箱，点击 Solicitar Senha。
  4. 收到邮件后使用链接和令牌设置密码。

:::: tip ::: title 技巧 ::: 如果仅在 Odoo 中使用 AvaTax 进行税费计算，可不必登录 Avalara 门户，也不必上传证书。
::::

:::: note ::: title 注意 ::: 已有其他 Odoo 实例的 API 凭证可以转移，仅在已有账户时使用。
::::

为开具电子发票，需要在 AvaTax 门户上传数字证书。证书会在 Odoo 与门户之间同步，前提是 外部标识号 与 CNPJ 完全匹配且不含特殊字符。

:::: important ::: title 重要 ::: 部分城市要求在当地市政门户先绑定证书，才能通过 Odoo 发送 NFS‑e。若收到 “Your certificate is not linked to the user” 错误，请先在市政门户完成绑定。
::::

在 财政位置 中启用 自动税务映射（Avalara Brazil），并勾选 自动检测 与 使用 AvaTax Brazil API。

::: seealso 财政位置 <../accounting/taxes/fiscal_positions> :::

在产品表单的 销售 标签页 巴西会计 区域，根据商品或服务的使用场景填写相应信息。

商品电子发票（NF‑e） {#localizations/brazil/e-invoice-goods}

:::: important ::: title 重要 ::: AvaTax 按信用点计费，主要消耗点的操作包括：

  • 销售：报价/销售订单税费计算
  • 会计：发票税费计算、电子发票提交（NF‑e）
  • 偶发：更正信、发票作废、退款、补开发票、发票号段作废等

::::

示例：
销售订单确认 → 1 信用点（税费计算）
发票创建 → 1 信用点（税费计算）
发票确认并提交 → 1 信用点（税费计算）+1 信用点（提交）= 4 信用点

  • CEST 代码：税收替代分类代码（参考 https://www.codigocest.com.br/）
  • Mercosul NCM 代码：南方共同体商品编码
  • 产地：国内或国外等
  • SPED 财务产品类型：依据 SPED 列表的产品类型
  • 用途：产品的使用目的

:::: note ::: title 注意 ::: Odoo 自动创建 运费、保险、其他费用 三个用于运输成本的产品，若需自定义可复制后保持相同配置（类型为服务，运输成本类型对应）。
::::

服务电子发票（NFS‑e） {#localizations/brazil/e-invoice-services}

（同上，信用点消耗规则相同）

  • Mercosul NCM 代码
  • 用途
  • 服务代码来源：服务提供方所在城市的代码
  • 劳务分配：是否涉及劳务
  • 运输费用类型
  • 服务代码：若未填写则使用 服务代码来源

::: seealso 税费计算 <accounting/avatax/tax-calculation> :::

通过 AvaTax 自动调用 API 计算税费的方式包括：

  • 确认报价：将报价转为销售订单
  • 手动触发：点击 使用 AvaTax 计算税费
  • 预览：点击 预览
  • 邮件发送报价/订单：发送邮件时自动计算
  • 在线访问报价：客户在门户查看报价时自动计算
  • 手动触发：点击 使用 AvaTax 计算税费
  • 预览：点击 预览
  • 在线访问发票：客户在门户查看发票时自动计算

注意：必须将 财政位置 设置为 自动税务映射（Avalara Brazil） 才能触发自动计算。

::: seealso 财政位置（税务与科目映射） <../accounting/taxes/fiscal_positions> :::

在 会计 → 配置 → 日记账 中为电子发票设置 系列号（Series），每个系列对应一个序列号段。若需多个系列，请创建对应的销售日记账并分配系列号。

勾选 使用凭证？ 后，系列 字段才会显示。

开具 NF‑e（商品）或 NFS‑e（服务）电子发票的必填项：

  • 客户信息
  • 支付方式：巴西
  • 凭证类型：(55) 电子发票 (NF-e) 或 (SE) 电子服务发票 (NFS-e)
  • 财政位置：设为 自动税务映射（Avalara Brazil）

可选项（视业务而定）：

  • 运费模型（国内运输方式）
  • 巴西承运商

完成后点击 发送 → 在 打印与发送 窗口点击 处理电子发票，可选择下载或邮件发送。

如需登记退货，可在 Odoo 中创建 贷项通知单 并提交政府验证（仅适用于 NF‑e）。

用于在原发票上补充信息或更正金额，仅适用于 NF‑e，且只能包含原发票中的产品（不可新增产品）。

已获政府验证的电子发票可以作废，需确认是否仍在各州规定的作废期限内。

商品电子发票（NF‑e）作废 {#localizations/brazil/e-invoice-goods-nf-e}

点击 请求作废，填写作废原因，可勾选 邮件 将原因发送给客户。此操作会消耗 1 个