截至API版本2026-04,发送给税务合作伙伴应用的tax_summaries/create webhook包含商户业务实体信息。这标识了负责税务摘要所代表交易的业务实体。
更新内容
税务webhook有效载荷现在在税务摘要的根级别包含一个新的merchant_business_entity字段。该字段包括以下详细信息:
- id:业务实体的全局 ID,格式为 gid://shopify/BusinessEntity/{id}
- company_name:业务实体的法定名称
- display_name:业务实体的显示名称
- address:业务实体的地址,包括:国家/地区、省份、地址行(address1、address2)、城市、邮政编码、公司名称
- country
- province
- 地址行(address1、address2)
- city
- zip
- company
仅当商户为商店配置了业务实体时,该字段才会存在。
2026-04 之前的版本
{ "summary": { "idempotent_key": "abc123", "shop": { "...": "..." }, "order_details": { "...": "..." } } }
2026-04 及更高版本
{ "summary": { "idempotent_key": "abc123", "shop": { "...": "..." }, "order_details": { "...": "..." }, "merchant_business_entity": { "id": "gid://shopify/BusinessEntity/12345", "company_name": "Acme Corporation", "display_name": "Acme Corp", "address": { "country": "CA", "province": "ON", "address1": "123 Main St", "address2": null, "city": "Toronto", "zip": "M5V 2T6", "company": "Acme Corporation" } } } }