57 筆 (第 3 頁,共 3 頁)
2026-04-27 API 請求 回應 JSON 分頁
請求與回應的基本(JSON)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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-06-01 API OAuth 交易 Transactions POS OMS Android iOS
交易一覽 API(Transactions API:POS+OMS 整合摘要)的使用方式

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

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

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

2026-04-27 oauth scope api permission liff
OAuth 權限範圍一覽與利用可否

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

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 行動應用程式或伺服器串接實作營業額儀表板的入門指南。