巴西¶

介绍¶

借助巴西本地化，您可以通过 API 调用，使用 AvaTax (Avalara) 自动计算商品的销售税，还可以为服务配置税项。

对于商品税计算部分，您需要在 Odoo 常规设置中配置联系人、公司、产品，并在 Avatax 中创建账户。

对于服务税，您可以直接从 Odoo 创建和配置，而无需使用 AvaTax 进行计算。

本地化功能还包括税收和可根据需要修改的会计科目表模板。

配置¶

模块安装¶

安装以下模块，以获得巴西本地化的所有功能：

名称	技术名称	说明
巴西 - 会计	`l10n_br`	默认财税本地化包 - 为巴西本地化添加会计特征，这些特征代表公司在巴西运营所需的最低配置。安装该模块后，会自动加载：会计科目表、税项，以及正确配置联系人所需的字段。
巴西 - 会计报告	`l10n_br_reports`	添加一份简单的税务报表，帮助查看指定期间内每个税组的税额。此外，还添加了适合巴西市场的损益表和资产负债表。
Avatax 巴西	`l10n_br_avatax`	通过 Avatax 添加巴西税务计算功能，以及配置 Odoo 所需的所有必要字段，以便正确使用 Avatax 并发送所需的税务信息，从而获取正确的税项。
Avatax for SOs in Brazil	`l10n_br_avatax_sale`	与 `l10n_br_avatax` 模块相同，只是扩展到了销售订单模块。

配置公司的基本参数¶

要配置公司信息，请访问联系人应用程序并搜索公司名称。

选择页面顶部的公司选项。然后，配置以下字段：
- 名称
- 地址（添加城市、州/省、邮政编码、国家/地区）
- 税号（ CNPJ ）
- IE （州登记号）
- IM （市登记号）
- SUFRAMA 代码（马瑙斯自由贸易区管理局 - 如适用则填写）
- 电话
- 电子邮件
配置销售及采购选项卡中的财务信息:
- 为 Avatax Brazil 添加财政状况。
- 税收制度（联邦税收制度）
- ICMS 纳税人类型（表示 ICMS 制度、免税状态或非纳税人。）
- 主要活动部门
最后，上传公司徽标并保存联系人。

Note

如果是简化制度，则需要在会计 ‣配置 ‣ Settings ‣ 税收 ‣ Avatax Brazil 下配置 ICMS 税率。

配置 AvaTax 整合¶

Avalara AvaTax 是一家税务计算服务提供商，可以集成到 Odoo 中，通过综合公司、联系人（客户）、产品和交易信息来自动计算税款，从而获取应使用的正确税项。

Odoo 是 Avalara Brazil 的认证合作伙伴，这意味着 Avalara 的专家已审核了此集成范围内的各项工作流程。

使用此集成需要借助应用内购买 (IAPs) 来计算税款。每次计算税款时都会发起一次 API 调用，并从您的 IAP 积分余额中扣除积分。

凭证配置¶

要在 Odoo 中激活 AvaTax，您需要创建一个账户。为此，请前往会计 ‣ 配置 ‣ 设置 ‣ 税费，在 AvaTax Brazil 部分添加您要用于登录 AvaTax 门户的电子邮件地址，然后点击创建账户。此电子邮箱将用作 AvaTax 中的管理员电子邮件地址。

从 Odoo 创建账户后，您需要进入 Avalara 门户设置密码：

访问 Avalara 门户
点击 Meu primeiro acesso
添加您在 Odoo 中创建 Avalara/Avatax 账户时使用的电子邮件地址，然后点击 Solicitar Senha
您将收到一封电子邮件，其中包含一个令牌和一个创建密码的链接。点击该链接并复制粘贴令牌，即可分配您所需的密码。

Warning

如果您打算先在测试或沙盒数据库中试用该集成，建议使用其他电子邮件地址，因为您将无法在生产数据库中重复使用同一电子邮件地址。

Tip

您无需创建密码或访问 Avalara 门户，即可开始在 Odoo 中使用 AvaTax；对 Odoo 而言，开始使用 Avalara 税务计算引擎的唯一要求是在设置页面创建一个账户。

Note

