開發者向幫助目次
ReceiptRoller 開發者向幫助目次。彙整了開發者申請、應用程式登錄、OAuth 驗證與權限範圍、實作指南（錢包應用程式、店鋪向 Webhook、Survey API）、依資料領域別指南、運用與安全性、社群、疑難排解。
銷售管理 API（Orders / OMS API）的使用方式
這是使用 ReceiptRoller 銷售管理 API（/api/v1/orders）對商業帳戶底下的訂單進行 CRUD 操作的指南。彙整訂單的建立、更新、狀態轉移（確認、處理中、取消）、刪除，以及適用於 Android／iOS 應用程式或伺服器串接的流程。
庫存管理 API（Inventory / WMS API）的使用方式
ReceiptRoller 庫存管理 API（Inventory / WMS API）的實作指南。解說以據點（倉庫、店鋪後場、賣場）為單位的庫存查詢、調整、異動紀錄取得方法，必要的 OAuth 權限範圍，Shopify 串接時的自動反映，以及從 MCP 工具（wms_get_stock / wms_adjust_stock 等）的使用方式。
Webhook 的概要
解說 ReceiptRoller 的 Webhook 所投放的主要事件種類、應該使用 Webhook 而非輪詢的理由、投放形式（HTTPS POST + JSON）、投放保證的思考方式。
店內媒體顯示器 API（Display API）的使用方式
ReceiptRoller 店內 Android 顯示器 API（/api/v1/displays/*）的概要，以及配對、心跳、播放清單取得、播放實績回報的步驟彙整。這是為在 Android 電子看板或店內數位看板端末播放媒體循環而實作應用程式的入門指南。
監視與失敗時的對應
解說 ReceiptRoller Webhook 的投放紀錄的檢視方式、應監視的指標與警報設計、無效信件的重新投放、常見故障模式與復原步驟。
Webhook 的登錄方法
解說在 ReceiptRoller 的開發者入口登錄 Webhook 端點的步驟、訂閱事件的選法、測試投放、多端點的分開運用、刪除與暫停的方法。
取得商業帳戶、店鋪、POS 端末的一覽
彙整從行動應用程式／伺服器應用程式以 REST API 一覽使用者所屬商業帳戶、其底下的店鋪、各店鋪 POS 端末的步驟。
交易一覽 API（Transactions API：POS＋OMS 整合摘要）的使用方式
ReceiptRoller 的 Transactions API 是將收銀營業額（PosTransactions）與銷售管理訂單（OmsOrders）整合為單一摘要的唯讀 API。在 Android／iOS 應用程式中一覽顯示「整個商業帳戶的交易」時，即為入口。
營業額實績 API（Sales API）的使用方式
彙整 ReceiptRoller 營業額實績 API（/api/v1/sales/*）的概要，以及依商業帳戶、店鋪、POS 端末、期間的篩選方法。這是一份涵蓋實際回應結構（KpiValue 巢狀型）與 averageTicket、權杖有效期限（8 小時）在內，為在 Android／iOS 行動應用程式或伺服器串接實作營業額儀表板的入門指南。
OAuth 權限範圍一覽與利用可否
說明 ReceiptRoller 的 OAuth API 可利用的權限範圍的一覽，與各權限範圍被授予哪種類型的應用程式。也涵蓋 User 系權限範圍的審查要件、Store 系與 User 系無法混在的理由、從 LIFF 應用程式的利用方法。
預約管理 API（Reservations API）的使用方式
ReceiptRoller 預約管理 API（/api/v1/reservations）的指南。解說預約的 CRUD、狀態更新，預約框（時段）的取得、建立、整批產生，店鋪版面所登錄的座位（桌位、包廂、吧台）的取得，以及預約統計。
重送、順序、冪等性的設計
解說 ReceiptRoller Webhook 的重送政策、投放順序不保證的理由、使用 event_id 的冪等性實作、無效信件的處理、常見反模式。
員工管理 API（Staff API）的使用方式
這是使用 ReceiptRoller 員工管理 API（/api/v1/staff）對商業帳戶底下的員工（Staff）進行 CRUD 操作的指南。支援與 Square Team Member 互通的欄位（假名、多工作分配、薪資結構）。
StaffDto 參考
解說 ReceiptRoller 員工（Staff）主檔 StaffDto 的所有欄位。彙整與 POS（Square Team / Smaregi）的關聯、店鋪指派、雇用型態等結構。
簽章驗證與安全性
解說 ReceiptRoller Webhook 的 HMAC-SHA256 簽章驗證的機制、驗證程式碼的範例（Node.js / Python / C#）、重放攻擊對策、密鑰的安全管理方法。
可利用的資料領域
以一覽說明可從 ReceiptRoller 的開發者入口取得的資料領域。彙整交易、商品、庫存、訂單、顧客、優惠券、SNS、廣告、個人使用者資料等，各領域含的內容與取得方法、必要的權限範圍。
商品主檔（PIM）、類別資料
解說 ReceiptRoller 的商品主檔（PIM）、類別、變體的資料結構、CRUD 操作、SKU 管理、與 EC 的同步模式。
CrmCustomerDto 參考
解說 ReceiptRoller 顧客主檔 CrmCustomerDto 的所有欄位。從 POS（Smaregi、Square）匯入的顧客資訊會正規化為此模型。