62 筆 (第 1 頁,共 4 頁)
2026-06-10 API OAuth 營業時間 Business Hours 特別營業日 可營業時間 排班 Android iOS
營業時間 API(Business Hours API)的使用方式

ReceiptRoller 營業時間 API(/api/v1/stores/{storeId}/business-hours)的指南。解說每個星期的營業時間的取得與更新、特別營業日(臨時歇業、營業時間變更)的登錄、店鋪的可營業時間(排班建立時的上限業務時間)的設定,以及目前是否營業中的判定。

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-06-21 API 商店應用程式 公告 頁面 營業資訊 shopId
商店應用程式 內容 API(公告、頁面、營業資訊)的使用方式

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

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-20 API Store 店鋪資訊 OAuth
店鋪資訊 API(Store Information API)的使用方式

說明如何以 REST API 取得、更新店鋪的基本資訊(店鋪名稱、店鋪類別、聯絡方式、地址)。可從員工應用程式等以權杖驗證的用戶端實作店鋪資訊的編輯畫面。

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

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

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

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

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

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

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

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

2026-05-26 OAuth Android iOS 行動 API 多商業帳戶 PKCE
原生行動應用程式指南:多商業帳戶存取與 OAuth 流程

Android / iOS 原生應用程式的實作指南。應用程式登錄時將「授權時將權杖關聯至 1 個商業帳戶」關閉,即會發行 user-scoped OAuth 權杖。以 /api/v1/me/organizations + ?organizationId= 模式即可跨多個商業帳戶存取。

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

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

2026-04-27 User系權限範圍 審查 隱私權 個人資訊 應用程式登錄
User 系權限範圍的審查申請

解說在 ReceiptRoller 處理一般消費者資料(user.* 權限範圍)的應用程式所需的審查申請流程、提交文件、審查基準、審查期間、常見退件理由。

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

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

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

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

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

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

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

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

2026-06-03 API OAuth 員工管理 員工 Staff CRUD Android iOS
員工管理 API(Staff API)的使用方式

這是使用 ReceiptRoller 員工管理 API(/api/v1/staff)對商業帳戶底下的員工(Staff)進行 CRUD 操作的指南。支援與 Square Team Member 互通的欄位(假名、多工作分配、薪資結構)。

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

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

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

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

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

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