1、移動端APP、公眾號、電商等提供的散客寄件下單模塊，通過上門取件直接預約快遞員上門攬件，支持在線支付運費；
2、電商平臺、自營電商售后退貨退款時，買家通過平臺直接預約快遞員上門攬件，支持在線支付運費；
| 功能 | 功能描述 | 應用場景 |
|---|
| 超區校驗接口 | 校驗該地區是否支持上門取件，以及3天內可支持的上門取件時間段。 | 場景一：寄件人老七，選擇從深圳向北極村寄快遞，通過超區檢驗接口，提前了解到深圳寄北極村線上平臺沒有快遞支持。于是選擇線下找快遞公司寄快遞。 |
| 場景二：寄件人老七，選擇從深圳向北京寄快遞，通過超區校驗接口，通過校驗通知了解到，北京兩會期間，停止快遞。于是老七決定等兩會過去再寄快遞。 |
| 場景三：寄件人老七，選擇從深圳向廣州寄快遞，通過超區校驗接口，發現是支持的。并根據支持的預約時段9～14.14～19點，選擇14～19點進行下單。 |
| 單渠道預估運費接口 | 用于根據客戶收寄地址預估運費，僅做參考，不作為最終結算運費。 | 寄件人老七，在客戶平臺手機端下單上門取件，在填寫完成寄收信息和預估重量后，看到手機端提示預估運費10元，于是選擇下單。 |
| 多渠道預估運費接口 | 用于根據客戶收寄地址、預估重量計算返回預估運費，僅做參考，不作為最終結算運費，當前端展示多個快遞公司預估運費時使用此接口 | 寄件人老七，選擇客戶的手機端進行寄快遞，在填寫完寄收信息和預估重量后，看到手機端展示的每家快遞公司的快遞費是不同的，于是選擇申通快遞進行下單。 |
| 下單接口 | 1、用于創建客戶預約快遞上門取件訂單（以下文中統稱為“訂單”）
2、客戶創建訂單成功后（快遞鳥已接收到此訂單，但未提交到快遞公司），快遞鳥智能調度向快遞公司下單，結果會通過回調類接口把訂單狀態、快遞公司編碼、運單號、網點、快遞員等信息回推給客戶。 | 場景一：移動端APP、公眾號、電商等提供的散客寄件下單模塊，通過上門取件直接預約快遞員上門攬件，支持在線支付運費。 |
| 場景二：電商平臺、自營電商售后退貨退款時，買家通過平臺直接預約快遞員上門攬件，支持在線支付運費。 |
| 場景三：保價相關 |
| 訂單取消接口 | 1、用于取消客戶創建的訂單
2、已取件狀態后的訂單無法取消 | 售后場景：
1、寄件人【老七】，在客戶電商平臺申請售后審核通過后，選擇下單上門取件，因各種原因，取消售后業務（同步取消上門取件）。
1、寄件人【老七】，在客戶電商平臺申請售后審核通過后，選擇下單上門取件，因各種原因，取消上門取件，重新下單（上門取件） |
正向寄件場景：
1、寄件人【老七】，在客戶平臺選擇下單上門取件，因各種原因，取消上門取件，不再寄快遞。 |
| 修改訂單接口 | 下單成功并且未取件的訂單進行基本信息修改，接口調用成功之后，修改結果通過修改訂單通知回推給客戶 | 場景一：寄件人老七，選擇上門取件時間為周六上午9～11點寄件，下單完成后，發現周六上午沒時間，于是修改上門取件新的預約時間為周日的13～15點。 快遞員最終在周日14點上門攬件。 |
| 場景二：寄件人老七，選擇上門取件時間為周六上午9～11點從家里寄件，下單完成后，發現物品在公司，于是修改上門取件新的寄件地點。快遞員最終在周六11點在公司上門攬件。 |
| 訂單信息查詢接口 | 用于查詢客戶創建成功的訂單基本信息 | 用戶的上門取件訂單下單后，用戶查看上門取件訂單詳情。如：寄收地址信息，預約時段、訂單最新狀態。 |
| 訂單狀態查詢接口 | 此接口用于快遞鳥訂單狀態列表查詢，獲取最新訂單狀態。 | 客戶訂單狀態長時間未更新，可用此接口查詢最新訂單狀態信息，作為訂單狀態更新的一個補償機制。 |
| 工單類型查詢 | 此接口用于獲取快遞鳥工單類型，提交工單的時候需要根據此類型進行提交。 | 客戶在后臺或用戶端，通過查詢工單類型，查看快遞鳥支持的工單類型。然后用戶選擇對應的工單類型進行提交工單。 |
| 工單提交接口 | 此接口用于提交工單，工單處理結果通過推送工單結果接口推回給客戶 | 場景一：對接客戶有自己的后臺工單系統，為便于統一運營管理，于是對接快遞鳥工單接口。 |
| 場景二：客戶的用戶端提供工單業務，于是對接快遞鳥工單接口，讓用戶直接使用工單。 |
| 工單詳情查詢接口 | 此接口用于獲取快遞鳥工單詳情 | 寄件人老七，在客戶手機端有多個上門取件工單，老七在進入工單列表頁，查看所有的上門取件工單。客戶調用此接口，快遞鳥返回工單列表給到客戶，客戶在手機端展示給用戶老七。老七點開第一個工單，查看工單詳情。 |
快遞
航空貨運
快運
鐵路貨運
國際海運
整車貨運
跨境小包
即時配送
粵公安備案號：44030402002993
