TaxCloud集成¶
TaxCloud实时计算美国各州、城市和特别管辖区的销售税率，跟踪免征销售税的产品和免税政策适用的州。
TaxCloud登记¶
在`TaxCloud.com <https://taxcloud.com/register>`_中登记科目，并完成设置。启用后，点击 店铺，转到 TaxCloud API密钥，然后:guilabel:获取详情。
启用TaxCloud¶
转到 ，在 税项`部分，启用:guilabel:`TaxCloud。
在 API ID`下添加店铺的 :guilabel:`登录ID，在 API密钥`下添加店铺的 :guilabel:`密钥，然后，点击 保存。
点击 默认类别`旁的 :guilabel:`刷新`按钮（:guilabel:`🗘），以从TaxCloud导入TIC :dfn:`纳税信息代码`产品品类。某些类别可能有特定税率或享受免税。
选择:guilabel:
默认类别，并:guilabel:保存。您的产品或产品品类未设置 TaxCloud类别`时，或订单/开票中无产品时，使用:guilabel:`默认类别。
设置产品的TaxCloud类别¶
如果您需要使用多个TIC类别（即:guilabel:默认类别），转到产品的 一般信息`选项卡，选择:guilabel:`TaxCloud类别。
如果要同时配置多个产品，请确保它们的 产品品类`相同，点击外部链接按钮（:guilabel:`🡕）， 在 产品品类`中设置 :guilabel:`TaxCloud 类别。
注解
如果为某个产品上设置了:guilabel:TaxCloud 类别，同时在 产品品类`中设置了不同类别，则Odoo仅考虑产品的 :guilabel:`TaxCloud 类别。
在**母产品品类**中设置的 TaxCloud类别`不适用于**子产品品类**。例如，如果为*所有*:guilabel:`产品品类`设置了:guilabel:`TaxCloud类别，该类别不适用于*所有/销售*:guilabel:产品品类。
重要
确保您的公司地址完整，包括州和邮编。转到 ，打开并编辑公司地址。
为正确应纳税科目自动过账税费¶
要确保TaxCloud集成后生成的新税项基于正确的**应付税项**科目，应创建**用户定义的默认值**。您所有使用TaxCloud的公司均应完成该过程。
警告
用户定义的默认值会影响所有记录。这意味着，**所有**新税项会被设置为在指定的应付税项科目中记录收入，除非手动编辑税项，以指定其他收入科目（或优先选择用户定义的另一个默认值）。
转到 ，找到您公司的 应付税项`科目，点击 :guilabel:`设置。请注意URL字符串中`id=`后的数字，这是**应付税项科目ID**，用于之后操作。
激活 developer mode，然后转到 ，点击 创建。
点击 字段`下拉菜单，然后点击 :guilabel:`搜索更多…。
使用搜索栏筛选:guilabel:`税项重新划分行`模块，然后筛选:guilabel:`科目`字段。在 :guilabel:`模式`列下选择带有:guilabel:`税项重新划分行`的行。
返回到:guilabel:`用户定义默认值`创建后，在 :guilabel:`默认值（JSON格式）`字段输入之前记录的**应付税项科目ID**。
在 公司`字段下选择要使用此配置的公司，然后点击 :guilabel:`保存。
自动检测财政状况¶
在Odoo中，根据:doc:`fiscal positions <fiscal_positions>`计算销售税。启用TaxCloud时，创建美国财政状况。
您可以将Odoo配置为自动检测财政状况适用的客户。转到 ，选择:guilabel:自动税项映射（TaxCloud）。启用:guilabel:自动检测，然后点击 保存。
如果客户所在国家/地区为*美国*，在任何订单或开票中将自动设置该财政状况，以触发税费自动计算。
优惠券和促销互动¶
如果您使用**优惠券**或**促销计划**，TaxCloud集成可能出现意外情况。事实上，鉴于TaxCloud税费计算不接受负数金额行，因此，因促销计划而添加的行的金额须从受其影响的行的总额中扣除。
重要
这意味着，除其他复杂过程外，使用TaxCloud财政状况下的优惠券或促销活动的订单**须**开具完整开票，无法为部分交货等情况开具开票。
还有另一种意外情况。例如，您根据5折促销计划销售了某产品，如果产品的税率为7%，TaxCloud集成后计算的税率显示为3.5%，因为折扣包含在发送给TaxCloud的价格中。然而，在Odoo中，折扣处理情况完全不同，但税率计算结果是正确的。事实上，对全价征收3.5%的税，就相当于对半价征收7%的税，但从用户角度来看，这可能令人不解。
