超商取貨 API 串接完整教學 2026:C2C/B2C 差異、門市電子地圖、貨態與對帳一次搞懂
☰ 目錄 table-of-contents.md
台灣人網購超過一半選「超商取貨」:不用在家等、到巷口就能拿。但對電商老闆來說,這句方便的背後是:每天要在超商系統手動建立寄件、抄門市代號、貼標籤、再把取貨編號一筆筆回填訂單。訂單一多,出貨小姐就淹沒在複製貼上裡。
解法是把超商取貨 API 串進你的系統,讓訂單自動產生寄件單、自動回填門市與取貨資訊。這篇延續我們的黑貓宅急便 API 串接教學,這次專講超商取貨(7-11、全家等)的串接:怎麼串、C2C 與 B2C 差在哪、以及實務上最容易出包的地方。
先分清楚:C2C 與 B2C,串法完全不同
很多人一開始就卡在這,超商取貨有兩種模式,串接方式和適用對象差很多:
| 模式 | 怎麼運作 | 適合 | 金流 |
|---|---|---|---|
| C2C(店到店) | 你把貨拿到超商寄件,送到買家指定門市取貨 | 出貨量中小、無固定倉庫的賣家 | 常搭配「貨到付款」代收 |
| B2C(大宗) | 與超商簽約,貨集中進物流中心再配送到門市 | 出貨量大、有倉儲的品牌電商 | 多為線上先付 |
‼️ 先選對模式再談串接。中小電商九成適合先走 C2C(門檻低、常可透過金物流整合平台一次串好);等量體大了、要壓低運費與加快配送,再評估 B2C 簽約。
超商取貨串接的完整流程
1. 選串接管道
跟黑貓一樣,超商取貨也有三條路:直接跟超商/物流簽約串接、透過金物流整合平台(一次串黑貓+超商+宅配)、或用第三方出貨 SaaS。對多數電商,走整合平台最省事,因為超商取貨常和金流綁在一起(尤其貨到付款代收),平台幫你一次處理。
2. 門市電子地圖(Store Map)
這是超商取貨獨有、也最常被忘記的一環:讓買家在結帳時選「要去哪間門市取貨」。你需要串接超商的門市電子地圖,讓買家挑門市後,把門市代號帶回你的訂單。沒有這步,後面根本建不了寄件單。
3. 建立寄件單(取號)
把訂單的收件人、選定門市代號、商品資訊、代收金額(如是貨到付款)送出,換回一組寄件編號/物流追蹤碼與可列印的標籤。示意結構:
// 示意用途,實際欄位以服務商文件為準
POST /cvs/shipment/create
{
"merchant_order_no": "訂單編號-對帳用",
"logistics_type": "CVS_C2C", // 取貨模式
"store_id": "門市代號-來自電子地圖",
"receiver_name": "王小明",
"receiver_phone": "0912345678",
"goods_amount": 1200,
"is_collection": true // 是否貨到付款代收
}
// 回傳:{ "logistics_no": "xxxx", "payment_no": "取貨編號", "label_url": "..." }
4. 貨態回拋與取貨通知
超商取貨的貨態比宅配多幾個關鍵節點:到店、可取貨、已取貨、逾期未取退回。務必接好貨態回拋,尤其「可取貨」要自動發通知給買家去拿,「逾期未取」要能自動處理退貨,這兩個沒顧好,逆物流會很痛。
超商取貨最容易出包的地方
| 坑 | 後果 | 怎麼避免 |
|---|---|---|
| 門市代號沒正確帶回 | 寄件單建立失敗 | 電子地圖選店後嚴格驗證 store_id 才放行結帳 |
| 逾期未取沒流程 | 貨退回一堆、退款對不齊 | 接「逾期退回」貨態,自動觸發退貨與退款 |
| 貨到付款對帳漏洞 | 代收金額對不起來 | 用 merchant_order_no 貫穿,定期跟超商對帳單勾稽 |
| 門市庫存/暫停收件沒處理 | 買家選了無法取貨的門市 | 依電子地圖即時狀態過濾不可用門市 |
| 包裹尺寸超過超商限制 | 被拒收、白跑一趟 | 結帳時依商品材積擋掉不適用超取的訂單 |
結論:超商取貨自動化,是電商「省人力、少客訴」的關鍵
把超商取貨串進系統後,訂單能自動產生寄件單、自動通知取貨、自動處理逾期退回,出貨人力省一大半,「我的貨到了嗎」的客訴也大幅下降。搭配金流與物流一起串的電商自動化,整條「下單到取貨」就能自己跑完。
電商這塊我們做過 Lionelo Taiwan 的品牌購物站,以及歐柏家居與第一網的購物平台,實際成品都在購物平台案例裡,金流物流串接的做法可以直接看成果。
我們做過黑貓、宅配通、超商取貨加金流一起串的整合案。如果你手上有電商系統想串超商取貨、又不想踩上面那些逾期退貨與對帳的坑,把你的平台與出貨量告訴我們,可以先幫你判斷該走 C2C 還是 B2C、要花多少工。
RoamerHost 幫你把開源 AI 與自動化工具一鍵代管:獨立 Docker、自動 SSL、24/7 監控,60 秒上線。省下租機器、裝環境、顧維運的力氣,訂閱就能開始用。
▶立即免費註冊常見問題
超商取貨的 C2C 和 B2C 差在哪?我該選哪個?
什麼是門市電子地圖?一定要串嗎?
沒有工程師,也能做超商取貨自動化嗎?
超商取貨最容易出包的是什麼?
這個主題的完整脈絡、選型比較與導入建議,都整理在指南裡。
訂閱免費電子報
把 AI 自動化、企業系統設計與 WordPress / Laravel 開發的真實案例和可直接照做的技巧,整理成電子報寄給你。只寄精選內容、不灌垃圾信,一鍵就能退訂。