Avalara 集成

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

重要

虽然 AvaTax 计算对全球 客户 均受支持，但 AvaTax 仅可与 会计所在国家/地区 设置为 美国、加拿大 或 巴西 的 数据库/公司 集成。

本页介绍美国和加拿大公司的操作流程；巴西公司的流程有所不同，详见 巴西本地化页面 。

AvaTax 会考虑各州、县和城市的基于位置的税率。它密切关注法律、规则、管辖区边界及特殊情形（如免税期和商品豁免），从而提高税款缴纳的准确性。

重要

• AvaTax 默认使用公司地址。如需使用仓库地址，请在 POS 应用设置中启用 允许稍后发货 。

• 不支持 对某些特定商品（如烟草、燃料等）征收的补充税费。

另请参阅

Avalara AvaTax 概览

模块安装

使用 AvaTax 需要 安装 AvaTax 模块。为此，请打开 应用 应用，移除 搜索 栏中的 应用 筛选器，输入 AvaTax，然后按 Enter 键，即可显示与 AvaTax 相关的可用模块：

• Avatax （account_avatax）：默认 AvaTax 模块，为税务计算添加基础 AvaTax 功能。

• Avatax for SO （account_avatax_sale）：包含在 Odoo 中对销售订单进行税务计算所需的信息。

• Avatax 库存 （account_avatax_stock）：在 Odoo 库存中包含税务计算。

如果需要在地理本地化或 Amazon Connector 中使用 AvaTax，请单独 安装 这些模块：

• Avatax for geo localization （account_avatax_geolocalize）：包含将 AvaTax 集成到 Odoo 地理本地化中所需的功能。

• Amazon/Avatax 桥接 （sale_amazon_avatax）：Amazon Connector 与 Odoo 之间的税务计算功能。

此外还提供与 巴西财税本地化 相关的其他模块。

另请参阅

有关财税本地化本身的更多信息，请查看以下 财务本地化 文档：

• 加拿大

• 美国

• 巴西

可用的集成

对于美国和加拿大的用户，AvaTax 集成有两种选择：

• Avalara Included：一款价格实惠的 应用内购买服务，专为有基本税务计算需求的中小企业设计。

• Avalara Direct：面向高交易量或复杂业务的强大解决方案，由 Avalara 直接提供定制支持。

	Avalara Included	Avalara Direct
最适合	中小企业 / 交易量较低	中型市场/ 企业级
AvaTax 引擎	✅	✅
每笔交易成本	$ 基于点数	$$ 基于合同
账户管理方	Odoo IAP	Avalara Direct
Odoo 技术支持	✅	✅
年度交易限额	5,000	无限自定义
一线支持由	Odoo	Avalara
Avalara Direct 支持	有限	✅
申报准备与提交	⚠️ 仅限附加服务	⚠️ 仅限附加服务
税款缴纳	⚠️ 仅限附加服务	⚠️ 仅限附加服务

Avalara Included

Avalara Included 是一款价格实惠的应用内税务计算服务，专为具有基本税务合规需求的中小型企业而设计。该服务基于 Avalara 的 AvaTax 平台构建，可与 Odoo 集成，为销售、采购和发票提供实时的、针对特定地区的税务计算。

Avalara Included 适用于在美国和加拿大设有经营地点的数据库/公司。

另请参阅

Avalara 支持文档

重要

• 年交易量超过 5,000 笔的企业必须改用 Avalara Direct 方案，以确保在更高交易量下服务不中断。如需从 Avalara Included 迁移到 Avalara Direct，请与您的客户经理联系。

• 在 多公司环境 中，Avalara Included 凭证无法在公司之间共享。相反，需为数据库中的每个公司使用唯一的电子邮件地址 创建一个独立的 Avalara Included 账户 。

应用内购买点数

Avalara Included 要求用户在 Odoo IAP 页面 上购买点数。

