AvaTax 使用

AvaTax 是一款税务计算软件，可在美国和加拿大与 Odoo 集成。完成
integration setup <../avatax>
后，税额计算变得简单且自动化。

在销售流程中确认报价单或发票时，AvaTax 会自动计算税额。也可以在草稿状态下点击
Compute Taxes 按钮手动计算税额。

:::: tip ::: title 提示 :::

点击 Compute Taxes 按钮会在发票的产品行被修改后重新计算税额。 ::::

{.align-center}

税务计算会在以下 自动触发 与 手动触发 场景中触发。

  • 销售代表使用 Send by email 按钮（弹窗）通过邮件发送报价单时。
  • 客户在门户网站查看在线报价单时。
  • 报价单被确认并转为销售订单时。
  • 客户在门户网站查看发票时。
  • 草稿发票被验证时。
  • 客户在门户网站查看订阅时。
  • 订阅生成发票时。
  • 客户在电商结算的最后一步页面时。
  • 报价单底部的 Compute Taxes 按钮。
  • 发票顶部的 Compute Taxes 按钮。

使用这些按钮可手动重新计算销售税。

:::: tip ::: title 提示 :::

在客户记录、报价单和发票中都有 Avalara Partner Code 字段，用于在 Odoo 与 AvaTax 之间交叉引用数据。该字段位于销售订单或报价单的 Sales 区块下的 Other info 标签页。

在客户记录中，进入 Contacts 应用并选择联系人，然后打开 Sales & Purchase 标签页，在 Sales 区块下找到 Avalara Partner Code。 ::::

:::: important ::: title 重要 :::

Automatic Tax Mapping (AvaTax) 财政位置同样适用于这些 Odoo 文档（如订阅）。 ::::

::: seealso

  • ../fiscal_positions :::

当 invoice（发票）在 Odoo 中创建时，会与 AvaTax 同步，这意味着销售税已在 Avalara（AvaTax 开发商）中记录。

操作步骤：

  1. 进入 Sales app --> Orders --> Quotations，从列表中选择一张报价单。
  2. 确认报价单并验证交付后，点击 Create Invoice。选择 Regular invoice、Down payment (percentage) 或 Down payment (fixed amount)。
  3. 点击 Create and view invoice。税额记录可在发票的 Journal Items 标签页查看，税种会根据 Delivery Address（送货地址）不同而变化。

{.align-center}

最后，点击 Confirm 按钮完成发票并与 AvaTax 门户同步。

:::: warning ::: title 警告 :::

发票不能 Reset to draft（重置为草稿），因为这会导致与 AvaTax 门户的不同步。请改为点击 Add credit note 并注明 [Sync with AvaTax Portal]。参考文档：../../../accounting/customer_invoices/credit_notes。 ::::

在客户发票上点击 Add a line，添加折扣产品并将 Price 设置为正数或负数，即可为重要客户提供固定价格折扣。完成后点击 Compute Taxes 重新计算税额。

:::: tip ::: title 提示 :::

即使在负数小计或信用票据上，也可以进行税额计算。 ::::

可以在 Odoo 中记录 Avalara/AvaTax 的操作，以便后续分析或功能验证。日志功能位于 AvaTax 设置中。

开启日志步骤：

  1. 进入 Accounting app --> Configuration --> Settings。
  2. 在 Taxes 区块的 AvaTax 设置中，点击 Start logging for 30 minutes。

启动后，Odoo 会在数据库中记录所有 Avalara/AvaTax 的操作。要查看日志，点击 Start logging for 30 minutes 右侧的 Show logs，即可看到包含以下列的详细列表：

  • Created on：计算时间戳。
  • Created by：数据库中用户的数值 ID。
  • Database name：数据库名称。
  • Type：Server 或 Client。
  • Name：Avalara 服务名称，此处为 AvaTax。
  • Level：默认 [INFO]。
  • Path：计算路径。
  • Line：计算所在的行。
  • Function：行对应的函数。

{.align-center}

点击日志行可展开 Message 字段，显示事务的原始转录，包括使用 Avalara AvaTax API 创建（或调整）销售发票的全部细节，如发货与收货地址、产品/服务行项、税码、税额等。

Message 中还包含不同司法管辖区的税额计算结果，确认事务已创建或调整。

:::: tip ::: title 提示 :::

可以使用 Odoo Studio 创建自定义字段。点击表头最右侧的 fa-ellipsis-v（省略号）菜单，再选择 fa-plus（添加）以打开 Odoo Studio。 ::::

:::: important ::: title 重要 :::

Odoo Studio 需要 自定义 定价方案。请联系数据库的客户成功经理了解更换方案的细节，或确认当前方案是否已包含 Studio。参考文档：../../../../studio。 ::::

::: seealso