63 筆 (第 2 頁,共 4 頁)
2026-05-29 員工 從業人員 資料模型 參考 POS串接
StaffDto 參考

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

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

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

2026-04-27 API 速率限制 429 節流
速率限制與節流

解說 ReceiptRoller API 的速率限制的單位、各方案的上限、回應標頭的解讀方式,以及為不觸及 429 的實作模式。

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

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

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

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

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

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

2026-03-05 API OAuth Webhook 驗證 權限範圍
開發者向幫助目次

ReceiptRoller 開發者向幫助目次。彙整了開發者申請、應用程式登錄、OAuth 驗證與權限範圍、實作指南(錢包應用程式、店鋪向 Webhook、Survey API)、依資料領域別指南、運用與安全性、社群、疑難排解。

2026-04-27 app-registration oauth client getting-started
什麼是應用程式登錄

說明 ReceiptRoller 的應用程式登錄的概念。透過將應用程式登錄為 OAuth 用戶端,會發行用戶端 ID、密鑰、重新導向 URI,可開始 API、Webhook 串接。

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

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

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

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

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

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

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

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

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

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

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

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

2026-04-27 getting-started plan oauth app-registration
利用開始為止的流程

說明 ReceiptRoller 的開發者入口利用開始為止的流程。作為店鋪使用者登錄,只要是 Starter 方案以上,無需另行的開發者申請即可立刻開始應用程式登錄與 API 實作。

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

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

2026-04-27 api reference swagger openapi community
API 參考與文件的閱讀方式

說明 ReceiptRoller 的開發者向文件的構成與分別使用。開發者幫助、API 頂頁、Swagger 基底的 API 參考、開發者社群的 4 個入口,以及可用於 AI 助手或程式碼生成工具的 OpenAPI 規格(openapi/v1.json)的取得方法。

2026-06-10 API 庫存管理 WMS OAuth MCP Shopify串接
庫存管理 API(Inventory / WMS API)的使用方式

ReceiptRoller 庫存管理 API(Inventory / WMS API)的實作指南。解說以據點(倉庫、店鋪後場、賣場)為單位的庫存查詢、調整、異動紀錄取得方法,必要的 OAuth 權限範圍,Shopify 串接時的自動反映,以及從 MCP 工具(wms_get_stock / wms_adjust_stock 等)的使用方式。

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

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

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

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