您可以转移 API 凭据。仅当您已在另一个 Odoo 实例中创建账户并希望重用时，才应使用此功能。

配置主数据¶

会计科目表¶

会计科目表会作为本地化模块所含数据集的一部分默认安装。系统会自动将科目映射到相应的税项，以及默认的应付账款和应收账款字段。

Note

巴西账目总表是建基于 SPED 的账目总表，它提供了巴西市场所需的基础账户。

您可以根据公司需要添加或删除账户。

税率¶

安装巴西本地化软件时会自动创建税项。Avalara 在计算销售订单或发票上的税额时，会使用已配置的税额。

可以编辑税项或添加更多税项。例如，用于服务的某些税项需要手动添加和配置，因为税项可能因提供服务的城市而异。

Important

AvaTax 不计算服务税。只计算货物税。

当为包含在最终价格中的服务配置税项时（即该税项不会在产品价格之上增加或扣减），请将税款计算设为已含价格税的百分比，并在高级选项选项卡中勾选包含在价格中选项。

有关如何根据您的需求更好地配置税项的更多信息，请参阅税项功能文档。

Warning

请勿删除税项，因为它们用于 AvaTax 税务计算。如果被删除，当在销售订单（SO）或发票中使用 AvaTax 计算税项时，Odoo 会重新创建这些税项，但是用于登记税项的账户需要在税项的定义选项卡下重新配置，包括发票分配和退款分配部分。

产品¶

要在销售订单和发票上使用 AvaTax 整合，首先要在产品上指定以下信息：

CEST 代码（需缴纳 ICMS 税替代的产品的代码）
Mercosul NCM 代码（南方共同市场通用命名产品代码）
原产地（指明产品的原产地，可以是国外或国内，也可能是取决于具体使用场景的其他选项）
SPED 税务产品类型（根据 SPED 列表表确定的税务产品类型）
用途（指定此产品的预期用途）

Note

Odoo 会自动创建三个用于销售相关运输成本的产品，名称分别为 Freight、Insurance 和 Other Costs。这些产品已完成配置；如需创建更多产品，请复制并使用相同的配置（所需配置：产品类型 Service ，运输成本类型 Insurance、Freight 或 Other Costs ）

联系人¶

使用整合前，请在联系人上指定以下信息：

联系人的基本信息：
- 如果联系人有税号（CNPJ），请选择公司选项；如果联系人有 CPF，请选择个人。
- 名称
- 地址：邮政编码是正确计算税项所必需的字段。
- 税号或 CPF ：个人使用 CPF，企业使用税号（CNPJ）
- IE ：州税识别号
- IM ：市税识别号
- SUFRAMA 代码：SUFRAMA 注册号
- 电话
- 电子邮件
Note
在将国家/地区设置为 巴西 之前， CPF 、 IE 、 IM 和 SUFRAMA 代码字段会被隐藏。
联系人在销售和采购选项卡下的税务信息：
- 财政状况：添加 AvaTax 财政状况，以便自动计算销售订单和发票上的税款。
- 税收制度: （联邦税制）
- ICMS 纳税人类型：纳税人类型决定该联系人属于 ICMS 制度、免税，还是非纳税人。
- 主要活动行业：联络人主要活动行业的清单

税务规则¶

要计算销售订单和发票上的税款，需要有一个启用了自动检测和使用 AvaTax API 选项的财政状况。

财政状况可在联系人上配置，或在创建销售订单或发票时选择。

工作流¶

本节概述了会触发 API 调用以进行税额计算的操作。

Warning

请注意，每次 API 调用都会产生费用。请留意会触发这些调用的操作，以便有效控制成本。

报价单/销售订单上的税款计算¶

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

报价确认
将报价单确认为销售订单。
手动触发
点击使用 Avatax 计算税额。
预览
点击预览按钮。
通过电子邮件发送报价单/销售订单
通过电子邮件向客户发送报价单或销售订单。
在线报价
当客户在线访问报价单（通过门户视图）时，会触发 API 调用。

Mirto Bonan¶

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

手动触发
点击使用 AvaTax 计算税款。
预览
点击预览按钮。
在线发票访问
当客户在线访问发票（通过门户视图）时，会触发 API 调用。

Note

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