AvaTax 集成

Avalara 的 AvaTax 是一款基于云的税务软件。将 AvaTax 与 Odoo 集成后，当用户在 Odoo 中销售、采购和开具发票时，可以提供实时且特定地区的税务计算。AvaTax 的税务计算支持联合国所有成员国，包括跨境交易。

重要

AvaTax 仅适用于与位于美国、加拿大和巴西的数据库/公司进行集成。这意味着数据库的税务位置/国家只能设置为美国、加拿大或巴西。有关更多信息，请参考此文档：财政国家。

AvaTax 为每个州、县和市提供基于位置的税率计算。它通过密切关注法律、规则、管辖边界和特殊情况（如免税期和产品豁免）来提高汇款准确性。与 AvaTax 集成的公司可以通过这种简单的 API（应用程序编程接口） 集成在内部保持对税务计算的控制。

重要

在 Odoo 中使用 AvaTax 进行税务计算时存在一些限制：

• AvaTax 不支持 Odoo 的 销售点 应用，因为动态税收计算模型对于单一配送地址内的交易（如商店或餐厅）来说过于复杂。

• AvaTax 和 Odoo 使用公司地址，**而不是**仓库地址。

• 消费税 不 支持。这包括烟草/电子烟税、燃油税以及其他特定行业的税种。

另请参阅

Avalara 的支持文档：关于 AvaTax

在 AvaTax 上设置

要使用 AvaTax，需要先在 Avalara 注册一个账户以进行设置。如果尚未设置，请联系 Avalara 购买许可证： Avalara: Let’s Talk。

小技巧

在账户设置完成后，请注意 AvaTax 的 Account ID。在 Odoo 设置 中会需要这个号码。在 Odoo 中，这个号码是 API ID。

然后，创建一个基本的公司简介。

创建基本公司档案

收集下一步所需的基本业务信息：征税地点、销售的产品/服务（及其销售地点），以及客户的免税情况（如适用）。按照 Avalara 文档创建一个基本公司档案：

1. 添加公司信息。

2. 告诉我们公司在何处收集和缴纳税款。

3. 验证司法管辖区并激活公司。

4. 添加其他公司位置以进行基于位置的申报。

5. 在公司简介中添加一个市场。

连接到 AvaTax

在 Avalara 中创建基本公司档案后，连接到 AvaTax。 此步骤将 Odoo 和 AvaTax 双向链接。

导航到 Avalara 的 沙盒环境 或 生产环境。这将取决于公司希望集成哪种类型的 Avalara 账户。

另请参阅

Avalara 中的沙盒环境与生产环境。

登录以创建 许可证密钥。转到 设置 ‣ 许可证和 API 密钥。点击 生成许可证密钥。

重要

出现一条警告，内容如下：如果您的业务应用程序已连接到 Avalara 解决方案，在您使用新的许可证密钥更新应用程序之前，连接将会中断。此操作无法撤销。

生成新的许可证密钥会中断与使用 AvaTax 集成的现有业务应用程序的连接。请确保使用新的许可证密钥更新这些应用程序。

如果这是首次将 AvaTax 和 Odoo 进行 API（应用程序编程接口） 集成，请点击 生成许可证密钥。

如果这是额外的许可证密钥，请确保可以断开之前的连接。每个 Avalara 沙盒和生产账户 仅 关联一个许可证密钥。

警告

将此密钥复制到安全的地方。强烈建议备份此许可证密钥以供将来参考。离开此屏幕后，此密钥 无法 再次获取。

配置

在使用 AvaTax 之前，Odoo 中有一些额外的配置，以确保税款计算的准确性。

验证 Odoo 数据库包含必要的数据。最初在数据库中设置的国家决定了税务位置，并帮助 AvaTax 计算准确的税率。

财政国家

要设置 财务国家，请导航至 会计应用 ‣ 配置 ‣ 设置。

另请参阅

财务本地化

在 税务 部分下，将 财务国家 功能设置为 美国、加拿大 或 巴西。然后，点击 保存。

公司设置

所有在 Odoo 数据库下运营的公司都应在设置中列出完整且详细的地址。导航到 设置应用，在 公司 部分下，确保只有一个公司在运营 Odoo 数据库。点击 更新信息 以打开一个单独的页面来更新公司详细信息。

如果数据库中有多个公司运营，点击 管理公司 以加载公司列表进行选择。通过点击特定公司来更新公司信息。

