12 筆
2026-04-27 api data scope getting-started overview
可利用的資料領域

以一覽說明可從 ReceiptRoller 的開發者入口取得的資料領域。彙整交易、商品、庫存、訂單、顧客、優惠券、SNS、廣告、個人使用者資料等,各領域含的內容與取得方法、必要的權限範圍。

2026-04-27 收據 購買 資料串接 API
購買、收據資料串接

解說 ReceiptRoller 處理的購買、收據資料的結構、取得方法、相關權限範圍、Webhook、常見使用情境。

2026-05-26 OAuth Android iOS 行動 API 多商業帳戶 PKCE
原生行動應用程式指南:多商業帳戶存取與 OAuth 流程

Android / iOS 原生應用程式的實作指南。應用程式登錄時將「授權時將權杖關聯至 1 個商業帳戶」關閉,即會發行 user-scoped OAuth 權杖。以 /api/v1/me/organizations + ?organizationId= 模式即可跨多個商業帳戶存取。

2026-04-27 API 錯誤碼 重試 HTTP狀態
錯誤碼與重試指引

解說 ReceiptRoller API 回傳的 HTTP 狀態碼與錯誤碼的一覽、應重試的情況、重試間隔的指引。

2026-04-27 帳票 請款 會計 發票
帳票、請款相關資料(對應範圍)

解說 ReceiptRoller 處理的帳票、請款相關資料的對應範圍、稅率報表、發票制度對應、會計軟體串接的指針。

2026-04-27 Webhook 監視 警報 無效信件 故障對應
監視與失敗時的對應

解說 ReceiptRoller Webhook 的投放紀錄的檢視方式、應監視的指標與警報設計、無效信件的重新投放、常見故障模式與復原步驟。

2026-04-27 疑難排解 403 401 權限 權限範圍
回傳 403/401(權限、權限範圍)

API 呼叫回傳 401 或 403 時的原因釐清。解說權杖無效、權限範圍不足、無店鋪存取權、User 系審查未通過等典型情況。

2026-06-03 API Display 媒體 Android 數位看板 配對 零售媒體 曝光
店內媒體顯示器 API(Display API)的使用方式

ReceiptRoller 店內 Android 顯示器 API(/api/v1/displays/*)的概要,以及配對、心跳、播放清單取得、播放實績回報的步驟彙整。這是為在 Android 電子看板或店內數位看板端末播放媒體循環而實作應用程式的入門指南。

2026-06-01 API OAuth 交易 Transactions POS OMS Android iOS
交易一覽 API(Transactions API:POS+OMS 整合摘要)的使用方式

ReceiptRoller 的 Transactions API 是將收銀營業額(PosTransactions)與銷售管理訂單(OmsOrders)整合為單一摘要的唯讀 API。在 Android/iOS 應用程式中一覽顯示「整個商業帳戶的交易」時,即為入口。

2026-04-27 api reference swagger openapi community
API 參考與文件的閱讀方式

說明 ReceiptRoller 的開發者向文件的構成與分別使用。開發者幫助、API 頂頁、Swagger 基底的 API 參考、開發者社群的 4 個入口,以及可用於 AI 助手或程式碼生成工具的 OpenAPI 規格(openapi/v1.json)的取得方法。

2026-05-29 PosTransactionDto 交易資料 綱要 參考 API Smaregi Square POS串接
PosTransactionDto 規格 — 交易資料的欄位參考

解說 ReceiptRoller 處理的交易資料正規模型 PosTransactionDto 的所有欄位。依識別碼、日期時間、金額、明細、付款、員工、狀態、CRM 串接各類別,彙整欄位名稱、型別、意義,以及各 POS 供應商的填入方式,是給開發者與外部系統串接負責人的參考。Smaregi、Square 雙方的對應文章也會參照本文。

2026-06-10 API OAuth 營業時間 Business Hours 特別營業日 可營業時間 排班 Android iOS
營業時間 API(Business Hours API)的使用方式

ReceiptRoller 營業時間 API(/api/v1/stores/{storeId}/business-hours)的指南。解說每個星期的營業時間的取得與更新、特別營業日(臨時歇業、營業時間變更)的登錄、店鋪的可營業時間(排班建立時的上限業務時間)的設定,以及目前是否營業中的判定。