7-11 交貨便 API 串接：C2C 標籤、貨態、對帳的專屬眉角

做電商的大概都經歷過：商品上架完、金流串好了，卡在最後一哩物流。台灣的超商取貨裡，7-11 交貨便（C2C）是量最大也最常被指定的一個，但它的串接眉角跟黑貓、全家不太一樣。我們寫過超商取貨 API 串接總覽，這篇專攻 7-11 交貨便：電子地圖怎麼接、貨態怎麼回、對帳怎麼不出錯，以及跟其他物流商放在一起時的差異。適合已經知道要串超取、要動手的人。本文工具與規格查證於 2026 年 10 月 15 日，規格以綠界物流 API 文件與 7-ELEVEN 賣貨便官方幫助中心為準。

先分清楚：你要的是 C2C 還是 B2C

這是最多人一開始就搞混、後面整包重來的地方。C2C（交貨便）是賣家把商品拿去超商寄、買家到另一家超商取，賣家不需要跟超商簽大宗合約，適合中小型賣家，綠界物流服務裡對應的物流子類型代碼是 UNIMARTC2C。B2C（大宗寄倉）是賣家把貨送進物流中心、再由物流中心配到門市，需要跟超商或整合商簽約，綠界的代碼是 UNIMART，冷凍店取另有 UNIMARTFREEZE。多數中小電商要的是 C2C，這篇也以 C2C 為主。選錯型別，申請流程、費率、API 參數全部不同。

怎麼判斷自己該走哪一邊？問兩個問題：有沒有人每天把包裹拿去門市？有沒有簽大宗合約的量？兩題都是「沒有」，就是 C2C。我們在API 串接金流與物流的電商自動化實戰裡談過，很多賣家一開始想一步到位接 B2C，結果出貨量撐不起合約門檻，白走一輪申請流程。

串接的四段，各段的眉角

第一段，門市電子地圖

買家結帳時要選取貨門市，這一步走物流商提供的電子地圖服務：網站把買家導去地圖頁，他選完店，地圖頁把門市資料 POST 回你設定的 ServerReplyURL。以綠界為例，送出時帶 LogisticsType=CVS、LogisticsSubType=UNIMARTC2C、IsCollection（是否代收貨款）與 ExtraData（會原值回傳，拿來帶訂單暫存編號剛好）。

7-11 專屬的眉角有三個。第一，綠界文件明寫 UNIMART 與 UNIMARTC2C 不會回傳門市名稱、地址、電話，只回門市代號 CVSStoreID；全家會回整組，7-11 不會。所以結帳頁要顯示「取貨門市：○○門市」，得自己用門市代號去對門市清單，不能像接全家那樣直接把回傳值印出來。第二，文件禁止用 iframe 嵌地圖、iOS 不可另開新視窗、行動裝置要允許 Cookie，這三條違反任何一條，買家就會卡在選店那一步。第三，測試環境是固定門市、不會跳出地圖，所以「測試環境沒看到地圖」不是壞掉，是正常的；但也代表選店流程的真正驗證要在正式環境做。回傳處理的原則不變：驗證門市代號、把它跟這張訂單綁好，否則後面建單會失敗。

第二段，建立托運單（寄件）

訂單成立後，呼叫建單 API 產生這筆的物流訂單。綠界的必填欄位裡，ReceiverStoreID 是 6 碼門市代號，GoodsAmount 範圍 1 到 20,000 元，超出會收到錯誤代碼 10500040；代收貨款時，7-11 的代收金額必須等於商品金額。C2C 還多三條規則：GoodsName 與 SenderCellPhone 不可為空；SenderName 限 2 到 5 個中文字、不可含數字，而且文件特別提醒不要填公司名稱，因為未取退回原寄件門市時要出示身分證件領取，寫公司名會領不到；ReturnStoreID（退貨門市）只有 7-11 C2C 吃，其他超商帶了仍退回原寄件門市。

