62 筆 (第 3 頁,共 4 頁)
2026-04-27 正式運用 最佳實務 監控 部署
正式運用的最佳實務

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

2026-06-03 API Display 媒體 Android 數位看板 配對 零售媒體 曝光
店內媒體顯示器 API(Display API)的使用方式

ReceiptRoller 店內 Android 顯示器 API(/api/v1/displays/*)的概要,以及配對、心跳、播放清單取得、播放實績回報的步驟彙整。這是為在 Android 電子看板或店內數位看板端末播放媒體循環而實作應用程式的入門指南。

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

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

2026-04-27 疑難排解 403 401 權限 權限範圍
回傳 403/401(權限、權限範圍)

API 呼叫回傳 401 或 403 時的原因釐清。解說權杖無效、權限範圍不足、無店鋪存取權、User 系審查未通過等典型情況。

2026-06-01 API OAuth 交易 Transactions POS OMS Android iOS
交易一覽 API(Transactions API:POS+OMS 整合摘要)的使用方式

ReceiptRoller 的 Transactions API 是將收銀營業額(PosTransactions)與銷售管理訂單(OmsOrders)整合為單一摘要的唯讀 API。在 Android/iOS 應用程式中一覽顯示「整個商業帳戶的交易」時,即為入口。

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

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

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-03-27 API驗證 OAuth 2.0 授權碼 開發者指南
API 驗證指南

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

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-27 API 請求 回應 JSON 分頁
請求與回應的基本(JSON)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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