BusinessEntity 现在在 GraphQL Admin API 中暴露了 legalEntityId

截至 API 版本 2026-07，GraphQL Admin API 中的 BusinessEntity 类型包含一个新字段 legalEntityId。该字段返回 Shopify 组织平台中稳定的中央法律实体 ID，为合作伙伴提供跨多个商店、市场和销售渠道的同一法律实体的统一标识符。

更新内容

BusinessEntity 类型现在包括：

• legalEntityId（BigInt，可为空）：稳定的组织级法律实体标识符。此 ID 在所有属于同一法律实体的商店之间保持一致，使合作伙伴能够识别相同的底层公司，无论其运营多少商店或市场。

当业务实体没有支持的中央法律实体，或者该法律实体没有稳定的外部 ID 时，此字段将返回 null。

示例查询

query { businessEntity(id: "gid://shopify/BusinessEntity/123456") { id legalEntityId companyName displayName } }

示例响应

{ "data": { "businessEntity": { "id": "gid://shopify/BusinessEntity/123456", "legalEntityId": "223432432", "companyName": "Acme Corporation", "displayName": "Acme US" } } }

为何重要

以前，BusinessEntity.id 的作用域仅限于单个商店，这意味着运营多家商店的同一公司会显示不同的 ID。新的 legalEntityId 在组织级别提供了一个单一、稳定的标识符，合作伙伴可以将其用于：

• 将商家的法律实体映射到其自有系统中的公司代码
• 在多个店铺和市场中一致地识别同一家公司
• 在 GraphQL Admin API 与税务 webhook 有效负载（其中同一标识符显示为 merchant_business_entity.legal_entity_id）之间关联法律实体数据

API 版本

此字段从 API 版本 2026-07 及 unstable 开始可用。