庫存管理 API（Inventory / WMS API）的使用方式
ReceiptRoller 庫存管理 API（Inventory / WMS API）的實作指南。解說以據點（倉庫、店鋪後場、賣場）為單位的庫存查詢、調整、異動紀錄取得方法，必要的 OAuth 權限範圍，Shopify 串接時的自動反映，以及從 MCP 工具（wms_get_stock / wms_adjust_stock 等）的使用方式。
可利用的資料領域
以一覽說明可從 ReceiptRoller 的開發者入口取得的資料領域。彙整交易、商品、庫存、訂單、顧客、優惠券、SNS、廣告、個人使用者資料等，各領域含的內容與取得方法、必要的權限範圍。
開發者入口可做的事
概觀 ReceiptRoller 的開發者入口可做的事。組合 REST API 的資料取得、操作與 Webhook 的即時事件接收，可從外部系統串接店鋪、使用者資料。
原生行動應用程式指南：多商業帳戶存取與 OAuth 流程
Android / iOS 原生應用程式的實作指南。應用程式登錄時將「授權時將權杖關聯至 1 個商業帳戶」關閉，即會發行 user-scoped OAuth 權杖。以 /api/v1/me/organizations ＋ ?organizationId= 模式即可跨多個商業帳戶存取。
Webhook 的概要
解說 ReceiptRoller 的 Webhook 所投放的主要事件種類、應該使用 Webhook 而非輪詢的理由、投放形式（HTTPS POST + JSON）、投放保證的思考方式。
開發者向幫助目次
ReceiptRoller 開發者向幫助目次。彙整了開發者申請、應用程式登錄、OAuth 驗證與權限範圍、實作指南（錢包應用程式、店鋪向 Webhook、Survey API）、依資料領域別指南、運用與安全性、社群、疑難排解。
代表性的 API 範例
以 curl 命令介紹 ReceiptRoller API 代表性端點的呼叫範例（收據取得、店鋪一覽、商品建立、Webhook 登錄）。
無法取得權杖（驗證錯誤）
無法取得存取權杖時的原因釐清。解說 invalid_client、invalid_grant、redirect_uri_mismatch 等代表性錯誤與因應。
OAuth 權限範圍一覽與利用可否
說明 ReceiptRoller 的 OAuth API 可利用的權限範圍的一覽，與各權限範圍被授予哪種類型的應用程式。也涵蓋 User 系權限範圍的審查要件、Store 系與 User 系無法混在的理由、從 LIFF 應用程式的利用方法。
Webhook 的登錄方法
解說在 ReceiptRoller 的開發者入口登錄 Webhook 端點的步驟、訂閱事件的選法、測試投放、多端點的分開運用、刪除與暫停的方法。
資料保護（匿名化、加密）的思維
解說 ReceiptRoller 串接應用程式的資料保護思維、加密（保管時、通信時）、匿名化、假名化的技巧，以及刪除政策。
商品主檔（PIM）、類別資料
解說 ReceiptRoller 的商品主檔（PIM）、類別、變體的資料結構、CRUD 操作、SKU 管理、與 EC 的同步模式。
重送、順序、冪等性的設計
解說 ReceiptRoller Webhook 的重送政策、投放順序不保證的理由、使用 event_id 的冪等性實作、無效信件的處理、常見反模式。
用戶端 ID、用戶端密鑰的管理
解說 ReceiptRoller 應用程式登錄時發行的用戶端 ID、用戶端密鑰的取得方法、保管規則、外洩時的因應、多環境運用。
ProductDto 參考
解說 ReceiptRoller 商品主檔（PIM）ProductDto 的所有欄位。彙整來自 POS（Square）的商品目錄同步，以及原價、各店鋪價格、變體、預購等結構。
回傳 403/401（權限、權限範圍）
API 呼叫回傳 401 或 403 時的原因釐清。解說權杖無效、權限範圍不足、無店鋪存取權、User 系審查未通過等典型情況。