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 (account_avatax_sale)：包含在 Odoo 中为销售订单计算税额所需的信息。

• 适用于库存的 Avatax (account_avatax_stock)：在 Odoo 库存中包含税额计算。

如果需要将 AvaTax 用于地理定位，或与 Amazon 连接器 配合使用，请分别 安装 这些模块：

• 适用于地理定位的 Avatax (account_avatax_geolocalize)：包含在 Odoo 中将 AvaTax 集成到地理定位所需的功能。

• Amazon/Avatax 桥接 (sale_amazon_avatax)：Amazon 连接器 与 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’s 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) 门户网站