建單成功會回 AllPayLogisticsID（綠界物流交易編號，文件要求跟自家訂單編號建立對應並保存）、CVSPaymentNo（寄貨編號）與 CVSValidationNo（驗證碼，只有 7-11 C2C 會回）。7-11 的交貨便代碼就是這兩個欄位的組合，賣家拿這組代碼到門市 ibon 列印服務單、貼上包裹交寄。這段的時間壓力是：依 7-ELEVEN 官方幫助中心，取號後需於 4 天（含第 4 天）內交寄，超過就轉為訂單取消；對應到綠界貨態是 7013「訂單超過驗收期限（賣家未出貨）」。後台一定要把寄件截止日明顯標出來，最好在到期前一天推播給出貨人員。

第三段，貨態回傳

包裹的狀態變化由物流商透過綠界 POST 到你設定的 ServerReplyURL。接收端有四件事要做對。一，驗 CheckMacValue，文件直接寫「若不判斷，請賣家會員自行承擔損失」。二，回應純字串 1|OK，不能有 HTML 標籤或空白，沒回或回錯都視為失敗。三，失敗會重送：三次後延到隔天再發，從貨態更新日起維持三天，所以接收端要做到同一筆貨態重複收到也不會重複觸發出貨、退款或通知。四，通知不是即時的，依物流中心與綠界的排程回傳，太久沒收到更新可以改用查詢物流訂單 API 反查，不要只等推播。

最容易漏的仍然是逆物流：「逾期未取」與「退回」。C2C 的逾期未取包裹會退回原寄件門市，系統要能自動處理這個回頭流，不然帳對不上、退款會卡住。哪幾個代碼一定要接，下一節列表。

第四段，對帳

超取的貨款流向依金流設計而不同：貨到付款要跟物流商對帳、預付則是純物流費。重點是把「物流狀態」跟「金流狀態」在系統裡對起來：已取貨才算完成、逾期退回要觸發退款。做不好的典型症狀是月底一堆狀態卡在中間的訂單：貨退回來了金流還顯示未退、或顯示已完成但實際逾期未取。金流那一側的狀態設計，WordPress 金流串接完整指南有寫；要開發票的話，電商該自己串電子發票嗎那篇談了取貨付款與發票開立時點怎麼配。

貨態代碼：哪幾個一定要接

綠界把各物流商的貨態代碼整理成一份下載檔，而且註明會不定時更新。7-11 C2C（UNIMARTC2C）的代碼超過 50 個，不必全接，但下面這幾個是訂單狀態機的骨架，少接一個就會有訂單卡在中間。

兩個提醒。第一，代碼是每家物流商各自一套：同樣是「包裹配達取件門市」，7-11 C2C 是 2073、全家 C2C 是 3018；「買家已到店取貨」7-11 是 2067、全家是 3022。程式裡不要用數字比對，要在物流方式層把每家代碼對應到自家的統一狀態（已出貨、已到店、已取貨、逾期退回、退件已領）。第二，2074 到 2093 這一整段都是「買家未取退回物流中心」的細分原因（超材、標籤無法判讀、門市關轉、爆量），對帳只需要知道「退回了」，但客服會想知道「為什麼退回」，所以原始代碼與訊息要存下來，不要只留對應後的狀態。

交貨便的時間規則，要做成系統裡的提醒

以下是 7-ELEVEN 賣貨便官方幫助中心公告的常溫店取規則，透過綠界開通的 C2C 走的是同一套門市作業，數字以官方最新公告為準：

1. 出貨期限：訂單成立後 60 天內要取得交貨便代碼（取貨付款可拉長到 90 天）。
2. 交寄期限：取號後 4 天（含第 4 天）內交寄，逾期轉為訂單取消。
3. 包裹限制：最長邊 45 公分以內、三邊合計 105 公分以內、重量 10 公斤以內，不符門市不收件；多箱不可綑綁成一箱。
4. 買家取貨期：包裹到店後 7 日內取貨，賣貨便平台會發簡訊與 Email 通知；逾期退回原寄件門市。
5. 賣家領回期：退回原寄件門市後 7 日內帶證件免費取回；沒領的送物流中心，自送達日起留置 15 天，可自費申請宅配寄回，逾期視同放棄。
6. 取回費用：未取貨件取回服務費原價 35 元，官方公告推廣期間免收，調整前會提前 30 日公告。
7. 運費：賣貨便公告常溫店取原價 60 元、特價 38 元；經綠界等整合商開通的費率以合約為準，程式裡不要寫死。
8. 撥款：賣貨便平台的代收貨款，週一至週三取貨成功的款項隔週週一入帳，週四至週日的款項隔週週三入帳，遇假日順延。

