ReceiptRoller 1.4.282 發行公告

本次發行的 1.4.282 版本，以自前一版 1.4.254 以來持續開發的 「將店舖業主的員工管理大幅強化至與 Square 互通的等級」 與 「Android／iOS 應用程式開發者專用的 API 擴充與系統效能改善」 為主題，公開了員工溝通功能、POS 雙向同步、商業帳戶列表的易用性提升、登入後反應速度改善、付款帳本基礎架構、整合 POS 與訂單管理（OMS）交易資料的 API 等多項更新內容。

服務可由此使用：https://receiptroller.io

主要更新內容

將員工管理大幅強化至與 Square 互通的等級

為了支援 1 位員工在多間店舖兼任多個職務的情境，我們將 員工個人資料擴充為與 Square Team Members 互通的欄位結構。在與 Square 連動的店舖中，於 ReceiptRoller 端編輯的內容會自動反映至 Square。

支援多重業務（多重工作） — 就像「在 A 店擔任店長、時薪 1800 日圓，在 B 店擔任外場、時薪 1200 日圓」一樣，可依業務別分別登錄職務、薪資與適用店舖。透過直覺的卡片式 UI，即可新增或刪除業務
片假名姓名・參照 ID・在籍狀態・業主權限・排除加班・小費領取對象 — 新增了薪資計算與出勤資料連動所需的欄位
全店舖分配切換 — 為多店舖業主提供「於所有店舖服勤」的切換開關。新增店舖時也會自動納入對象
與 Square Team Members 的雙向同步 — 在使用 Square 連動 POS 的店舖，於 Square 端新增或更新員工時會自動反映至 ReceiptRoller，而在 ReceiptRoller 端編輯的內容也會自動推送至 Square。以最後寫入的變更為優先
員工管理 API — 支援透過 /api/v1/staff 進行 CRUD 操作。可用於 Android／iOS 員工應用程式或伺服器連動

全新公開員工溝通功能

為避免業務聯絡分散於 LINE 群組或個人 SNS，我們公開了 內建於 ReceiptRoller 的員工間溝通功能。無需安裝專用應用程式，使用電子郵件地址與密碼即可登入使用。

公告發送 — 業主或店長可單向發送業務聯絡給員工。發送對象可從「全體」「特定店舖」「指定員工」中選擇，並支援已讀人數確認、置頂、設定有效期限
一對一訊息 — 員工之間的私訊。若同一組 2 人過去已有討論串，會重複使用既有討論串
群組討論串 — 3 人以上的員工可建立標題進行對話的討論串。之後也可新增或刪除參與者，變更紀錄會以系統訊息記錄
業主端審核 — 商業帳戶的業主或店長可檢視所有公告、討論串與訊息。支援刪除不當訊息（附刪除理由，並自動通知參與者）、關閉討論串，以及輸出符合法規要求的 CSV
與稽核紀錄的整合 — 所有審核操作皆會記錄於稽核紀錄，之後可追溯「誰・為何・何時」進行了操作

將商業帳戶列表改善為顯示 100 筆＋伺服器端搜尋＋分頁

我們收到許多隸屬於多個商業帳戶的客戶反映「只顯示 50 筆，找不到想要的帳戶」，因此此次已支援 擴大顯示筆數與伺服器端的跨頁搜尋。

顯示筆數擴充至 100 筆 — 每頁最多可切換至 300 筆（可從頁尾的選項中選擇）
伺服器端關鍵字搜尋 — 可跨帳戶名稱・說明・業種進行搜尋。即使搜尋結果橫跨多頁，也能找到畫面上未顯示的帳戶
分頁功能 — 顯示筆數資訊（如「1-100／312 筆」）、首頁／上一頁／下一頁／末頁的移動按鍵，以及目前頁面前後 7 頁範圍的頁碼連結
URL 保留搜尋條件 — 可分享或加入書籤搜尋結果的頁面

大幅改善登入後的反應速度

