PointOfSaleDevice 上新增了 fiscalDeviceIdentifier 字段

截至2026-10 GraphQL管理API版本，PointOfSaleDevice对象包含一个新fiscalDeviceIdentifier字段。该字段返回Shopify分配给POS设备的财政注册标识符（制造编号）。仅当您的应用支持线下财政合规工作流时，才需要采用此字段。

变更内容

GraphQL管理API中的PointOfSaleDevice对象现在包含一个可为空的fiscalDeviceIdentifier字段。它返回设备由Shopify分配的财政注册标识符，例如商家在瑞典税务局（Skatteverket）注册的瑞典制造编号（tillverkningsnummer）。详情请参阅PointOfSaleDevice参考。

该字段仅针对位于其财政法规要求向税务机关注册收银机的国家/地区的地点的设备返回值。瑞典是首个受支持的国家。对于所有其他设备，该字段返回null。

受影响对象

支持线下税务合规工作流的应用（例如在要求注册收银机的国家进行税务交易签名和账目报告）可以使用此字段。不涉及 POS 税务合规的应用不受影响，也无需采取任何操作。

操作步骤

1. 在 2026-10 GraphQL Admin API 版本中查询该字段：

   query { pointOfSaleDevice(id: "gid://shopify/PointOfSaleDevice/123") { fiscalDeviceIdentifier } }

   此查询返回设备的财政注册标识符；如果设备所在地点无需该标识符，则返回null。

2. 要识别您的POS UI扩展正在运行的设备，请使用session.deviceId（适用于2026-04及更高版本的POS UI扩展API），并使用该ID查询GraphQL管理API。

3. 将该值视为设备注册生命周期内的稳定值，并按设备进行缓存。

相关文档

• PointOfSaleDevice 参考文档
• POS UI Extensions Session API