微信小程序 運力方使用·updatePath

2022-05-11 15:19 更新

logistics.updatePath

本接口應(yīng)在服務(wù)器端調(diào)用,詳細說明參見服務(wù)端API。
本接口支持云調(diào)用。需開發(fā)者工具版本 >= 1.02.1904090(最新穩(wěn)定版下載
wx-server-sdk >= 0.4.0

更新運單軌跡

調(diào)用方式:

  • HTTPS 調(diào)用
  • 云調(diào)用

HTTPS 調(diào)用

請求地址

POST https://api.weixin.qq.com/cgi-bin/express/delivery/path/update?access_token=ACCESS_TOKEN

請求參數(shù)

屬性 類型 默認(rèn)值 必填 說明
access_token string 接口調(diào)用憑證
token string 商戶側(cè)下單事件中推送的 Token 字段
waybill_id string 運單 ID
action_time number 軌跡變化 Unix 時間戳
action_type number 軌跡變化類型
action_msg string 軌跡變化具體信息說明,展示在快遞軌跡詳情頁中。若有手機號碼,則直接寫11位手機號碼。使用UTF-8編碼。

action_type 的合法值

說明 最低版本
100001 攬件階段-攬件成功
100002 攬件階段-攬件失敗
100003 攬件階段-分配業(yè)務(wù)員
200001 運輸階段-更新運輸軌跡
300002 派送階段-開始派送
300003 派送階段-簽收成功
300004 派送階段-簽收失敗
400001 異常階段-訂單取消
400002 異常階段-訂單滯留

返回值

Object

屬性 類型 說明
errcode number 錯誤碼
errmsg string 錯誤信息

errcode 的合法值

說明 最低版本
0 成功
-1 系統(tǒng)失敗
40199 運單 ID 錯誤,未查到運單
9300507 Token 不正確

請求數(shù)據(jù)示例

{
  "token": "TOKEN",
  "waybill_id": "12345678901234567890",
  "action_time": 1533052800,
  "action_type": 300002,
  "action_msg": "麗影鄧麗君【18666666666】正在派件"
}

返回數(shù)據(jù)示例

{
  "errcode": 0,
  "errmsg": "ok"
}

云調(diào)用

云調(diào)用是小程序·云開發(fā)提供的在云函數(shù)中調(diào)用微信開放接口的能力,需要在云函數(shù)中通過 wx-server-sdk 使用。

接口方法

openapi.logistics.updatePath
需在 config.json 中配置 logistics.updatePath API 的權(quán)限,詳情

請求參數(shù)

屬性 類型 默認(rèn)值 必填 說明
token string 商戶側(cè)下單事件中推送的 Token 字段
waybillId string 運單 ID
actionTime number 軌跡變化 Unix 時間戳
actionType number 軌跡變化類型
actionMsg string 軌跡變化具體信息說明,展示在快遞軌跡詳情頁中。若有手機號碼,則直接寫11位手機號碼。使用UTF-8編碼。

actionType 的合法值

說明 最低版本
100001 攬件階段-攬件成功
100002 攬件階段-攬件失敗
100003 攬件階段-分配業(yè)務(wù)員
200001 運輸階段-更新運輸軌跡
300002 派送階段-開始派送
300003 派送階段-簽收成功
300004 派送階段-簽收失敗
400001 異常階段-訂單取消
400002 異常階段-訂單滯留

返回值

Object

屬性 類型 說明
errCode number 錯誤碼
errMsg string 錯誤信息

errCode 的合法值

說明 最低版本
0 成功

異常

Object

拋出的異常

屬性 類型 說明
errCode number 錯誤碼
errMsg string 錯誤信息

errCode 的合法值

說明 最低版本
-1 系統(tǒng)失敗
40199 運單 ID 錯誤,未查到運單
9300507 Token 不正確

請求數(shù)據(jù)示例

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.logistics.updatePath({
        token: 'TOKEN',
        waybillId: '12345678901234567890',
        actionTime: 1533052800,
        actionType: 300002,
        actionMsg: '麗影鄧麗君【18666666666】正在派件'
      })
    return result
  } catch (err) {
    return err
  }
}

返回數(shù)據(jù)示例

{
  "errCode": 0,
  "errMsg": "openapi.logistics.updatePath:ok"
}


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號