数据库管理员应确保为所有公司更新 街道…、街道2…、城市、州、邮政编码 和 国家 信息。

这确保了准确的税务计算和顺畅的年末会计操作。

另请参阅

• 公司

• 开始

模块安装

接下来，确保已安装 Odoo 的 AvaTax 模块。为此，请导航到 应用应用程序。在 搜索… 栏中输入 avatax，然后按下 Enter。将显示以下结果：

名称	技术名称	描述
Avatax	account_avatax	默认 AvaTax 模块。此模块添加了用于税务计算的基础 AvaTax 功能。
用于地理定位的 Avatax	account_avatax_geolocalize	此模块包含了将 AvaTax 集成到 Odoo 地理定位功能所需的特性。
Avatax for SO	account_avatax_sale	包含 Odoo 中销售订单税务计算所需的信息。
Avatax for Inventory	account_avatax_stock	在 Odoo 库存中包含税费计算。
Amazon/Avatax Bridge	sale_amazon_avatax	包括 Amazon Connector 与 Odoo 之间的税务计算功能。
Avatax Brazil	l10n_br_avatax	包含巴西本地化中的税务计算信息。
Avatax Brazil for Services	l10n_br_avatax_services	该模块包含了巴西本地化服务税务计算所需的功能。
Avatax Brazil 服务销售	l10n_br_edi_sale_services	此模块包含了巴西本地化服务销售所需的税务计算功能，其中包括电子数据交换（EDI）。
测试巴西 AvaTax 的 SOs	l10n_br_test_avatax_sale	该模块包含了巴西本地化中测试销售订单所需的特性。

点击标记为 Avatax 的模块上的 Install 按钮：account_avatax。这样做会安装以下模块：

• Avatax: account_avatax

• Avatax for SO: account_avatax_sale

• 库存的 Avatax: account_avatax_stock

如果需要 AvaTax 进行地理定位，或与 Amazon Connector 一起使用，请分别点击 Avatax for geo localization 和 Amazon/Avatax Bridge 上的 Install 单独安装这些模块。

另请参阅

有关特定地区的 AvaTax 说明，请查看以下 财务本地化 文档：

• 需要翻译的内容是:

• 美国

Odoo AvaTax 设置

要将 AvaTax API 与 Odoo 集成，请转到 会计应用 ‣ 配置 ‣ 设置 部分。在 税务 部分的 AvaTax 字段中进行 AvaTax 配置，并在此处输入凭据。

首先，勾选 AvaTax 设置左侧的复选框，以在数据库中激活 AvaTax。这是在 Odoo 数据库上快速、便捷地激活和停用 AvaTax 税务计算的方法。

先决条件

首先，选择公司希望使用 AvaTax 的 环境。它可以是 沙盒 或 生产环境。

另请参阅

为了帮助确定使用哪个 AvaTax 环境（生产环境 或 沙盒环境），请访问：沙盒环境与生产环境的对比。

凭据

现在可以输入凭证了。AvaTax 的 Account ID 应输入到 API ID 字段中，而 License Key 则应输入到 API Key 字段中。

重要

Account ID 可以通过登录 AvaTax 门户（sandbox 或 production）找到。在右上角，点击用户的首字母，然后选择 Account。Account ID 会首先列出。

要访问 许可证密钥，请参阅此文档：连接到 AvaTax。

在 公司代码 字段中，输入正在配置公司的 Avalara 公司代码。如果未设置，Avalara 会将其解释为 DEFAULT。公司代码 可以在 Avalara 管理门户中访问。

首先，登录到 AvaTax 门户（沙盒环境 或 生产环境）。然后，导航到 设置 ‣ 管理公司。公司代码 值位于 公司 行的 公司代码 列中。

交易选项

在 Odoo 的 AvaTax 设置中有两个可以配置的事务性设置：使用 UPC 和 提交事务。

如果勾选了 Use UPC 旁边的复选框，交易将使用通用产品代码 (UPC)，而不是在 Avalara 中自定义的代码。具体指导请咨询注册会计师 (CPA)。

如果勾选了 Commit Transactions 复选框，那么 Odoo 数据库中的交易将被提交以在 AvaTax 中进行报告。

地址验证

地址验证 功能确保在 Odoo 中为联系人设置符合邮政标准的最新地址。这对于为客户提供准确的税务计算非常重要。

重要

The Address Validation 功能仅适用于北美的合作伙伴/客户。

此外，勾选 地址验证 字段旁边的复选框。

重要

