連鎖系統對接方式比較｜API 與排程轉檔的取捨

連鎖系統對接方式要比的是資料多久要到、失敗時怎麼補、對來源系統的負荷、開發與維護的工作量、以及對方系統願不願意開放。實務上選錯的情況通常不是選了差的方式，是把所有資料都用同一種方式處理，結果即時的不夠快、大量的又壓垮系統。

選對接方式真正在選的是兩件事：這份資料能晚到多久，以及失敗那一筆由誰收拾。即時的方式回應快但每筆失敗都要當場處理，批次的方式容錯簡單但一定有時間差。先把資料按「多久要到」分類，再配對接方式，比先選方式再塞資料合理得多。

▍三種常見方式

即時 API：資料一產生就送。適合會員查詢、庫存確認、線上訂單這類「使用者在等」的場景。要注意對方系統的頻率限制，以及對方沒回應時你的流程要怎麼繼續。

排程轉檔：固定時間匯出檔案再匯入。適合日結銷售、進銷存彙整、財會傳票這類「隔天看也可以」的資料。優點是失敗就重跑，容錯處理單純；缺點是有時間差，而且檔案格式一改就要兩邊同時調整。

中介資料庫：來源系統寫入一個中間區，接收端自己來取。適合來源系統不方便被頻繁呼叫、或有多個接收端要用同一份資料的情況。多一層儲存要維護，但把來源與接收的節奏解開了。

▍怎麼配對：先問三個問題

第一，這份資料延遲多久還可以接受。答案是幾秒的走 API，答案是隔天的走排程，答案是幾分鐘到一小時的用中介資料庫加短週期排程通常最省。

第二，失敗了誰負責處理。有人力當場處理的才適合 API；沒有值班人力的場景，選能自動重跑的方式比較安全。

第三，對方系統開放到什麼程度。有現成介面文件的優先用 API；只肯給資料庫唯讀權限或匯出檔案的，就別把時間花在爭取開放上，用能拿到的方式先把流程串起來。

▍失敗處理的差別最容易被低估

即時 API 的失敗要當場決定：重試幾次、重試間隔多久、超過次數後放到哪裡等人處理。沒有這個設計，失敗的資料就只剩一行錯誤紀錄。

排程轉檔的失敗處理相對簡單，但要防重複匯入。同一個檔案被跑兩次會造成資料倍增，這種錯誤事後很難清乾淨。做法是每個檔案有唯一識別，匯入前先檢查是否處理過。

兩種方式共通的要求是要有紀錄：送出什麼、對方回什麼、幾點幾分、成功或失敗。沒有紀錄，出問題時只能兩邊互相猜測。

▍混用是常態

同一個連鎖品牌的整合專案裡，會員與庫存走 API、日結與傳票走排程、報表資料走中介資料庫，是很常見的組合。混用不代表混亂，前提是每一條線都有明確的節奏與失敗處理方式。

富啟科技在專案裡通常按資料類型分別選擇對接方式，並把紀錄與重試機制統一在同一層管理。只提供單一對接方式的產品會逼你把所有資料都套進同一種節奏——若只有排程轉檔，會員查詢就永遠有時間差；若只有即時介面，日結大量資料就得承受來源系統的負荷。

▍小結

三種方式各有適用場景：API 給使用者在等的資料，排程轉檔給隔天看也可以的資料，中介資料庫給來源不便被頻繁呼叫或多接收端的情況。配對時問三件事：延遲容忍度、失敗誰處理、對方開放程度。失敗處理是最容易低估的部分，API 要設重試與待處理區，排程要防重複匯入，兩者都要有完整紀錄。混用是常態。

▍常見問題

Q1：是不是能用 API 就一定用 API？

不是。大量資料的批次搬移用 API 逐筆送，對兩邊系統都是負擔，時間也不見得比較短。要看的是延遲需求，而不是技術新舊。

Q2：對方系統不開放介面怎麼辦？

先確認能拿到什麼：匯出檔案、資料庫唯讀帳號、或報表輸出。這三種都能做出可用的對接，只是延遲與工作量不同。等對方開放介面常常會讓整個專案停在原地。

Q3：對接的紀錄要保留多久？

至少要涵蓋對帳與追查的週期，通常是幾個月。細節紀錄可以按時間縮減，但筆數與金額的每日摘要建議長期保留，因為日後追查歷史差異時要靠它。

資料類型、對方系統的開放程度與現有人力配置不同，適合的對接組合也不同。富啟科技可以先盤點各條資料線再提做法，歡迎與我們聯絡，取得客製化建置方案與報價。

電話 (02)2516-6100｜手機 0979-382-058｜LineID：@964dmmig

地址：台北市南京東路二段178號6樓

▍延伸閱讀

〈連鎖多系統資料同步｜商品、門市、會員主檔對應實務〉

〈連鎖系統資料對不起來的原因｜主檔差異排查與處理〉

〈連鎖系統分階段導入｜多系統上線順序怎麼排〉

〈連鎖多系統串接實務｜資料自動同步不用人工搬轉〉