TaxCloud 集成¶
警告
The Odoo TaxCloud integration has begun its decommissioning, starting in Odoo 17. New installations are prohibited in Odoo 17. In Odoo 18, the TaxCloud module(s) will not exist at all. Odoo recommends the use of the Avatax platform, instead.
另请参阅
TaxCloud calculates the sales tax rate in real time for every state, city, and special jurisdiction in the United States. It keeps track of which products are exempt from sales tax, and in which states each exemption applies.
TaxCloud 注册¶
在 TaxCloud.com <https://taxcloud.com/register> _ 上注册一个账户并完成设置。一旦您开始使用，点击 Stores ，然后点击 Get Details 获取 TaxCloud API Keys 。
启用 TaxCloud¶
前往 并在 税 部分启用 TaxCloud.
将商店的 登录ID 添加到 API ID 下，将商店的 密钥 添加到 API KEY 下。点击 保存。
点击 刷新 按钮 (🗘) 旁边的 默认类别，从 TaxCloud 导入 TIC 税收适用信息代码 产品类别。某些类别可能暗示特定的税率或免税。
选择一个 默认类别 并 保存。当产品或产品类别上没有设置 TaxCloud 类别，或者在订单/发票中没有找到产品时，将应用 默认类别。
在产品上设置TaxCloud类别¶
如果您需要使用多个TIC类别（即： 默认类别 ），请转到产品的 常规信息 选项卡，并选择一个 TaxCloud类别 。
如果您想同时配置多个产品，请确保它们共享相同的 产品类别，然后点击外部链接按钮（🡕）在 产品类别 上设置 TaxCloud 类别，而不是在:guilabel:产品类别 上设置。
注解
如果您在产品上设置了 TaxCloud Category，并在其 Product Category 上设置了另一个，Odoo 只会考虑产品本身上找到的 TaxCloud Category。
在 父产品类别 上设置的 TaxCloud Category 不适用于其 子产品类别 。例如，如果您在 All Product Category 上设置了 TaxCloud Category ，它不适用于 All/Sales Product Category 。
重要
确保您的公司地址完整，包括州和邮政编码。转到 打开并编辑您的公司地址。
自动将税费发布到正确的应交税费账户中¶
为确保由TaxCloud集成生成的新税收使用正确的 应交税款 账户，创建一个 用户定义的默认值 。对于使用TaxCloud的每个公司，应重复此过程。
警告
用户定义的默认值会影响所有记录的创建。这意味着， 每个 新税都会设置为在指定的应纳税款账户中记录收入，除非手动编辑税务以指定不同的收入账户（或者另一个用户定义的默认值优先）。
要这样做，请转到 ，找到公司的 应交税 账户，并点击 设置。注意 URL 字符串中 id= 后面的数字；它是 应交税账户ID，稍后会用到。
激活 开发者模式，然后转到 并点击 创建。
点击 字段 下拉菜单，然后点击 搜索更多…。
使用搜索栏过滤 Tax Repartition Line 模型，并再次使用搜索栏过滤 Account 字段。在 Model 列下选择带有 Tax Repartition Line 的行。
一旦回到 User-defined Defaults 创建页面，输入之前记录的 Tax Payable account ID 到 Default Value (JSON format) 字段。
选择应用此配置的公司，在 公司 字段下选择并点击 保存。
自动检测财务位置¶
在Odoo中，销售税是根据 财务位置 计算的。启用TaxCloud时，将创建一个适用于美国的财务位置。
您可以配置Odoo自动检测应将财务位置应用于哪些客户。要这样做，请转到： ，然后选择 自动税务映射（TaxCloud）。启用 自动检测，然后 保存。
现在，如果客户的国家是 美国，那么这个财务位置会自动设置在任何订单或发票上。这会触发自动计算税费。
注解
要获取销售订单上的销售税，请确认订单或单击 更新税费 按钮，位于 添加运费 旁边。
与优惠券和促销活动的互动¶
如果您使用 优惠券 或 促销计划 ，与TaxCloud的集成可能会出现意外情况。实际上，由于TaxCloud不接受负金额作为税务计算的一部分，促销计划添加的行的金额必须从其影响的行的总额中扣除。
重要
这意味着，除了其他的复杂情况外，使用优惠券或促销活动并具有TaxCloud财务位置的订单 必须 完全开具发票 - 不能为部分交付等创建发票。
另一个可能的意外行为是可能的。例如，您销售一种产品，您有一个促销计划，提供50%的折扣。如果产品的税率是7%，从TaxCloud集成计算的税率显示为3.5%。这是因为折扣已包含在发送给TaxCloud的价格中。然而，在Odoo中，折扣完全是另一行。尽管如此，税务计算是正确的。事实上，对全价的3.5%税相当于对半价的7%税，但这可能会出乎用户的意料。
另请参阅