API 參考與文件的閱讀方式
說明 ReceiptRoller 的開發者向文件的構成與分別使用。開發者幫助、API 頂頁、Swagger 基底的 API 參考、開發者社群的 4 個入口，以及可用於 AI 助手或程式碼生成工具的 OpenAPI 規格（openapi/v1.json）的取得方法。
StaffDto 參考
解說 ReceiptRoller 員工（Staff）主檔 StaffDto 的所有欄位。彙整與 POS（Square Team / Smaregi）的關聯、店鋪指派、雇用型態等結構。
ProductDto 參考
解說 ReceiptRoller 商品主檔（PIM）ProductDto 的所有欄位。彙整來自 POS（Square）的商品目錄同步，以及原價、各店鋪價格、變體、預購等結構。
CrmCustomerDto 參考
解說 ReceiptRoller 顧客主檔 CrmCustomerDto 的所有欄位。從 POS（Smaregi、Square）匯入的顧客資訊會正規化為此模型。
PosTransactionDto 規格 — 交易資料的欄位參考
解說 ReceiptRoller 處理的交易資料正規模型 PosTransactionDto 的所有欄位。依識別碼、日期時間、金額、明細、付款、員工、狀態、CRM 串接各類別，彙整欄位名稱、型別、意義，以及各 POS 供應商的填入方式，是給開發者與外部系統串接負責人的參考。Smaregi、Square 雙方的對應文章也會參照本文。
OAuth 權限範圍一覽與利用可否
說明 ReceiptRoller 的 OAuth API 可利用的權限範圍的一覽，與各權限範圍被授予哪種類型的應用程式。也涵蓋 User 系權限範圍的審查要件、Store 系與 User 系無法混在的理由、從 LIFF 應用程式的利用方法。
代表性的 API 範例
以 curl 命令介紹 ReceiptRoller API 代表性端點的呼叫範例（收據取得、店鋪一覽、商品建立、Webhook 登錄）。
開發者向幫助目次
ReceiptRoller 開發者向幫助目次。彙整了開發者申請、應用程式登錄、OAuth 驗證與權限範圍、實作指南（錢包應用程式、店鋪向 Webhook、Survey API）、依資料領域別指南、運用與安全性、社群、疑難排解。
利用開始為止的流程
說明 ReceiptRoller 的開發者入口利用開始為止的流程。作為店鋪使用者登錄，只要是 Starter 方案以上，無需另行的開發者申請即可立刻開始應用程式登錄與 API 實作。
回傳 403/401（權限、權限範圍）
API 呼叫回傳 401 或 403 時的原因釐清。解說權杖無效、權限範圍不足、無店鋪存取權、User 系審查未通過等典型情況。
什麼是應用程式登錄
說明 ReceiptRoller 的應用程式登錄的概念。透過將應用程式登錄為 OAuth 用戶端，會發行用戶端 ID、密鑰、重新導向 URI，可開始 API、Webhook 串接。
交易一覽 API（Transactions API：POS＋OMS 整合摘要）的使用方式
ReceiptRoller 的 Transactions API 是將收銀營業額（PosTransactions）與銷售管理訂單（OmsOrders）整合為單一摘要的唯讀 API。在 Android／iOS 應用程式中一覽顯示「整個商業帳戶的交易」時，即為入口。
開發者入口可做的事
概觀 ReceiptRoller 的開發者入口可做的事。組合 REST API 的資料取得、操作與 Webhook 的即時事件接收，可從外部系統串接店鋪、使用者資料。
原生行動應用程式指南：多商業帳戶存取與 OAuth 流程
Android / iOS 原生應用程式的實作指南。應用程式登錄時將「授權時將權杖關聯至 1 個商業帳戶」關閉，即會發行 user-scoped OAuth 權杖。以 /api/v1/me/organizations ＋ ?organizationId= 模式即可跨多個商業帳戶存取。
可利用的資料領域
以一覽說明可從 ReceiptRoller 的開發者入口取得的資料領域。彙整交易、商品、庫存、訂單、顧客、優惠券、SNS、廣告、個人使用者資料等，各領域含的內容與取得方法、必要的權限範圍。
新增建立應用程式
說明在 ReceiptRoller 的開發者入口登錄新的應用程式（OAuth 用戶端）的具體步驟。涵蓋輸入項目、驗證、建立後的憑證顯示、常見錯誤。