60 筆 (第 2 頁,共 4 頁)
2026-04-27 oauth scope api permission liff
OAuth 權限範圍一覽與利用可否

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

2026-04-24 ReceiptRoller 開發者 社群 提問
在社群發問

說明在開發者社群發問的步驟,與投稿後的核准流程、通知郵件的流程。

2026-05-29 CRM 顧客 資料模型 參考 POS串接
CrmCustomerDto 參考

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

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

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

2026-04-27 OAuth 重新導向URI 應用程式登錄 安全性
重新導向 URL 的設定

解說在 ReceiptRoller 的開發者入口設定的重新導向 URI(回呼 URL)的角色、登錄規則、開發與正式環境的分別使用、常見錯誤與因應方法。

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

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

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

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

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

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

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

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

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

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

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

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

2026-04-27 Webhook 重送 冪等性 順序 重試
重送、順序、冪等性的設計

解說 ReceiptRoller Webhook 的重送政策、投放順序不保證的理由、使用 event_id 的冪等性實作、無效信件的處理、常見反模式。

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

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

2026-04-27 Webhook 簽章驗證 HMAC 安全性 重放攻擊
簽章驗證與安全性

解說 ReceiptRoller Webhook 的 HMAC-SHA256 簽章驗證的機制、驗證程式碼的範例(Node.js / Python / C#)、重放攻擊對策、密鑰的安全管理方法。

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

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

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

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

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

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

2026-04-27 廣告 活動 優惠券 成效測量
廣告日誌、成效測量資料

解說 ReceiptRoller 處理的活動、優惠券、廣告日誌、購買歸因測量資料的結構與取得方法。

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

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

2026-04-27 app-registration oauth client developer-portal
新增建立應用程式

說明在 ReceiptRoller 的開發者入口登錄新的應用程式(OAuth 用戶端)的具體步驟。涵蓋輸入項目、驗證、建立後的憑證顯示、常見錯誤。