税务汇总 Webhook 和计算请求现在包含客户和公司元字段

截至 API 版本 2026-04，税务合作伙伴应用的税务计算请求现在包含买家元字段（metafields）。这些字段提供了与客户（针对 D2C 订单）和公司（针对 B2B 订单）相关的自定义数据，可能会影响税务计算。此增强功能使税务合作伙伴能够访问商家定义的买家属性，从而实现更准确的税务确定和合规报告。

更新内容

税务计算请求负载的买家身份部分现在包含新的metafields数组：

1. 客户元字段（cart.buyer_identity.customer.metafields[]）：

   • 适用于 D2C 订单
   • 包含商家为个人客户定义的自定义属性
   • 示例包括处方状态、免税证书和客户分类

2. 公司元字段（cart.buyer_identity.purchasing_company.company.metafields[]）：

   • 适用于 B2B 订单
   • 包含商家为企业客户定义的自定义属性
   • 示例包括批发状态、转售证书和企业分类

元字段结构

每个元字段包含命名空间、键、类型和值的信息。以下示例展示了更新前后的结构：

客户元字段

更新前（2026-01 及更早版本）：

{ "customer": { "id": "123", "exemptions": [] } }

更新后（2026-01）：

{ "customer": { "id": "123", "exemptions": [], "metafields": [ { "namespace": "custom", "key": "has_prescription", "type": "boolean", "value": "true" } ] } }

公司元字段

更新前（2026-01 及更早版本）：

{ "purchasing_company": { "company": { "id": "456", "external_id": "ACME-001" }, "company_location": { "id": "789", "external_id": "ACME-LOCATION-001" } } }

更新后（2026-04）：

{ "purchasing_company": { "company": { "id": "456", "external_id": "ACME-001", "metafields": [ { "namespace": "custom", "key": "customer_class", "type": "single_line_text_field", "value": "wholesale" } ] }, "company_location": { "id": "789", "external_id": "ACME-LOCATION-001" } } }