每当使用 Avatax 财政状况过账一张发票或贷记单时，就会消耗一个点数。请根据预计交易数量，选择最符合需求的套餐。

配置

Avalara Included 既适用于尚未拥有 Avalara 账户、需要 创建 账户的 Odoo 用户，也适用于已有 Avalara 账户、希望将其 迁移 到 Avalara Included 方案的 Odoo 用户。

创建 Avalara Included 账户

重要

Avalara 账户激活 必须 在正式数据库中完成。如果从没有关联有效企业账户的测试数据库创建账户，可能会显示错误消息，提示未找到有效的企业合同。

要激活并使用 Avalara Included 功能，请按以下步骤操作：

1. 转到 会计 ‣ 配置 ‣ 设置 。

2. 在 税项 部分，启用 AvaTax 。

1. 选择 Avalara Included 作为账户类型，并输入有效的电子邮件地址。该电子邮件地址用于将公司信息关联到 Avalara Included 账户。

2. 点击 连接到 Avalara Included，以在 Odoo 数据库与新的 Avalara 账户之间建立连接。

3. 接受 Avalara 的条款和条件。

4. 此时，Avalara 账户已创建，系统会自动向关联的电子邮件地址发送一封邮件。请按照邮件中的说明，通过创建密码并在 Avalara 门户中注册来激活账户。

测试连接

创建 Avalara Included 账户后，点击 测试连接 。这可确保 AvaTax 门户电子邮件 字段中添加的电子邮件地址正确，并在 Odoo 与 AvaTax API 之间建立连接。

同步参数

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

创建基本公司资料

要完成 Avalara 账户设置，请 创建基本公司资料。

为下一步收集必要的企业详细信息：收税地点、销售的产品/服务（及其销售地点）以及客户免税情况（如适用）。按照 Avalara 文档创建基本公司简介：

1. 添加公司信息.

2. 添加公司收取和缴纳税款的地点。

3. 验证税务辖区并激活公司。

4. 添加其他营业场所实现分地区申报。

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

注解

完成这些 Avalara Included 专属配置后，请务必完成 Avalara Included 和 Avalara Direct 共有的 配置 。

迁移到 Avalara Included

目前在正式环境中使用 Avalara Direct、且年交易量（包括发票和贷记单）少于 5,000 笔的公司，可以将其账户方案迁移到 Avalara Included。

重要

从 Avalara Direct 迁移到 Avalara Included 会将 Avalara 账户从按月合同模式改为应用内购买模式，在此模式下可根据交易量购买交易点数。一线支持也转由 Odoo 提供。

要迁移到 Avalara Included，请按以下步骤操作：

1. 转到 会计 ‣ 配置 ‣ 设置 。

2. 在 税项 部分，于 AvaTax 下确认 集成方法 设置为 Avalara Direct 。

3. 在 环境 字段中，选择 正式运行 。确认 API ID 和 API 密钥 已正确配置。

4. 点击 迁移到 Avalara Included 。在继续迁移之前，会出现一条确认消息，概述 Avalara 服务和定价的变更。

5. 在确认迁移之前，请仔细查看各集成方式之间的差异。

迁移完成后，会出现一条确认消息，表明账户已成功迁移到 Avalara Included。

注解

由于迁移过程使用与 Avalara Direct 账户关联的同一电子邮件地址，因此仍可使用现有电子邮件地址访问 Avalara 门户。Odoo 中无需额外的电子邮件配置。

重要

迁移完成后，必须购买 IAP 点数 才能继续使用 AvaTax 引擎。

Avalara Direct

Avalara Direct 是一款应用内税务计算服务，专为交易量大（每年 5000 笔以上）且需求更复杂的中型市场和企业级企业设计。Avalara Direct 基于 Avalara 的 AvaTax 引擎构建，可与 Odoo 集成，为销售、采购和发票提供实时的、针对特定地区的税务计算。

