截至 API 版本 2026-01,tax_summaries/create Webhook 和税务合作伙伴应用的税务计算请求包含用于货币的附加字段。这些字段同时提供以商店货币和展示货币计价的金额。此增强功能允许税务合作伙伴在保持面向客户的显示货币的同时,使用商户的会计货币进行计算和报告。
更新内容
Webhook 和税务计算请求负载现在在以下位置包含新的 MoneyBag 字段,分别以商店货币和展示货币计价:
销售记录(agreements[].sales[]):
- discount_amount_set
- tax_amount_set
- amount_before_taxes_after_discounts_set
- amount_after_taxes_after_discounts_set
购物车行成本(delivery_groups[].cart_lines[].cost):
- amount_per_quantity_set
- subtotal_amount_set
- total_amount_set
这些字段与现有的单一货币金额字段互补,在商店启用多货币功能后可用。
MoneyBag 结构
新的 MoneyBag 字段包含两个 MoneyV2。以下是结构示例:
之前(2025年10月及更早版本):
{ "amount_before_taxes_after_discounts": { "currency_code": "CAD", "amount": "135.00" } }之后(2026年1月):
{ "amount_before_taxes_after_discounts": { "currency_code": "CAD", "amount": "135.00" }, "amount_before_taxes_after_discounts_set": { "shop_money": { "currency_code": "USD", "amount": "100.00" }, "presentment_money": { "currency_code": "CAD", "amount": "135.00" } } }
