我们从头重构了 Shopify POS 的现金管理功能。新的 Admin GraphQL API 和 POS UI 扩展目标将现金管理数据和控件开放给应用开发者，使他们能够构建以前在 Shopify POS 上无法实现的自定义现金管理工作流。
新增功能
钱箱
CashDrawer 是一个新资源，它将现金管理与单个 POS 设备解耦。钱箱代表位于某地点的物理现金存储单元。多个设备可以连接到一个钱箱，从而实现灵活的门店设置。
| 资源 | 描述 |
|---|---|
| cashDrawers | 查询所有位置的抽屉，包括余额和活动。通过pointOfSaleDevices连接查询已连接的设备 |
| cashDrawerCreate | 在指定位置创建一个新的命名钱箱 |
| pointOfSaleDeviceAssignToCashDrawer | 将 POS 设备分配给钱箱，建立设备与钱箱之间的关系 |
支付会话
PointOfSaleDevicePaymentSession取代了CashTrackingSession成为现金会话的主要资源。支付会话代表收银抽屉处于活跃使用状态的时段，通常为一个班次或一个营业日，并记录从开启到关闭的所有现金流动情况
| 资源 | 描述 |
|---|---|
| pointOfSaleDevicePaymentSessions | 查询会话，支持按status、opening_time和closing_time进行筛选 |
| pointOfSaleDevicePaymentSessionOpen | 开启新的支付会话 |
| pointOfSaleDevicePaymentSessionClose | 关闭会话。API 将计算预期余额及差异 |
| pointOfSaleDevicePaymentSessionAdjust | 在活动会话期间记录现金调整 |
会话现在包含用于对账的财务汇总字段：totalCashSales、totalCashRefunds、netCashSales、totalAdjustments、totalDiscrepancy、totalSales、totalRefunds和netSales
原因代码
CashManagementCustomReasonCode 是一个新资源，允许商家对现金调整进行分类。Shopify 提供一组默认代码，商家还可以创建自定义代码以匹配其运营需求。
| 资源 | 说明 |
|---|---|
| cashManagementReasonCodeCreate | 创建自定义原因代码，包含人类可读的名称和机器可读的代码 |
| cashManagementReasonCodeDelete | 删除原因代码 |
POS UI 扩展
新的扩展目标和 API 使开发人员能够直接在 POS 现金管理界面上构建自定义体验：
| 资源 | 说明 |
|---|---|
| 收银机详情块和操作目标 | 在收银机屏幕上渲染自定义用户界面（适用于API版本2026-04） |
| Cash Drawer API | 一种新的平台 API，可通过 POS UI 扩展访问，用于与钱箱进行交互 |
| deviceId Session API 上的设备 ID | 扩展程序现在可以读取当前POS设备ID，以便通过管理API获取对应的PointOfSaleDevice数据 |
了解更多
- Cash Drawer API (POS UI extensions)
- POS UI 扩展目标