Avalara Direct 适用于在美国和加拿大设有经营地点的数据库/公司。

另请参阅

Avalara 支持文档

注解

大多数中小型企业应改用 Avalara Included 。年交易量少于 5,000 笔的现有 Avalara Direct 用户可以 迁移到 Avalara Included 。

配置

创建账户

要使用 AvaTax，设置时需要拥有 Avalara 账户。如果尚未设置，请 联系 Avalara 购买许可证。

小技巧

账户设置完成后，请记下 AvaTax 账户 ID 。Odoo 设置 中会用到它。在 Odoo 中，该编号即为 API ID 。

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

创建基本公司资料

为下一步收集必要的企业详细信息：收税地点、销售的产品/服务（及其销售地点）以及客户免税情况（如适用）。按照 Avalara 文档创建基本公司简介：

1. 添加公司信息.

2. 告诉我们公司在哪里收税和缴税。

3. 验证税务辖区并激活公司。

4. 添加其他营业场所实现分地区申报。

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

连接到 Avalara

在 Avalara 中创建基本公司资料后，将 Avalara 与 Odoo 连接。

根据您希望集成的 Avalara 账户类型，转到 Avalara 的 沙盒环境 或 正式环境。

另请参阅

Avalara 中的沙盒环境与正式环境。

登录以创建 许可证密钥 。转到 设置 ‣ 许可证和 API 密钥 。在 许可证密钥和客户端密钥 选项卡中，点击 生成许可证密钥 。

重要

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

如果这是 AvaTax 与 Odoo 之间的首次 API 集成，请点击 生成许可证密钥 。

如果这是一个额外的许可证密钥，请确保可以断开之前的连接。与每个 Avalara 沙盒和正式运行账户相关联的许可证密钥 只有 一个。

警告

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

Odoo AvaTax 设置

要将 AvaTax 与 Odoo 集成，请按以下步骤操作：

1. 转到 会计 ‣ 配置 ‣ 设置 。

2. 向下滚动到 税项 部分，并启用 AvaTax 。

3. 在 集成方法 字段中，选择 Avalara Direct 。

   

4. 选择公司希望在其中使用 AvaTax 的 环境 。它可以是 沙盒 或 正式运行 。

5. 在 API ID 字段中输入 AvaTax 账户 ID，在 API 密钥 字段中输入 许可证密钥 。

   小技巧

   • 登录 AvaTax 门户（沙盒 或 正式）即可找到 账户 ID：

     1. 在右上角，点击 账户 。

     2. 账户 ID 显示在菜单顶部。

   • 详细了解如何获取 许可证密钥 。

6. 在 公司代码 字段中，输入所配置公司的 Avalara 公司代码。如果未设置，Avalara 会将其解释为 DEFAULT 。

   注解

   登录 Avalara 门户（沙盒 或 正式）并转到 设置 ‣ 所有设置，即可获取 公司代码 。代码显示在 公司代码 列中。

测试连接

输入 API ID 和 API 密钥 后，点击 测试连接 。这可确保 API ID 和 API 密钥 正确，并在 Odoo 与 AvaTax 之间建立连接。

同步参数

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

注解

完成这些 Avalara Direct 专属配置后，请务必完成 Avalara Included 和 Avalara Direct 共有的 配置 。

Odoo 配置

无论公司使用哪种 Avalara 集成，在使用 AvaTax 之前，都需要在 Odoo 中进行一些额外配置，以确保税务计算准确无误。

会计所在国家/地区

要设置 会计所在国家/地区，请转到 会计 ‣ 配置 ‣ 设置 。

在 税项 部分下，将 会计所在国家/地区 功能设置为 美国 或 加拿大 。然后点击 保存 。

另请参阅

财务本地化

公司设置

Odoo 数据库中运营的所有公司都应在设置中列出完整详细的地址。打开 设置 应用，向下滚动到 公司 部分。如果数据库只有一个公司，请点击 更新信息 以更新公司详细信息。

