打印电子面单
调用打印电子面单接口可以打印面单返回快递单号;进行快速发货;需要快递点提供月结账号 和购买打印机才可以使用;
打印机目前可以使用汉引打印机,快递100打印机打印80mm内的面单都是可以使用的
请求语法
请求头
名称 | 类型 | 是否必填 | 示例值 | 描述 |
Authorization | 字符串 | 是 | -- | 授权TOKEN |
请求参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
com | 字符串 | 是 | -- | 快递公司编码 |
to_name | 字符串 | 否 | -- | 收件人姓名 |
to_tel | 字符串 | 是 | -- | 收件人的手机号,手机号和电话号二者其一必填 |
to_addr | 字符串 | 是 | -- | 收件人所在完整地址 |
from_name | 字符串 | 是 | -- | 寄件人姓名 |
from_tel | 字符串 | 是 | -- | 寄件人的手机号,手机号和电话号二者其一必填 |
temp_id | 字符串 | 是 | -- | 电子面单模板编码 |
count | 字符串 | 是 | -- | 物品总数量 |
siid | 字符串 | 否 | -- | 打印设备编码。通过打印机输出的设备码进行获取 |
partner_id | 字符串 | 否 | -- | 电子面单客户账户或月结账号,需向快递公司在贵司当地的网点申请,物流公司列表中的partner_id=1时必须填写 |
partner_key | 字符串 | 否 | -- | 电子面单密码,需向快递公司在贵司当地的网点申请,物流公司列表中的partner_key=1时必须填写 |
cargo | 字符串 | 否 | -- | 可选,物品名称 |
net | 字符串 | 否 | -- | 可选,收件网点名称,由快递公司当地网点分配 |
code | 字符串 | 否 | -- | 可选,收件网点名称,由快递公司当地网点分配 |
partnerSecret | 字符串 | 否 | -- | 可选,电子面单密码,需向快递公司在贵司当地的网点申请 |
checkMan | 字符串 | 否 | -- | 可选,电子面单承载快递员名 |
partner_name | 字符串 | 否 | -- | 可选,收件网点名称,由快递公司当地网点分配 |
pay_type | 字符串 | 否 | -- | 可选,支付方式:SHIPPER:寄方付(默认);CONSIGNEE:到付;MONTHLY:月结;THIRDPARTY:第三方支付 |
order_id | 字符串 | 否 | -- | 可选,贵司内部自定义的订单编号,需要保证唯一性,非必填 |
weight | 字符串 | 否 | -- | 可选,物品总重量(单位:KG) |
valinsPay | 字符串 | 否 | -- | 可选,保价额度 |
print_type | 字符串 | 否 | -- | 可选,打印类型,NON:只下单不打印(默认); IMAGE:生成图片短链;HTML:生成html短链; CLOUD:使用快递100云打印机打印,使用CLOUD时siid必填 |
height | 字符串 | 否 | -- | 可选,打印纸的高度,以mm为单位默认130 |
width | 字符串 | 否 | -- | 可选,打印纸的宽度,以mm为单位默认76 |
exp_type | 字符串 | 否 | -- | 可选,快递类型:标准快递(默认),顺丰特惠,EMS经济 |
remark | 字符串 | 否 | -- | 自定义备注 |
响应元素
名称 | 类型 | 示例值 | 描述 |
data | 对象 | -- | 返回数据,详细查看data响应 |
status | 数字 | 200 | 请求状态;200=请求成功;400=请求失败 |
msg | 字符串 | success | 请求文字描述 |
data响应(主要关注以下字段信息)
名称 | 类型 | 示例值 | 描述 |
taskId | 字符串 | -- | 任务id |
kuaidinum | 字符串 | -- | 快递单号 |
label | 字符串 | -- | 快递面单图片地址 |