23 筆 (第 1 頁,共 2 頁)
2026-05-29 CRM 顧客 資料模型 參考 POS串接
CrmCustomerDto 參考

解說 ReceiptRoller 顧客主檔 CrmCustomerDto 的所有欄位。從 POS(Smaregi、Square)匯入的顧客資訊會正規化為此模型。

2026-04-14 developer webhook receipt api integration
店鋪向:以自家應用程式發行數位收據、以 Webhook 通知的指南

解說店鋪、品牌以自家應用程式向顧客發行數位收據,到以 Webhook 接收即時通知為止的步驟。涵蓋應用程式登錄、OAuth、Webhook 設定、簽章驗證。

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

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

2026-04-27 存取控制 稽核日誌 RBAC 最小權限
存取控制與稽核日誌

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

2026-05-29 員工 從業人員 資料模型 參考 POS串接
StaffDto 參考

解說 ReceiptRoller 員工(Staff)主檔 StaffDto 的所有欄位。彙整與 POS(Square Team / Smaregi)的關聯、店鋪指派、雇用型態等結構。

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

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

2026-04-27 api webhook overview getting-started
開發者入口可做的事

概觀 ReceiptRoller 的開發者入口可做的事。組合 REST API 的資料取得、操作與 Webhook 的即時事件接收,可從外部系統串接店鋪、使用者資料。

2026-06-01 API OAuth 銷售管理 OMS 訂單 CRUD Android iOS
銷售管理 API(Orders / OMS API)的使用方式

這是使用 ReceiptRoller 銷售管理 API(/api/v1/orders)對商業帳戶底下的訂單進行 CRUD 操作的指南。彙整訂單的建立、更新、狀態轉移(確認、處理中、取消)、刪除,以及適用於 Android/iOS 應用程式或伺服器串接的流程。

2026-04-27 正式運用 最佳實務 監控 部署
正式運用的最佳實務

解說在正式環境穩定運用 ReceiptRoller 串接應用程式的最佳實務(環境分離、監控、部署、故障因應、文件整備)。

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

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

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 oauth scope api permission liff
OAuth 權限範圍一覽與利用可否

說明 ReceiptRoller 的 OAuth API 可利用的權限範圍的一覽,與各權限範圍被授予哪種類型的應用程式。也涵蓋 User 系權限範圍的審查要件、Store 系與 User 系無法混在的理由、從 LIFF 應用程式的利用方法。

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

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

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

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

2026-03-27 API驗證 OAuth 2.0 授權碼 開發者指南
API 驗證指南

解說 ReceiptRoller API 的 OAuth 2.0 授權碼流程的驗證方法。

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

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

2026-04-27 Webhook 事件 API 即時串接
Webhook 的概要

解說 ReceiptRoller 的 Webhook 所投放的主要事件種類、應該使用 Webhook 而非輪詢的理由、投放形式(HTTPS POST + JSON)、投放保證的思考方式。

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

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

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

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

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

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