如果数据库中有多个公司运营，请点击 管理公司，然后点击列表中的每个公司更新其信息。

每个公司的 街道、街道2、城市、状态、邮政编码 和 国家/地区 都必须是最新的，以确保税务计算准确、年末会计操作顺畅。

另请参阅

公司

交易选项

要配置与 AvaTax 相关的交易设置，请转到 会计 ‣ 配置 ‣ 设置，并在 AvaTax 部分启用相关选项：

• 使用 UPC：在交易中使用通用产品代码 (UPC)，而非 Avalara 中自定义的代码。具体指导请咨询注册会计师 (CPA)。

• 承诺交易：将 Odoo 数据库中的交易添加到 AvaTax 报告中。

地址验证

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

重要

地址验证 功能仅适用于北美地区的合作伙伴/客户。

要启用地址验证，请转到 会计 ‣ 配置 ‣ 设置，向下滚动到 税项 部分，并在 AvaTax 下勾选 地址验证 旁边的复选框。

保存 设置后，北美联系人记录上会显示 验证 链接。每个联系人的地址必须单独验证：

要 验证 地址，请打开 联系人 应用并选择一个联系人。启用 地址验证 功能后，验证 链接会显示在 地址 旁边。

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

警告

Odoo 数据库中联系人之前输入的所有地址都需要使用上述验证流程进行验证。

重要

为获得准确的税务计算，最佳做法是为数据库中保存的联系人输入完整地址。不过，AvaTax 仍可仅使用 国家/地区、状态 和 邮政编码 尽力完成计算。这是三个最低必需的字段。

财政状况

财政状况（税项和科目映射） 用于根据客户确定应适用哪些税率。它们还用于 账户映射 。

要为 AvaTax 配置财政状况：

1. 转到 会计 ‣ 配置 ‣ 财政状况 。

2. 在列表中点击默认的 自动税收映射（AvaTax），或 创建新的财政状况 。

3. 确保在财政状况表单视图中启用了 使用 AvaTax API 。

4. 可选地，启用 自动检测，以 自动 将财政状况应用到 Odoo 中符合该财政状况所设条件的交易记录。

重要

如果禁用了 自动检测 功能，则必须 为每个客户设置 财政状况。

AvaTax 账户

为财政状况启用 使用 AvaTax API 后，请在 AvaTax 选项卡的 AvaTax 发票账户 和 AvaTax 退款账户 字段中设置相关账户，以确保年末记录保存顺畅。有关这两个账户的设置指导，请咨询注册会计师 (CPA)。

AvaTax 产品类别代码

AvaTax 使用产品类别代码对产品进行分类，以确保对每种产品应用正确的税项。在使用集成之前，请在每个产品类别或单个产品上指定 AvaTax 产品类别代码。

要为产品类别设置 AvaTax 产品类别代码，请转到 会计 ‣ 配置 ‣ 产品类别，选择相关产品类别。然后，从 AvaTax 类别 下拉菜单中选择 AvaTax 产品类别，或点击 搜索更多 打开完整的选项列表。

要为单个产品设置 AvaTax 产品类别代码，请转到 会计 ‣ 客户 ‣ 产品，并移除默认的 销售 筛选器。选择相关产品，然后从 AvaTax 类别 下拉菜单中选择 AvaTax 产品类别，或点击 搜索更多 打开完整的选项列表。

重要

每个产品都必须有一个 AvaTax 类别，无论是在产品表单上直接定义的，还是在产品所属的产品类别上定义的。

注解

如果产品和其类别都设置了 AvaTax 类别，则以产品的 AvaTax 类别 为准。

另请参阅

• 财政状况（税项和科目映射）

• 使用 AvaTax

• Avalara (Avatax) 门户网站

• US 税务合规：Avatax 线上学习影片

• 使用 AvaTax
• Avalara (Avatax) 门户网站