微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # 根据模板id荻取面单模板信息

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

    接口英文名：ewaybill_gettemplatebyid

    可通过该接囗根据模板id获取面单模板信息

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/channels/ec/logistics/ewaybill/biz/template/getbyid?access_token=ACCESS_TOKEN

    # 云调用

    • 本接口不支持云调用

    # 第三方调用

    • 本接口支持第三方平台代商家调用。

    • 该接口所属的权限集 id 为：130、159

    • 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

    # 2. 请求参数

    # 查询参数 Query String parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token、authorizer_access_token

    # 请求体 Request Payload

    参数名类型必填说明
    delivery_idstring是快递公司编码
    template_idstring是模板id

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误信息
    template_infoobject模板信息

    # Res.template_info Object Payload

    模板信息

    参数名类型说明
    template_idstring模板id
    template_namestring模板名，同一快递公司下不可重复
    template_descstring模板描述 默认填 "一联单标准模板"
    template_typestring模板类型 默认填 "single"
    optionsobjarray模板信息选项，总数必须为8个，顺序按照数组序
    is_defaultboolean是否为该快递公司默认模板
    create_timenumber模板创建时间
    update_timenumber模板更新时间

    # Res.template_info.options(Array) Object Payload

    模板信息选项，总数必须为8个，顺序按照数组序

    参数名类型说明
    option_idnumber信息类型，填0-7，枚举值详情请参考下文
    font_sizenumber打印字号
    is_boldboolean字体是否加粗
    is_openboolean是否选用此信息

    # 4. 注意事项

    option_id信息类型

    枚举值 描述
    0 商品总数量
    1 商品名称+规格+编码+数量
    2 商品名称+规格+数量
    3 商品名称+数量
    4 店铺名称
    5 订单号
    6 买家留言
    7 卖家备注

    # 5. 代码示例

    请求示例

    {
    "delivery_id": "xxxx",
    "template_id": "66xxxxxxxxxx6"
}

    返回示例

    {
  "errcode": 0,
  "errmsg": "ok",
  "template_info": {
    "template_id": "66xxxxxxxxxx6",
    "template_name": "naxxxxxxxx2",
    "template_desc": "一联单标准模板",
    "template_type": "single",
    "create_time": 1693291995,
    "update_time": 1693291995,
    "is_default": true,
    "options": [
      {
        "option_id": 0,
        "font_size": 0,
        "is_bold": false,
        "is_open": false
      },
      {
        "option_id": 1,
        "font_size": 0,
        "is_bold": false,
        "is_open": true
      },
      {
        "option_id": 2,
        "font_size": 0,
        "is_bold": false,
        "is_open": false
      },
      {
        "option_id": 3,
        "font_size": 0,
        "is_bold": false,
        "is_open": false
      },
      {
        "option_id": 4,
        "font_size": 0,
        "is_bold": false,
        "is_open": true
      },
      {
        "option_id": 5,
        "font_size": 0,
        "is_bold": false,
        "is_open": true
      },
      {
        "option_id": 7,
        "font_size": 0,
        "is_bold": false,
        "is_open": true
      },
      {
        "option_id": 6,
        "font_size": 0,
        "is_bold": false,
        "is_open": true
      }
    ]
  }
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码

    错误码错误描述解决方案
    10025102快递公司不支持
    10025106模板ID不存在
    10025120电子面单帐号为空，请新增账号
    10025125模板列表为空，请新增模板

    # 7. 适用范围

    本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。