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

    • # 新增面单模板

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

    接口英文名：ewaybill_createtemplate

    可通过该接口新增面单模板

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/channels/ec/logistics/ewaybill/biz/template/create?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是快递公司编码
    infoobject是模板信息

    # Body.info Object Payload

    模板信息

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

    # Body.info.options(Array) Object Payload

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

    参数名类型必填说明
    option_idnumber是信息类型，填0-7，不得重复，枚举值详情请参考下文
    font_sizenumber是打印字号，0 默认大小，1 加大
    is_boldboolean否字体是否加粗
    is_openboolean否是否选用此信息

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误信息
    delivery_idstring快递公司编码
    template_idstring模板编码

    # 4. 注意事项

    option_id信息类型

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

    # 5. 代码示例

    请求示例

    {
	"delivery_id": "xxxx",
	"info": {
		"template_name": "name_xxxx",
		"template_desc": "快递一联单",
		"template_type": "single",
		"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": 6,
				"font_size": 0,
				"is_bold": false,
				"is_open": true
			},
			{
				"option_id": 7,
				"font_size": 0,
				"is_bold": false,
				"is_open": true
			}
		],
		"is_default": true
	}
}

    返回示例

    {
    "errcode": 0,
    "errmsg": "ok",
    "delivery_id": "XXX",
    "template_id": "xxxxxxxxxx"
}

    # 6. 错误码

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

    错误码错误描述解决方案
    10025102快递公司不支持
    10025103同一快递公司下，模板id重复
    10025104同一快递公司下 模板名重复
    10025105模板名太长，size > 200
    10025106模板ID不存在
    10025107options 长度错误
    10025108options.option_id 参数不合法
    10025109模板名为空
    10025110模板ID为空

    # 7. 适用范围

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