Smaregi 的 POS 連動設定
將 Smaregi 與 ReceiptRoller 連動後，Smaregi 的 POS 收銀機所開立的交易會自動匯入 ReceiptRoller，可運用於電子收據的開立、CRM 連動、銷售分析。連動只需從 Smaregi 應用程式市集安裝，並在 ReceiptRoller 端進行單次點擊操作即可完成。
所需準備
- Smaregi 的商業帳號（可使用 API 連動的付費方案）
- 可登入 Smaregi 管理畫面的權限
- ReceiptRoller 的 Basic 方案以上（POS 端末 1 台為止是 Basic，最多 3 台是 Starter，超過則為更高階方案）
方案上限是以「已連動的 POS 端末（收銀機）台數」計算。若 1 間門市有多台收銀機且全部連動，則需要相應台數的方案。
步驟 1：從 Smaregi 應用程式市集安裝「ReceiptRoller連動」
- 登入 Smaregi 的管理畫面。
- 從應用程式市集搜尋「ReceiptRoller連動」並安裝。
- 在安裝時顯示的使用條款與存取權限同意畫面中，選擇「同意」。
步驟 2：以 Smaregi 登入 ReceiptRoller
- 從 Smaregi 管理畫面的應用程式一覽點擊「ReceiptRoller連動」的圖示。
- 會開啟 ReceiptRoller 的登入畫面。點擊「以 Smaregi 登入」按鈕，即可直接以 Smaregi 帳號登入。
- 若為首次登入，會以 Smaregi 登錄的電子郵件地址自動建立 ReceiptRoller 帳號。
- 登入後會顯示商業帳號一覽。請選擇連動對象的商業帳號與門市（若尚未建立，請新增建立）。
步驟 3：以 POS 端末身分進行連動
- 從連動對象的門市頁面開啟「POS 端末」。
- 點擊右上方的「與 Smaregi 連動」按鈕（紅色按鈕）。
- 會顯示 Smaregi 端的門市一覽。請選擇要連動的門市。
- 若 Smaregi 只登錄了 1 間門市，則會跳過門市選擇，直接進入下一步。
- 會顯示所選門市內的端末（收銀機）一覽。請選擇要連動的端末。
- 若只有 1 台，端末選擇也會被跳過，自動完成連動。
- 會顯示連動完成的通知，並在 POS 端末一覽中新增一張端末卡片。
步驟 4：確認交易的同步
連動完成後，新的交易會即時自動傳送至 ReceiptRoller（透過 Smaregi 的 Webhook）。若要匯入過去的交易，或 Webhook 未送達的部分，也可以進行手動同步。
- 開啟 POS 端末的詳細頁面。
- 點擊右上方的「與 Smaregi 同步」按鈕（紅色按鈕）。
- 首次同步會取得過去 30 天份的交易資料。第 2 次以後僅會匯入上次同步之後的差異部分。
- 同步完成後，交易一覽會顯示匯入的件數。
連動後同步的資料
連動完成後，以下資料會在 Smaregi ↔ ReceiptRoller 之間自動往來。
| 資料種類 | 方向 | 時機 | 詳細 |
|---|---|---|---|
| 交易（銷售明細・金額・付款方式） | Smaregi → RR | 即時（Webhook） | Smaregi 交易資料的對應 |
| 會員資訊（姓名・聯絡方式・會員編號・生日等） | 雙向 | 登錄・更新時數秒內 + 每 1 小時的差異同步 | 會員資訊雙向同步 / 會員資料的對應 |
| 商品主檔（商品名稱・代碼・分類・售價・成本） | Smaregi → RR | 手動同步（商品管理畫面的「從 Smaregi 同步」按鈕） | 商品資料的對應 |
| 門市・收銀機端末 | Smaregi → RR | 連動時 + 手動同步 | 於 Smaregi 端新增・刪除的端末，需再次執行「與 Smaregi 連動」以反映 |
匯入商品主檔（選用）
交易資料會在 POS 連動完成的同時開始自動匯入，但商品主檔（商品名稱・SKU・分類・售價・成本等一覽）的匯入為門市營運者自行選擇是否進行。若希望在 ReceiptRoller 端輸入成本以進行利潤分析，或想管理各商品的附加屬性（品牌・進貨來源・JAN 碼等），請進行匯入。
- 開啟門市管理畫面的「商品管理」。
- 從右上方的選單（︙圖示）點擊「從 Smaregi 同步」。
- 透過 Smaregi Platform API 匯入全部商品與分類，新增・更新皆自動進行。
- 同步完成後，畫面上方會顯示匯入的件數。
關於匯入的項目與欄位對應、再次同步時的行為、Smaregi 特有的注意事項（稅率・JAN 碼未被匯入的原因等）詳情，請參閱 Smaregi 商品資料與 ReceiptRoller 商品資料的對應。
即使不匯入商品主檔，依商品別的銷售分析・ABC 分析仍可運作（因為會從交易明細自動彙整商品名稱・分類）。僅在需要成本管理或利潤分析時再考慮匯入即可。
連動多間門市・多台端末
若在 Smaregi 端營運多間門市或多台端末，在 ReceiptRoller 端也需要逐一進行連動。
- 在同一門市新增其他端末時，請再次點擊「與 Smaregi 連動」按鈕。已連動的端末會從一覽中排除，僅顯示尚未連動的端末。
- 連動其他門市時，請在 ReceiptRoller 端開啟該門市的 POS 端末頁面，以相同步驟進行連動。
- 可連動的 POS 端末台數依方案而異。達到上限時，會自動導向方案變更畫面。
注意事項
- Smaregi 的 API 連動僅限付費方案可使用，請確認您的 Smaregi 合約內容。
- 連動後若在 Smaregi 端新增・刪除端末，請在 ReceiptRoller 端也再次執行「與 Smaregi 連動」以反映變更。
- 交易資料的即時匯入，需要 Smaregi 端已啟用 Webhook 設定。此設定可在 Smaregi 的「ReceiptRoller連動」應用程式設定畫面中確認。
- 過去的退款・取消紀錄，請透過「與 Smaregi 同步」按鈕手動同步，以反映最新狀態。
- 若商品主檔・會員資訊在 Smaregi 端有重大變更，建議手動同步以更新至最新狀態。
常見問題
- 找不到「與 Smaregi 連動」按鈕→ 回到 POS 端末頁面前，請先透過 Smaregi 重新登入。連動需要合約 ID 的資訊，此資訊會在登入時傳遞給 ReceiptRoller 端。
- 連動後未顯示交易→ 請從 POS 端末的詳細頁面點擊「與 Smaregi 同步」。即時連動可能已中斷。
- 顯示「需要升級方案」→ 已達到方案的 POS 端末上限。請於方案變更畫面考慮升級至更高階方案。
- 顯示 / 未顯示不同門市・端末所開立的交易→ 請確認連動時所選的 Smaregi 門市 ID・端末 ID，與實際開立交易的收銀機是否一致。可在 POS 端末的編輯畫面中確認・變更。
- 商品管理未顯示「從 Smaregi 同步」按鈕→ 可能尚未有已完成 POS 連動的端末。請先完成上述的 POS 連動。
相關文章
想了解更多的使用者
關於 Smaregi 的交易・會員・商品資料在 ReceiptRoller 內部如何進行轉換，我們準備了技術解說文章，詳細彙整了以欄位為單位的對應表、狀態・付款方式的正規化、明細・顧客・員工資訊的解析、時區與冪等性的處理方式等內容。
- Smaregi 交易資料與 ReceiptRoller 交易資料的對應（開發者・維運人員適用）
- Smaregi 會員資料與 ReceiptRoller 顧客資料的對應（開發者・維運人員適用）
- Smaregi 商品資料與 ReceiptRoller 商品資料的對應（開發者・維運人員適用）