自動化 Squarespace 訂單出貨流程 - n8n 工作流程

販售數位商品或禮品卡的 Squarespace 店家老闆。
使用外部出貨服務，且需要立即獲得 API 確認的商家。
尋求可靠 n8n 範本以進行電子商務 API 整合的開發人員。
希望使用 n8n 工作流程有效管理大量 Squarespace 訂單的自動化專家。

手動管理訂單出貨非常耗時，特別是處理數位商品或依賴自動化代發貨服務的店家。這個強大的 n8n 工作流程透過提供排程、自主性的系統來處理待處理訂單，從而解決了這個問題。它利用 Squarespace 商業 API 只擷取 PENDING (待處理) 的訂單，套用一個關鍵的時間篩選器（僅處理超過 24 小時的訂單以確保款項結清），然後執行出貨動作。整個流程都在 n8n 實例中管理，確保客戶能快速可靠地收到出貨通知，從而節省大量營運時間並提升客戶滿意度。這個完整的 n8n 節點架構是高效商業自動化的絕佳範例。

此自動化可以透過 n8n 的「點擊執行」觸發器手動啟動，或透過「排程觸發器」n8n 節點自動排程啟動。

1. 設定 (全域變數): 流程首先使用 n8n 的 Set 節點初始化全域變數，定義所需的 Squarespace API 版本，並將 fulfillmentStatus 設定為 PENDING (待處理)。它還將 maxPage 設定為 -1 以啟用無限分頁。


2. 查詢訂單 (HTTP Request): 名為「Query pending Orders」的 n8n 節點會向 Squarespace 訂單 API 發送一個複雜的 HTTP 請求。它利用 Globals 節點中設定的參數，並自動處理基於 API 的分頁，確保擷取到所有待處理的訂單。


3. 資料拆分 (Split Out Order): 使用「Split Out Order」n8n 節點將收到的訂單批次拆分成單筆項目，讓後續的節點可以獨立處理每筆訂單。


4. 篩選 (Filter Orders): 此處會套用一個安全檢查。名為「Filter Orders」的 n8n 節點只允許建立時間超過 24 小時的訂單繼續進行。這能最大限度地降低對仍在等待付款清算的交易執行出貨的風險。


5. 批次處理 (Loop Over Items): 使用「Loop Over Items」n8n 節點，將篩選後的項目準備好進行依序處理。


6. 出貨 (HTTP Request): 名為「Fulfill Order」的 n8n 節點會使用 OAuth 2.0 憑證向 Squarespace 出貨端點發送 POST 請求。負載 (payload) 設定為將訂單標記為已出貨，並觸發客戶通知 ("shouldSendNotification": true)。

若要成功部署此 n8n 工作流程，請遵循以下步驟：

1. 匯入: 複製提供的 n8n 工作流程 JSON，並貼到您的 n8n 實例中 (Workflows -> New -> Import From JSON)。


2. Squarespace 憑證: 這個 n8n 工作流程需要兩組 Squarespace API 存取憑證：

1. 設定節點: 開啟名為「Globals」的 n8n 節點並驗證數值。確保 api-version 正確，如果您需要縮小搜尋範圍，請調整如 modifiedAfter 或 modifiedBefore 等篩選器。


2. 設定觸發器: 決定要使用「Schedule Trigger」n8n 觸發器（並設定其間隔）還是手動執行。停用未使用的觸發器以保持 n8n 工作流程的整潔。

這個 n8n 範本的功能依賴於以下幾個關鍵的 n8n 節點類型：

Schedule Trigger / Manual Trigger: 這些 n8n 觸發器啟動自動化，允許定時執行或手動測試。
Set (Globals): 設定流程專用的全域變數，包含所需的 API 版本 (1.0) 以及用於無限分頁的篩選選項，如 fulfillmentStatus (PENDING) 和 maxPage (-1)。
HTTP Request (Query pending Orders): 核心的擷取 n8n 節點。它使用定義好的變數動態建構 Squarespace API URL，並利用強大的內建分頁設定來自動處理大型結果集。
Split Out Order: 將 API 收到的訂單陣列轉換為單獨的項目，讓 n8n 工作流程可以逐一處理。
Filter (Filter Orders): 實施基於時間的條件，檢查訂單建立時間是否早於 24 小時前。這是此 n8n 節點中一個關鍵的流程控制措施。
Split In Batches (Loop Over Items): 在執行最終出貨動作前，確保能可靠地在篩選後的訂單上進行迴圈處理。

• HTTP Request (Fulfill Order): 向特定訂單 ID 的出貨端點發送 POST 請求，確認出貨狀態，並透過 shouldSendNotification: true 參數觸發客戶通知。