为了进行准确的税务计算，最佳实践是为数据库中保存的联系人输入完整的地址。然而，AvaTax 仍然可以通过仅使用 国家、州 和 邮政编码 来实现最佳努力尝试。这三个字段是最低要求。

保存 设置以应用配置。

小技巧

手动 验证 地址，通过导航到 联系人应用 并选择一个联系人。现在，AvaTax 模块已在数据库上配置完成，验证 按钮会直接出现在 地址 下方。

点击 验证，会弹出一个窗口，其中列出了 已验证地址 和 原始地址。如果 已验证地址 是用于税务目的的正确邮寄地址，请点击 保存已验证地址。

警告

Odoo 数据库中所有之前输入的联系人地址都需要使用上述手动验证流程进行验证。如果地址是之前输入的，则不会自动验证。这仅在计算税款时发生。

测试连接

在 Odoo 的 AvaTax 设置中输入上述所有信息后，点击 测试连接。这将确保 API ID 和 API KEY 是正确的，并且在 Odoo 和 AvaTax 应用程序编程接口 (API) 之间建立了连接。

同步参数

完成 AvaTax 部分的配置和设置后，点击 同步参数 按钮。此操作将从 AvaTax 同步豁免代码。

财政状况

接下来，导航到 会计应用 ‣ 配置 ‣ 会计：税务位置。会列出一个名为 自动税务映射 (AvaTax) 的 税务位置。点击它以打开 AvaTax 的税务位置配置页面。

在此处，确保勾选了 使用 AvaTax API 复选框。

可选地，勾选字段旁边的复选框，该字段标记为：自动检测。如果勾选此选项，Odoo 将自动为 Odoo 中的交易应用此 税务位置。

启用 自动检测 还会使特定参数显示出来，例如 需要增值税、外国税号、国家组、国家、联邦州 或 邮编范围。填写这些参数可以过滤 税务位置 的使用。如果留空，则确保所有计算都使用此 税务位置 进行。

警告

如果 自动检测 复选框未被勾选，则每个客户都需要在其联系人记录的 销售和采购 选项卡上设置 税务位置。为此，请导航至 销售应用 ‣ 订单 ‣ 客户，或 联系人应用 ‣ 联系人。然后，选择一个客户或联系人以设置税务位置。

导航到 销售和采购 选项卡，向下滚动到标记为 财务位置 的部分。将 财务位置 字段设置为客户的财务位置。

另请参阅

财政状况（税务和账户映射）

AvaTax 账户

选择 使用 AvaTax API 复选框选项后，会出现一个新的 AvaTax 标签页。点击此标签页以显示两种不同的设置。

第一个设置是 AvaTax 发票账户，第二个是 AvaTax 退款账户。确保两个账户都已设置，以便顺利地进行年终记录。有关设置这两个账户的具体指导，请咨询注册会计师 (CPA)。

单击 保存 以确保保存这些设置。

税务映射

AvaTax 集成适用于销售订单和发票，前提是包含 AvaTax 财务位置。

小技巧

此外，在 自动税务映射（AvaTax） 财务位置中，还有一个 税务映射 标签和一个 账户映射 标签，也可以在其中配置产品的映射。要访问 财务位置，请导航至 会计应用 ‣ 配置 ‣ 会计：财务位置。

产品类别映射

在使用集成之前，请在产品类别上指定一个 Avatax 类别。导航到 库存应用 ‣ 配置 ‣ 产品类别。选择要添加 AvaTax 类别 的产品类别。在 AvaTax 类别 字段中，从下拉菜单中选择一个类别，或者点击 搜索更多… 以打开完整的选项列表。

产品映射

AvaTax 类别也可以在单个产品上设置。要设置 Avatax Category，请导航到 库存应用 ‣ 产品 ‣ 产品。选择要添加 Avatax Category 的产品。在 通用信息 标签下，最右侧有一个标记为 Avatax Category 的选择器字段。最后，点击下拉菜单，选择一个类别，或者点击 搜索更多… 以查找未列出的类别。

注解

如果产品和其类别都设置了 AvaTax Category ，则产品的 AvaTax Category 优先。

重要

根据选择的路径，应为每个 产品 或 产品类别 完成在 产品 或 产品类别 上映射 AvaTax Category 的操作。

另请参阅

• 财政状况（税务和账户映射）

• AvaTax 使用

• Avalara (Avatax) 门户

• 美国税务合规：Avatax 在线学习视频

• AvaTax 使用
• Avalara (Avatax) 门户