Square 的 POS 連動設定

將 Square 的 POS 與 ReceiptRoller 連動後，每次結帳時交易資料會自動傳送，並生成電子收據。連動僅需 Square 帳號的認證即可完成。不需要輸入 Square 的開發者設定或 API 金鑰。

Step 1：開啟 POS 端末畫面

從門市儀表板的功能卡片一覽點擊「POS 端末」。會開啟 POS 端末一覽畫面。

Step 2：與 Square 連動

點擊畫面右上方的「與 Square 連動」按鈕。會移動至 Square 的認證頁面。

Step 3：以 Square 帳號進行認證

在 Square 的登入畫面以 Square 帳號登入，確認存取權限後點擊「允許」。認證完成後，會自動返回 ReceiptRoller。

Step 4：選擇地點（多個地點時）

若 Square 帳號中登錄了多個地點（門市・據點），會顯示「Square 地點選擇」畫面。請點擊與欲連動門市對應的地點的「選擇此地點」。

若只有 1 個地點，則此畫面會被跳過，自動完成連動。

連動完成後的確認

POS 端末一覽會顯示「已與 Square 連動」，並新增一張新的端末卡片。卡片上會顯示以下資訊。

• 端末名稱（例：Square POS — 門市名稱）
• Square 徽章與 API 連動徽章
• 地點（住所）
• 已同步交易件數
• 狀態（運作中）

連動後同步的資料

連動完成後，以下資料會在 Square ↔ ReceiptRoller 之間自動往來。

匯入商品主檔（選用）

交易資料會在 POS 連動完成的同時開始自動匯入，但商品主檔（商品名稱・SKU・分類・售價等一覽）的匯入為門市營運者自行選擇是否進行。若希望在 ReceiptRoller 端輸入成本以進行利潤分析，或想管理各商品的附加屬性（品牌・進貨來源・JAN 碼等），請進行匯入。

1. 開啟門市管理畫面的「商品管理」。
2. 從右上方的選單（︙圖示）點擊「從 Square 同步」。
3. 透過 Square Catalog API 匯入全部商品與分類，新增・更新皆自動進行。
4. 同步完成後，畫面上方會顯示匯入的件數。

關於匯入的項目與欄位對應、Square 特有的行為（多個 Variation 的處理、成本未被匯入的原因等）詳情，請參閱 Square 商品資料與 ReceiptRoller 商品資料的對應。

即使不匯入商品主檔，依商品別的銷售分析仍可運作（因為會從交易明細自動彙整商品名稱・分類）。僅在需要成本管理或利潤分析時再考慮匯入即可。

資料的手動同步

點擊端末卡片開啟詳細畫面，再點擊「與 Square 同步」按鈕，即可手動匯入最近 30 天份（或上次同步之後）的交易資料。同步完成後，會顯示「已與 Square 同步。已取得 ○ 件的交易。」

通常每次結帳都會即時傳送資料，因此手動同步多用於首次連動時或需要重新同步的情況。

端末的編輯・刪除

可在端末詳細畫面中編輯端末名稱與地點資訊。若要解除連動，請從「刪除」按鈕刪除端末。

想確認資料內部結構時

關於從 Square 取得的交易資料，如何對應至 ReceiptRoller 內部的交易資料模型，請參閱技術解說文章。內容彙整了以欄位為單位的對應表・狀態轉換・明細・顧客配對・OAuth 權杖自動更新等內部規格。

• Square 交易資料與 ReceiptRoller 交易資料的對應 — 技術詳情
• Square 顧客資料與 ReceiptRoller 顧客資料的對應
• Square 商品資料與 ReceiptRoller 商品資料的對應
• PosTransactionDto 規格（欄位參照） — 交易資料模型的完整欄位

相關文章

• 電子收據的運作機制
• Smaregi 的 POS 連動設定