税务 webhook 摘要和计算请求现在使用全局 ID

从 API 版本 2027-01 开始，第三方税务应用将在所有摘要部分的实体引用的税务计算请求和税务摘要 webhook 负载中收到全局 ID（GID）。这与合作伙伴与其他 Shopify API 的交互方式保持一致。

这些应用现在可以在所有 Shopify 端点中使用相同的标识符，而无需为特定于税务的集成管理不同的 ID 格式。

变更内容

此变更影响两个关键集成点：

税务计算请求：

• Customer、Company、CompanyLocation、Product 和 ProductVariant ID 现在使用 GID 格式。

税务摘要 Webhook：

• 摘要部分内的所有实体 ID（Order、Customer、Product、ProductVariant、SalesAgreement、Sale、LineItem、Company、CompanyLocation、ShippingLine 和 TaxLine）现在均使用 GID 格式。
• Webhook 负载还在顶层包含了用于 TaxSummary、Shop 和 Order 实体的新 admin_graphql_api_id 字段。

变更包括：

• 顶层：新增 shop_admin_graphql_api_id 和 order_admin_graphql_api_id 字段（现有的 shop_id 和 order_id 仍为整数）。
• 客户 ID：从 "id": "5" 更改为 "id": "gid://shopify/Customer/5"。
• 产品 ID：从 "id": "1" 更改为 "id": "gid://shopify/Product/1"。
• 产品变体 ID：从 "id": "1" 更改为 "id": "gid://shopify/ProductVariant/1"。
• 行项目 ID：从 "line_item_id": "5" 更改为 "line_item_id": "gid://shopify/LineItem/5"。
• 销售 ID：从 "id": "9" 更改为 "id": "gid://shopify/Sale/9"。
• 协议 ID：从 "id": "6" 更改为 "id": "gid://shopify/Agreement/6"。
• 公司 ID：从 "id": "3" 更改为 "id": "gid://shopify/Company/3"。
• 公司地点 ID：从 "id": "4" 更改为 "id": "gid://shopify/CompanyLocation/4"。
• 配送线路 ID：从 "id": "4" 更改为 "id": "gid://shopify/ShippingLine/4"。
• 税线 ID：从 "id": 6 更改为 "id": "gid://shopify/TaxLine/6"。

您需要执行的操作

更新您的集成以在 API 版本 2027-01 及更高版本中处理税务计算和 Webhook 负载时的 GID 格式。以下是一些示例：

税务计算请求

之前（2026-10 及更早版本）：

{ "cart": { "buyer_identity": { "customer": { "id": "593934299" } } } }

之后（2027-01）：

{ "cart": { "buyer_identity": { "customer": { "id": "gid://shopify/Customer/593934299" } } } }

税务摘要 Webhook

之前（2026-10 及更早版本）：

{ "id": 80, "shop_id": 1, "order_id": 64, "summary": { "agreements": [{ "id": "82", "sales": [{ "id": "106", "line_item_id": "76" }] }] } }

之后（202-01）：

{ "id": 80, "admin_graphql_api_id": "gid://shopify/TaxSummary/80", "shop_id": 1, "shop_admin_graphql_api_id": "gid://shopify/Shop/1", "order_id": 64, "order_admin_graphql_api_id": "gid://shopify/Order/64", "summary": { "agreements": [{ "id": "gid://shopify/SalesAgreement/82", "sales": [{ "id": "gid://shopify/Sale/106", "line_item_id": "gid://shopify/LineItem/76" }] }] } }