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

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

2026-04-27 商品 PIM 類別 SKU 資料串接
商品主檔(PIM)、類別資料

解說 ReceiptRoller 的商品主檔(PIM)、類別、變體的資料結構、CRUD 操作、SKU 管理、與 EC 的同步模式。

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-04-27 存取控制 稽核日誌 RBAC 最小權限
存取控制與稽核日誌

解說 ReceiptRoller 串接應用程式運用中,存取控制的設計、最小權限、稽核日誌的作法、定期審查的實施方法。

2026-04-27 庫存 WMS 倉庫 資料串接
庫存資料串接

解說 ReceiptRoller 的庫存資料的結構、多倉庫管理、入出庫紀錄、透過 Webhook 的即時同步、WMS 串接模式。

2026-04-27 存取權杖 刷新權杖 OAuth 有效期限
存取權杖的取得與更新

解說 ReceiptRoller API 使用的存取權杖與刷新權杖的取得方法、有效期限、更新步驟、錯誤時的因應。

2026-04-27 API 請求 回應 JSON 分頁
請求與回應的基本(JSON)

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

2026-04-09 oauth api receipt webhook ios android line
錢包應用程式向:以 OAuth 取得使用者的收據的指南

解說從 iOS、Android、LINE Mini App 等錢包型應用程式,在使用者同意下取得 ReceiptRoller 的購買收據的方法。涵蓋 OAuth 2.0 驗證、收據 API、Webhook 串接。

2026-04-27 Webhook SNS LINE 旁路 轉發 事件串接
SNS Webhook 旁路(LINE 等外部 SNS 的 Webhook 轉發)

解說 ReceiptRoller 將從 LINE 等 SNS 平台接收到的 Webhook,在店鋪端同意下轉發至開發者應用程式的「SNS Webhook 旁路」功能的機制、設定方法、簽章的處理、注意事項。

2026-05-29 PIM 商品 資料模型 參考 POS串接
ProductDto 參考

解說 ReceiptRoller 商品主檔(PIM)ProductDto 的所有欄位。彙整來自 POS(Square)的商品目錄同步,以及原價、各店鋪價格、變體、預購等結構。

2026-04-27 User系權限範圍 審查 隱私權 個人資訊 應用程式登錄
User 系權限範圍的審查申請

解說在 ReceiptRoller 處理一般消費者資料(user.* 權限範圍)的應用程式所需的審查申請流程、提交文件、審查基準、審查期間、常見退件理由。

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

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

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

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

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

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