31 筆 (第 1 頁,共 2 頁)
2026-04-27 帳票 請款 會計 發票
帳票、請款相關資料(對應範圍)

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

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

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

2026-06-10 API OAuth 預約 Reservations 預約框 桌位 Android iOS
預約管理 API(Reservations API)的使用方式

ReceiptRoller 預約管理 API(/api/v1/reservations)的指南。解說預約的 CRUD、狀態更新,預約框(時段)的取得、建立、整批產生,店鋪版面所登錄的座位(桌位、包廂、吧台)的取得,以及預約統計。

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

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

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

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

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

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

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

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

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

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

2026-04-25 survey api receipt targeting liff
Survey API and receipt embed

ReceiptRoller 的問卷功能讓店鋪透過 QR/連結/數位收據嵌入收集回答,並可選擇性地回饋優惠券。本文涵蓋公開消費者 API、收據嵌入酬載,以及店鋪可附加至活動的觀眾鎖定規則。

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

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

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

解說 ReceiptRoller 商品主檔(PIM)ProductDto 的所有欄位。彙整來自 POS(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 api webhook overview getting-started
開發者入口可做的事

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

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

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

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

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

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

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

2026-04-27 Webhook 登錄 端點 事件訂閱
Webhook 的登錄方法

解說在 ReceiptRoller 的開發者入口登錄 Webhook 端點的步驟、訂閱事件的選法、測試投放、多端點的分開運用、刪除與暫停的方法。

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

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

2026-04-27 疑難排解 Webhook 傳送
Webhook 沒有送達

Webhook 沒有送達接收端點時的原因釐清。依端點設定、訂閱事件、可達性、簽章驗證失敗、防火牆等順序確認的步驟。

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

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