針對「按下登入按鍵後，要等很久畫面才會切換」的反饋，我們 大幅縮短了登入後及切換帳戶時的等待時間。

將稽核紀錄寫入等不影響使用者回應的處理改為背景執行。登入・建立商業帳戶・邀請成員・變更方案等操作後的等待時間已大幅縮短
商業帳戶列表畫面無法顯示的問題 — 修正了在部分帳戶條件下 /organizations 頁面無法讀取的問題
員工登錄時的通用錯誤畫面 — 為避免按下儲存按鍵後跳轉至錯誤畫面而遺失輸入內容，現已改為在畫面上以中文顯示錯誤原因，並保留已輸入的內容

大幅擴充行動應用程式・伺服器連動專用 API

針對 Android／iOS 原生應用程式開發者，我們 一次性公開了用於建構銷售儀表板・商品管理・訂單管理・交易列表・員工管理的 API。已具備實作員工應用程式或銷售速報小工具所需的基礎。

強化銷售 API — 於 /api/v1/sales/kpis、/trend、/products、/visitors 新增 ?terminalId= 篩選參數。現可依單一 POS 終端進行銷售分析。平均客單價（averageTicket）也已改為由伺服器端計算，並於所有範圍回傳
存取權杖有效期限延長至 8 小時 — 解決了行動應用程式使用期間因權杖過期而頻繁發生驗證錯誤的問題。已調整為配合一日營業班次的時間長度
取得店舖・POS 終端清單 — 可透過 GET /api/v1/me/organizations/{orgId}/stores 及 /stores/{storeId}/pos-terminals 取得商業帳戶下轄的店舖與 POS 終端清單
商品管理 API — 支援透過 /api/v1/products 進行 CRUD 操作。可從行動應用程式讀寫 PIM（商品主檔）
訂單管理 API（OMS） — 支援透過 /api/v1/orders 進行 CRUD 及狀態轉換（確認・處理中・取消）
交易列表 API — /api/v1/transactions 是將收銀銷售（POS）與訂單管理訂單（OMS）整合為單一資料流的唯讀專用 API。是行動應用程式顯示「商業帳戶整體交易」列表的入口
員工管理 API — 透過 /api/v1/staff 進行 CRUD。支援與 Square 互通的欄位（片假名姓名・多重業務・薪資結構）
商業帳戶列表 API 的分頁 — /api/v1/me/organizations 現已支援分頁，最多可取得 1000 筆

建置整合 POS 與訂單管理（OMS）交易資料的基礎

我們建置了 將過去分別管理的收銀銷售資料與訂單管理（OMS）訂單資料，作為單一交易串流處理的基礎。可一次貫通掌握「在門市購買，隔日又於電商重新下單」這類顧客行為。

整合交易串流 API — 可透過 /api/v1/transactions 將 POS 銷售與 OMS 訂單取得為單一時間序列串流
OMS 訂單與 POS 門市取貨的連結 — 支援於電商下單的商品在門市取貨時的關聯處理
整合付款帳本 — 將付款資訊整合為單一帳本，並新增防止 Webhook 重複處理的機制
POS → OMS 自動連動的試營運 — 可透過各商業帳戶可啟用的管理功能旗標，試營運 POS 交易自動匯入 OMS 的功能

今後的規劃

在今後的更新中，我們預計持續推動 店內 Android 終端專用的媒體發送功能（數位看板・ReceiptRoller 零售媒體的自有發送基礎）、員工端可接收的溝通畫面（行動裝置版）、銷售 API 的日次・週次圖表化支援、員工管理的店長權限範圍限縮、POS→OMS 自動連動的正式公開等項目。若您有「希望具備這樣的功能」的需求，歡迎隨時透過功能需求頁面與我們聯繫。

感謝您使用 ReceiptRoller。若有任何意見或需求，歡迎透過店舖管理畫面的「意見回饋」與我們聯繫。

ReceiptRoller 1.4.282 員工管理大幅強化・行動裝置開發者專用 API 擴充・系統效能改善