微信小程序 小程序使用·updatePrinter

2022-05-11 15:15 更新

logistics.updatePrinter

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

配置面單打印員,可以設置多個,若需要使用微信打單 PC 軟件,才需要調(diào)用。

調(diào)用方式:

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

HTTPS 調(diào)用

請求地址

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

請求參數(shù)

屬性 類型 默認值 必填 說明
access_token string 接口調(diào)用憑證
openid string 打印員 openid
update_type string 更新類型
tagid_list string 用于平臺型小程序設置入駐方的打印員面單打印權(quán)限,同一打印員最多支持10個tagid,使用半角逗號分隔,中間不加空格,如填寫123,456,表示該打印員可以拉取到tagid為123和456的下的單,非平臺型小程序無需填寫該字段

update_type 的合法值

說明 最低版本
bind 綁定
unbind 解除綁定

返回值

Object

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

errcode 的合法值

說明 最低版本
0 成功
-1 系統(tǒng)失敗
9300517 update_type 不正確

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

{
  "openid": "oJ4v0wRAfiXcnIbM3SgGEUkTw3Qw",
  "update_type": "bind",
  "tagid_list": "123,456"
}

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

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

云調(diào)用

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

接口方法

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

請求參數(shù)

屬性 類型 默認值 必填 說明
openid string 打印員 openid
updateType string 更新類型
tagidList string 用于平臺型小程序設置入駐方的打印員面單打印權(quán)限,同一打印員最多支持10個tagid,使用半角逗號分隔,中間不加空格,如填寫123,456,表示該打印員可以拉取到tagid為123和456的下的單,非平臺型小程序無需填寫該字段

updateType 的合法值

說明 最低版本
bind 綁定
unbind 解除綁定

返回值

Object

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

errCode 的合法值

說明 最低版本
0 成功

異常

Object

拋出的異常

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

errCode 的合法值

說明 最低版本
-1 系統(tǒng)失敗
9300517 update_type 不正確

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

const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
  try {
    const result = await cloud.openapi.logistics.updatePrinter({
        openid: 'oJ4v0wRAfiXcnIbM3SgGEUkTw3Qw',
        updateType: 'bind',
        tagidList: '123,456'
      })
    return result
  } catch (err) {
    return err
  }
}

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

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


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

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號