這八條每一條都該對應到系統裡的一個欄位或一個排程：寄件截止日、取貨截止日、領回截止日、留置截止日。把日期算出來存進訂單，比到時候人工翻貨態查得快，也才做得到「截止前一天提醒」。我們在可擴展的自動化出貨引擎那篇談過同樣的概念：物流商的規則會改，所以天數要放設定檔，不要散在程式碼裡。

跟黑貓、全家放一起的差異

多數電商不會只接一家。實務上的差異：7-11 與全家的超取邏輯類似（都是店到店、賣家門市交寄、買家門市取貨），但門市代號系統、電子地圖回傳欄位、費率、逾期天數、貨態代碼各自不同，不能共用同一套參數。黑貓是宅配，送到府、由司機收送，回傳的是托運單號 BookingNote 而不是寄貨編號，流程跟超取完全不同，我們在黑貓宅急便 API 串接完整教學單獨寫過。

把三者放進同一套出貨流程時，正確做法是抽象出一層「物流方式」，每家的差異收在各自的設定裡，訂單流程只跟這層對話，而不是在程式裡到處寫 if 7-11、if 全家。這一層至少要收四樣東西：物流子類型代碼、電子地圖回傳欄位的對應（7-11 要自己補門市名稱）、貨態代碼到統一狀態的對應表、各物流商的天數規則。做到這樣，之後要加萊爾富 HILIFEC2C 或 OK 超商，是新增一筆設定，不是改一輪程式。整體的多物流架構，WordPress 串接黑貓、宅配通、超取物流 API與WordPress 物流 API 串接完整指南兩篇有程式層的做法。

金流那一側怎麼跟物流搭，以及 WooCommerce 上的整體配置，在WooCommerce 台灣金流物流完整指南有完整的一條龍；退貨與客訴流程要不要交給自動化處理，AI 接管 WooCommerce 退貨與客訴的復盤裡有踩過的坑。

我們的做法：先把訂單狀態機畫出來再寫程式

接超取最常見的失敗，不是 API 打不通，是狀態沒想清楚就開始寫。我們做物流串接時固定先做三件事。第一，把訂單的狀態機畫出來：待出貨、已取號、已交寄、已到店、已取貨、逾期退回、退件已領、已取消，每個狀態標清楚由哪個貨態代碼或哪個人工動作觸發。第二，把每家物流商的代碼對到這張圖，對不上的代碼全部歸到「異常，需人工」，不要硬塞。第三，所有貨態通知先原封不動寫進一張記錄表再處理，重複收到就靠這張表擋掉，出問題也有原始資料可以查。

WooCommerce 的話，超取門市選擇要塞進結帳流程，門市欄位的顯示與驗證會動到結帳頁，WooCommerce 結帳頁面怎麼改那篇有店主自己動得了與該找工程師的界線。整個串接的進行方式與驗收節奏，看我們的合作流程；要先評估自家訂單量該接哪幾家，需求偵察可以先跑一輪。超取串接看起來規格單純，真正吃工的是逆物流與對帳的邊角，這也是我們在客製系統開發與AI 自動化開發裡最常被找來補的那一段。

資料來源與查證

本文工具與規格查證於 2026 年 10 月 15 日。綠界物流子類型代碼、電子地圖回傳欄位、建單必填欄位與金額限制、貨態通知的回應與重送規則，以 綠界物流整合 API 技術文件、門市電子地圖、門市訂單建立、物流狀態通知與物流狀態代碼一覽表為準；交寄期限、取貨期限、包裹限制、退回留置天數、取回費用與撥款時程，以 7-ELEVEN 賣貨便官方幫助中心為準。貨態代碼與費率各物流商會不定時更新，串接前請以官方最新文件為準。

延伸閱讀

• 超商取貨 API 串接完整教學（總覽）
• 黑貓宅急便 API 串接完整教學
• WooCommerce 台灣金流物流串接指南
• WordPress 金流串接完整指南
• 電商該自己串電子發票嗎