從 WooCommerce 換到 YS CART，最怕的就是歷史資料搬不乾淨。這支匯入橋把客戶、商品、訂單——連同數位下載權限——完整搬進 YS CART，而且設計成「可以放心跑第二次」：重複匯入不會重複建立資料。

精靈式引導，六步完成

匯入精靈依「環境檢查 → SQL 備份 → 客戶 → 商品 → 訂單 → 完成」的正確順序引導你逐項上傳匯入；也提供手動模式管理工作紀錄、備份與還原。來源站匯出 ZIP 套件後上傳即可，可依序匯入多個不同來源站——訂單以「來源站＋來源單號」辨識，不會互相覆蓋。

大站也搬得動：REST 續跑批次

匯入走可續跑（resumable）的 REST 批次工作：中斷後從斷點繼續，不怕逾時。訂單日期做 UTC 正規化、國別與郵遞區號自動清理、歷史自訂狀態（即使原外掛已停用）也涵蓋。數位下載權限會綁回正確的客戶與訂單，已用下載次數不會被重置。

功能特色

六步匯入精靈

環境檢查→SQL 備份→客戶→商品→訂單→完成，順序不會錯。

可續跑 REST 批次

大量資料分批處理、中斷續跑，不怕主機逾時。

重匯冪等

已存在的資料不重複建立；覆蓋重匯會刷新來源 metadata。

數位下載權限遷移

可下載檔案、次數、到期日綁回正確客戶與訂單。

多來源站支援

訂單以「來源站＋來源單號」辨識，多站合併不互蓋。

資料正規化

訂單時間 UTC 化、國別／郵遞區號自動清理、涵蓋自訂狀態。

螢幕截圖

更新日誌（最新版）

本版累積 0.7.14／0.7.15／0.7.16 三次修正（前兩版未單獨發布）。

Fixed

0.7.16 — 改用 Core 的原子來源匯入

商品、屬性、商品下載與持久來源身分一起提交。此指令由 Core 2.61.5 提供；沒有 catalog 交易擁有者的舊 Core 維持原有匯入路徑。
先讀 Core 的商品身分，再看保留的 legacy 對應；legacy upsert 與變體下載寫入方仍各自持有 map 列身分。
原始提交結果無法被證明時，整批停下——同時停掉後台的自動輪詢迴圈，保留目前游標與會過期的 job lock 供對帳。不確定的批次不會被當成成功繼續往下跑。

0.7.15 — 批次計數不再歸零

進入變體階段時保留上一批商品的 processed／success／error 總數；只有變體游標歸零，已完成的商品列不再從 job 計數裡消失。

0.7.14 — 被拒絕的商品更新算錯誤

YS CART 拒絕商品更新時視為匯入錯誤：既有交易在屬性、對應與數位下載被改動之前回滾，該列不再被計成成功。

Changed

出貨套件邊界改由 `.gitattributes` 的 export-ignore 宣告，不再只存在打包腳本裡。本版與 v0.7.13 逐檔相同（63 個），只有程式碼變動。

常見問題

需要兩邊同時裝外掛嗎？

來源 WooCommerce 站匯出 ZIP 套件，目標 YS CART 站安裝本外掛上傳匯入；也支援同站直接移轉（兩系統同站時）。

匯到一半斷線怎麼辦？

工作是可續跑的批次設計，回到精靈會從斷點繼續；每個工作都有紀錄可查。

跑第二次會產生重複訂單嗎？

不會。訂單以來源站＋來源單號辨識，重匯只更新既有資料（冪等）。

訂閱與變化商品呢？

商品含變化規格對應；特殊型態（如訂閱）依對應表轉換，匯入前的環境檢查會列出注意事項。