31 筆 (第 1 頁,共 2 頁)
2026-06-10 API OAuth 營業時間 Business Hours 特別營業日 可營業時間 排班 Android iOS
營業時間 API(Business Hours API)的使用方式

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

2026-06-01 API OAuth 營業額 KPI Analytics Android iOS averageTicket terminalId
營業額實績 API(Sales API)的使用方式

彙整 ReceiptRoller 營業額實績 API(/api/v1/sales/*)的概要,以及依商業帳戶、店鋪、POS 端末、期間的篩選方法。這是一份涵蓋實際回應結構(KpiValue 巢狀型)與 averageTicket、權杖有效期限(8 小時)在內,為在 Android/iOS 行動應用程式或伺服器串接實作營業額儀表板的入門指南。

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

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

2026-04-27 疑難排解 方案 開發者入口網站
方案仍為免費而不顯示開發者入口網站

ReceiptRoller 的開發者入口網站不顯示時的確認步驟。解說方案為免費時的因應方法、商業帳戶切換、顯示反映時機。

2026-04-27 SLA 稼動率 故障 狀態頁面
SLA、稼動率與故障時的確認步驟

解說 ReceiptRoller API 的稼動率目標、狀態頁面的確認方法、故障發生時的釐清步驟,以及支援升級的流程。

2026-06-21 API 商店應用程式 公告 頁面 營業資訊 shopId
商店應用程式 內容 API(公告、頁面、營業資訊)的使用方式

說明用於取得商店應用程式內容(公告、頁面、應用程式資訊清單、營業資訊、會員卡設定)的 /api/v1/apps/{shopId}/* 使用方式。解說 shopId 與商業帳戶 ID 相同、商業帳戶層級內容與店鋪層級內容的差異,以及驗證的處理方式。

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 請求 回應 JSON 分頁
請求與回應的基本(JSON)

解說 ReceiptRoller API 的請求格式、必要標頭、回應結構、分頁、篩選、日期時間格式的規則。

2026-06-01 API OAuth 商業帳戶 店鋪 POS Android iOS
取得商業帳戶、店鋪、POS 端末的一覽

彙整從行動應用程式/伺服器應用程式以 REST API 一覽使用者所屬商業帳戶、其底下的店鋪、各店鋪 POS 端末的步驟。

2026-06-01 API OAuth 商品管理 PIM CRUD Android iOS
商品管理 API(Products API)的使用方式

這是使用 ReceiptRoller 商品管理 API(/api/v1/products)對商業帳戶底下的商品進行 CRUD 操作的指南。適用於在 Android/iOS 應用程式或伺服器串接讀寫 PIM(商品主檔)時的入門文章。

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

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

2026-04-27 資料保護 匿名化 加密 隱私
資料保護(匿名化、加密)的思維

解說 ReceiptRoller 串接應用程式的資料保護思維、加密(保管時、通信時)、匿名化、假名化的技巧,以及刪除政策。

2026-04-27 應用程式登錄 利用目的 串接對象 類別 User系審查
利用目的、串接對象(POS/EC/分析等)的申告

解說在 ReceiptRoller 的開發者入口登錄應用程式時申告的「利用目的」與「串接對象類別」(POS/EC/分析/CRM/OMS/WMS/SNS/其他)的意義、選法、變更時的注意、與 User 系權限範圍審查的關聯。

2026-04-27 用戶端ID 密鑰 驗證 應用程式登錄
用戶端 ID、用戶端密鑰的管理

解說 ReceiptRoller 應用程式登錄時發行的用戶端 ID、用戶端密鑰的取得方法、保管規則、外洩時的因應、多環境運用。

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

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

2026-04-27 疑難排解 User系權限範圍 審查
User 系權限範圍回傳 app_not_approved

使用 User 系權限範圍時回傳 app_not_approved 錯誤時的確認步驟。解說在沙箱框架下的開發、審查申請、沙箱轉正式環境的流程。

2026-04-27 密鑰 輪替 安全性 金鑰管理
密鑰的輪替與安全的保管

解說為安全運用 ReceiptRoller 的用戶端密鑰、Webhook 密鑰的輪替計畫、新舊並行期間的使用方式、保管的最佳實務。

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

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

2026-04-24 ReceiptRoller 開發者 社群 回答 通知
接收提問的回答

說明所發問的提問收到回答時的電子郵件通知,與最佳解答設定的使用方法。

2026-04-27 疑難排解 權杖 驗證 OAuth
無法取得權杖(驗證錯誤)

無法取得存取權杖時的原因釐清。解說 invalid_client、invalid_grant、redirect_uri_mismatch 等代表性錯誤與因應。