開發者向幫助目次
ReceiptRoller 開發者向幫助目次。彙整了開發者申請、應用程式登錄、OAuth 驗證與權限範圍、實作指南（錢包應用程式、店鋪向 Webhook、Survey API）、依資料領域別指南、運用與安全性、社群、疑難排解。
資料保護（匿名化、加密）的思維
解說 ReceiptRoller 串接應用程式的資料保護思維、加密（保管時、通信時）、匿名化、假名化的技巧，以及刪除政策。
SNS Webhook 旁路（LINE 等外部 SNS 的 Webhook 轉發）
解說 ReceiptRoller 將從 LINE 等 SNS 平台接收到的 Webhook，在店鋪端同意下轉發至開發者應用程式的「SNS Webhook 旁路」功能的機制、設定方法、簽章的處理、注意事項。
庫存管理 API（Inventory / WMS API）的使用方式
ReceiptRoller 庫存管理 API（Inventory / WMS API）的實作指南。解說以據點（倉庫、店鋪後場、賣場）為單位的庫存查詢、調整、異動紀錄取得方法，必要的 OAuth 權限範圍，Shopify 串接時的自動反映，以及從 MCP 工具（wms_get_stock / wms_adjust_stock 等）的使用方式。
監視與失敗時的對應
解說 ReceiptRoller Webhook 的投放紀錄的檢視方式、應監視的指標與警報設計、無效信件的重新投放、常見故障模式與復原步驟。
員工管理 API（Staff API）的使用方式
這是使用 ReceiptRoller 員工管理 API（/api/v1/staff）對商業帳戶底下的員工（Staff）進行 CRUD 操作的指南。支援與 Square Team Member 互通的欄位（假名、多工作分配、薪資結構）。
商品主檔（PIM）、類別資料
解說 ReceiptRoller 的商品主檔（PIM）、類別、變體的資料結構、CRUD 操作、SKU 管理、與 EC 的同步模式。
API 參考與文件的閱讀方式
說明 ReceiptRoller 的開發者向文件的構成與分別使用。開發者幫助、API 頂頁、Swagger 基底的 API 參考、開發者社群的 4 個入口，以及可用於 AI 助手或程式碼生成工具的 OpenAPI 規格（openapi/v1.json）的取得方法。
預約管理 API（Reservations API）的使用方式
ReceiptRoller 預約管理 API（/api/v1/reservations）的指南。解說預約的 CRUD、狀態更新，預約框（時段）的取得、建立、整批產生，店鋪版面所登錄的座位（桌位、包廂、吧台）的取得，以及預約統計。
Webhook 的概要
解說 ReceiptRoller 的 Webhook 所投放的主要事件種類、應該使用 Webhook 而非輪詢的理由、投放形式（HTTPS POST + JSON）、投放保證的思考方式。
可利用的資料領域
以一覽說明可從 ReceiptRoller 的開發者入口取得的資料領域。彙整交易、商品、庫存、訂單、顧客、優惠券、SNS、廣告、個人使用者資料等，各領域含的內容與取得方法、必要的權限範圍。
ProductDto 參考
解說 ReceiptRoller 商品主檔（PIM）ProductDto 的所有欄位。彙整來自 POS（Square）的商品目錄同步，以及原價、各店鋪價格、變體、預購等結構。
User 系權限範圍回傳 app_not_approved
使用 User 系權限範圍時回傳 app_not_approved 錯誤時的確認步驟。解說在沙箱框架下的開發、審查申請、沙箱轉正式環境的流程。
營業時間 API（Business Hours API）的使用方式
ReceiptRoller 營業時間 API（/api/v1/stores/{storeId}/business-hours）的指南。解說每個星期的營業時間的取得與更新、特別營業日（臨時歇業、營業時間變更）的登錄、店鋪的可營業時間（排班建立時的上限業務時間）的設定，以及目前是否營業中的判定。
密鑰的輪替與安全的保管
解說為安全運用 ReceiptRoller 的用戶端密鑰、Webhook 密鑰的輪替計畫、新舊並行期間的使用方式、保管的最佳實務。
PosTransactionDto 規格 — 交易資料的欄位參考
解說 ReceiptRoller 處理的交易資料正規模型 PosTransactionDto 的所有欄位。依識別碼、日期時間、金額、明細、付款、員工、狀態、CRM 串接各類別，彙整欄位名稱、型別、意義，以及各 POS 供應商的填入方式，是給開發者與外部系統串接負責人的參考。Smaregi、Square 雙方的對應文章也會參照本文。