TaxCloud集成

Warning

Odoo 的 TaxCloud 集成自 Odoo 17 起开始逐步停用。Odoo 17 中禁止新安装。在 Odoo 18 中,TaxCloud 模块将 完全 不复存在。Odoo 建议改用 Avatax 平台。

更多内容

AvaTax 整合功能

TaxCloud 可实时计算美国各州、各城市和特殊管辖区的销售税率。它还能跟踪哪些产品免征销售税,以及每项免税规定适用于哪些州。

TaxCloud登记

在 TaxCloud.com 中登记科目,并完成设置。启用后,点击 店铺 ,转到 TaxCloud API密钥,然后 获取详情 。

店铺TaxCloud API密钥示例

启用TaxCloud

  1. 转到 会计仪表板‣配置‣设置 ,在 税项 部分,启用 TaxCloud 。

  2. 在 API ID 下添加店铺的 登录ID ,在 API密钥 下添加店铺的 密钥 ,然后,点击 保存 。

  3. 点击 默认类别 旁的 刷新 按钮( 🗘 ),以从TaxCloud导入TIC 纳税信息代码 产品品类。某些类别可能有特定税率或享受免税。

  4. 选择 默认类别 ,并 保存 。您的产品或产品品类未设置 TaxCloud类别 时,或订单/开票中无产品时,使用 默认类别 。

    在Odoo中填写TaxCloud API密钥

设置产品的TaxCloud类别

如果您需要使用多个TIC类别(即 默认类别 ),转到产品的 一般信息 选项卡,选择 TaxCloud类别 。

如果要同时配置多个产品,请确保它们的 产品品类 相同,点击外部链接按钮( 🡕 ), 在 产品品类 中设置 TaxCloud 类别。

Note

如果为某个产品上设置了 TaxCloud 类别,同时在 产品品类 中设置了不同类别,则Odoo仅考虑产品的 TaxCloud 类别。

在 母产品品类 中设置的 TaxCloud类别 不适用于 子产品品类。例如,如果为 所有 产品品类 设置了 TaxCloud类别 ,该类别不适用于 所有/销售 产品品类。

Important

确保您的公司地址完整,包括州和邮编。转到 设置‣公司:更新信息 ,打开并编辑公司地址。

为正确应纳税科目自动过账税费

要确保TaxCloud集成后生成的新税项基于正确的 应付税项 科目,应创建 用户定义的默认值。您所有使用TaxCloud的公司均应完成该过程。

Warning

用户定义的默认值会影响所有记录。这意味着,所有 新税项会被设置为在指定的应付税项科目中记录收入,除非手动编辑税项,以指定其他收入科目(或优先选择用户定义的另一个默认值)。

转到 会计仪表板‣配置‣会计:科目表 ,找到您公司的 应付税项 科目,点击 设置 。请注意URL字符串中 id= 后的数字,这是 应付税项科目ID,用于之后操作。

URL字符串中的应付税项科目示例

激活 developer mode ,然后转到 设置‣技术‣动作:用户定义默认值 ,点击 创建 。

点击 字段 下拉菜单,然后点击 搜索更多… 。

用户定义默认值字段搜索

使用搜索栏筛选 税项重新划分行 模块,然后筛选 科目 字段。在 模式 列下选择带有 税项重新划分行 的行。

搜索税项重新划分行模块和科目字段

返回到 用户定义默认值 创建后,在 默认值(JSON格式) 字段输入之前记录的 应付税项科目ID。

在 公司 字段下选择要使用此配置的公司,然后点击 保存 。

用户定义默认值配置示例

自动检测财政状况

在Odoo中,根据 fiscal positions 计算销售税。启用TaxCloud时,创建美国财政状况。

您可以将Odoo配置为自动检测财政状况适用的客户。转到 会计仪表板‣配置‣会计:财政状况 ,选择 自动税项映射(TaxCloud) 。启用 自动检测 ,然后点击 保存 。

自动检测TaxCloud财政状况设置

如果客户所在国家/地区为 美国,在任何订单或开票中将自动设置该财政状况,以触发税费自动计算。

Note

要在销售订单中获取销售税,只需确认税项,或点击 添加发货 旁的 更新税项 按钮。

优惠券和促销互动

如果您使用 优惠券 或 促销计划,TaxCloud集成可能出现意外情况。事实上,鉴于TaxCloud税费计算不接受负数金额行,因此,因促销计划而添加的行的金额须从受其影响的行的总额中扣除。

Important

这意味着,除其他复杂过程外,使用TaxCloud财政状况下的优惠券或促销活动的订单 须 开具完整开票,无法为部分交货等情况开具开票。

还有另一种意外情况。例如,您根据5折促销计划销售了某产品,如果产品的税率为7%,TaxCloud集成后计算的税率显示为3.5%,因为折扣包含在发送给TaxCloud的价格中。然而,在Odoo中,折扣处理情况完全不同,但税率计算结果是正确的。事实上,对全价征收3.5%的税,就相当于对半价征收7%的税,但从用户角度来看,这可能令人不解。