說明 | ReceiptRoller

ReceiptRoller 庫存管理 API（Inventory / WMS API）的實作指南。解說以據點（倉庫、店鋪後場、賣場）為單位的庫存查詢、調整、異動紀錄取得方法，必要的 OAuth 權限範圍，Shopify 串接時的自動反映，以及從 MCP 工具（wms_get_stock / wms_adjust_stock 等）的使用方式。

2026-04-27 Webhook 事件 API 即時串接

Webhook 的概要

解說 ReceiptRoller 的 Webhook 所投放的主要事件種類、應該使用 Webhook 而非輪詢的理由、投放形式（HTTPS POST + JSON）、投放保證的思考方式。

2026-06-03 API OAuth 員工管理員工 Staff CRUD Android iOS

員工管理 API（Staff API）的使用方式

這是使用 ReceiptRoller 員工管理 API（/api/v1/staff）對商業帳戶底下的員工（Staff）進行 CRUD 操作的指南。支援與 Square Team Member 互通的欄位（假名、多工作分配、薪資結構）。

2026-04-24 ReceiptRoller 開發者社群回答通知

接收提問的回答

說明所發問的提問收到回答時的電子郵件通知，與最佳解答設定的使用方法。

2026-06-20 API Store 店鋪資訊 OAuth

店鋪資訊 API（Store Information API）的使用方式

說明如何以 REST API 取得、更新店鋪的基本資訊（店鋪名稱、店鋪類別、聯絡方式、地址）。可從員工應用程式等以權杖驗證的用戶端實作店鋪資訊的編輯畫面。

2026-04-27 Webhook 登錄端點事件訂閱

Webhook 的登錄方法

解說在 ReceiptRoller 的開發者入口登錄 Webhook 端點的步驟、訂閱事件的選法、測試投放、多端點的分開運用、刪除與暫停的方法。

2026-06-21 API 商店應用程式公告頁面營業資訊 shopId

商店應用程式內容 API（公告、頁面、營業資訊）的使用方式

說明用於取得商店應用程式內容（公告、頁面、應用程式資訊清單、營業資訊、會員卡設定）的 /api/v1/apps/{shopId}/* 使用方式。解說 shopId 與商業帳戶 ID 相同、商業帳戶層級內容與店鋪層級內容的差異，以及驗證的處理方式。

2026-03-05 API OAuth Webhook 驗證權限範圍

開發者向幫助目次

ReceiptRoller 開發者向幫助目次。彙整了開發者申請、應用程式登錄、OAuth 驗證與權限範圍、實作指南（錢包應用程式、店鋪向 Webhook、Survey API）、依資料領域別指南、運用與安全性、社群、疑難排解。

2026-04-27 密鑰輪替安全性金鑰管理

密鑰的輪替與安全的保管

解說為安全運用 ReceiptRoller 的用戶端密鑰、Webhook 密鑰的輪替計畫、新舊並行期間的使用方式、保管的最佳實務。

2026-04-27 API 端點版本管理 URL結構

端點與版本管理

解說 ReceiptRoller API 的基底 URL、版本管理方針、廢止預告的流程、現行版本的確認方法。

2026-06-01 API OAuth 營業額 KPI Analytics Android iOS averageTicket terminalId

營業額實績 API（Sales API）的使用方式

彙整 ReceiptRoller 營業額實績 API（/api/v1/sales/*）的概要，以及依商業帳戶、店鋪、POS 端末、期間的篩選方法。這是一份涵蓋實際回應結構（KpiValue 巢狀型）與 averageTicket、權杖有效期限（8 小時）在內，為在 Android／iOS 行動應用程式或伺服器串接實作營業額儀表板的入門指南。