电子面单[简]

企业专用个人高级认证支持MCP

批量打印面单，支持多家快递面板

¥79.2

立即购买

产品功能
接口文档

功能介绍

数字化信息录入

电子面单允许快递公司和客户通过电子方式快速录入和处理包裹信息，减少了手动填写的错误和时间消耗。

自动化处理

与自动化分拣系统相结合，电子面单可以加快包裹的分拣速度，提高物流中心的处理能力。

实时追踪

电子面单与物流追踪系统相结合，可以实时更新包裹的位置和状态，为客户提供更准确的追踪信息。

环境友好

由于减少了纸张的使用，电子面单有助于减少物流行业的碳足迹，是一种更加环保的选择。

数据安全

采用先进的加密技术，如AES、AES+RSA，确保您的物流信息在传输过程中的安全和保密。

官方渠道

直接连接各大物流公司的官方数据源，确保您获取的信息准确无误，可靠性高。

高准确率

提供高达99.99%的查询准确率，帮助您有效避免因信息错误导致的物流风险。

稳定强大

系统7天24小时持续运行，支持高并发访问，适应各种物流查询需求，确保服务不中断。

应用场景

快递公司

快递公司使用电子面单来提高包裹处理的自动化水平，减少人工成本，提高服务质量。

电商平台

电商平台在客户下单后自动生成电子面单，简化了订单处理流程，提高了发货效率。

物流软件

物流管理软件可以与电子面单系统集成，提供更加全面的物流解决方案。

提升客户体验

实时追踪和快速获取包裹信息提升了客户的物流体验。

产品参数

性能

与官方同步

更新频率

查得计费

计费模式

99%

数据覆盖

业务

60QPS

并发连接

平均500ms

回调时长

https/http

支持协议

使用流程

账号注册

点击「免费注册」输入手机号和验证码完成注册

立即注册

开通服务

开通相关的功能服务

查看服务

开发和联调

获取AppKey/AppSecret进行API调用

测试文档

开始使用

开始使用云客通的功能

开始使用

合作客户

服务保障

可靠安全

提供高可用、低延迟的服务，实施严格的安全措施，确保业务的稳定运行和数据安全。

服务专业

专业团队提供全方位的售前和售后服务，随时解决您的疑问和问题。

数据合规

严格遵守数据保护法规，官方直连获取数据，确保数据的合法、合规。

灵活持续

提供多样接口，并持续更新，以满足您不断变化的业务和商业需求。

接口文档

电子面单

错误码

错误码列表

电子面单

接口地址: 接口详情请点击

请求方式: post

返回类型: Json

请求Header:

名称	值
Content-Type	application/x-www-form-urlencoded;charset=utf-8

请求参数说明:

名称	必填	类型	说明
appid	是	string	您的appid
sign	是	string	签名
requestData	是	string	应用参数，各字段含义参见下述说明（JSON字符串）

requestData请求参数

名称	类型	是否必需	示例值	描述
timestamp	Long	是		毫秒级时间戳
cpCode	String	是	YTO	快递公司编码，详见附录
orderCode	String	是		客户请求的订单号，不可重复
customerName	String	是	如果没有此账号，请联系合作的快递网点负责人申请	电子面单账号（也称客户编码、客户号、月结账号等）
customerPwd	String	否		客户密码（如果需要）
sendSite	String	否		发货站点（如果需要）
sendStaff	String	否		发货员工（如果需要）
monthCode	String	否		月结代码（如果需要）
payType	Int	是		运费支付方式：1：现付，2：到付，3：月结，4：第三方付顺丰跨越，4：回单付京运达
expType	String	是		业务类型
jdType	Int	否		京东平台类型（京东必填）：1：京东开放平台，2：京东宙斯平台
sender	Sender	是		参考下面的发件人信息结构体
receiver	Receiver	是		参考下面的收件人详细信息结构体
quantity	Int	是		包裹数（至少填1，最多50）一个包裹对应一个运单号，quantity＞1，返回则按照子母件的方式返回母运单号和子运单号
weight	Double	否		包裹总重量kg（京东必填，快运类必填）
volume	Double	否		包裹总体积m³（京东必填，快运类必填）
cost	Double	否		快递运费（信丰物流，中通快运支付方式为到付时必填）
packageType	String	否		包装类型（仅支持跨越速运）：10-打卡板，20-打木架，30-打木箱
otherCost	Double	否		其他费用
addService	List	否		附加服务信息
remark	String	否		备注
commodity	List	是		参考下面的商品信息结构体
templateSize	String	否		模板尺寸（默认模板无需传值，非默认模板传对应尺寸）
customArea	String	否		自定义文本（可以打印店铺名称或者商品信息等）
transType	Int	否		配送产品类型
packingType	Int	否		包装类型
deliveryMethod	Int	否		送货方式/派送类型/配送方式（安能必填）
callback	String	否		自定义回传字段
warehouseId	String	否		发货仓编码（京东，汇霖速运，汇森速运必填）
thrOrderCode	String	否		第三方平台订单号
isNotice	Int	否		是否通知快递员上门揽件：0 - 通知，1 - 不通知（默认）
startDate	String	否		上门取货开始时间段（京东快运必填；其他快递isNotice=0时必填，格式为yyyy-MM-dd HH:mm:ss）
endDate	String	否		上门取货结束时间段（京东快运必填；其他快递isNotice=0时必填，格式为yyyy-MM-dd HH:mm:ss）
memberID	String	否		ERP系统、电商平台等系统或平台类型用户的会员ID或店铺账号等唯一性标识（汇霖速运、汇森速运必填）
isReturnSignBill	Int	否		是否要求签回单：0 - 不要求，1 - 要求
operateRequire	String	否		签回单操作要求（如：签名、盖章、身份证复印件等）
currencyCode	String	否		货物单价的币种（顺丰港澳台必填）：CNY - 人民币，HKD - 港币，NTD - 新台币，MOP - 澳门元
dutiable	Dutiable	否		参考下面的申报价值信息结构体
logisticCode	String	否		快递单号（仅宅急送可用）
mailNo	String	是		运单号
phone	String	否		电话号码，传入尾号后四位。顺丰（SF）必填。1. 传值错误无法获取到顺丰轨迹；2. 虚拟号不可用；3. 尽量使用寄件人号码；4. 顺丰号码正确性可通过微信小程序“顺丰速运+”验证
consignTime	String	否		发货时间
orderTime	String	否		下单时间
platformCode	String	是		各电商平台编码：天猫 - TMIAO，淘宝 - TBAO，京东 - JDONG，拼多多 - PDUODUO，抖店 - DDIAN，其他 - QITA
warehouseCode	String	否		仓库编码

发件人信息 Sender

名称	类型	是否必需	示例值	描述
company	String	否	XXX公司	发件人公司名称
name	String	是	张三	发件人名称
mobile	String	是	15899998888	手机号和电话号必填一个
tel	String	否	028-85310290
postCode	String	否	1100210	发件地邮编邮政/EMS 必填可填000000
provinceName	String	是	（如广东省，不要缺少“省”）	发件省
cityName	String	是	（如深圳市，不要缺少“市”）	发件市
expAreaName	String	是	（如福田区，不要缺少“区”或“县”）	发件区
address	String	是	详细地址	地址

收件人信息 Receiver

名称	类型	是否必需	示例值	描述
company	String	否	XXX公司	收件人公司名称
name	String	是	张三	收件人名称
mobile	String	是	15899998888	手机号和电话号必填一个
tel	String	否	028-85310290
postCode	String	否	1100210	收件地邮编邮政/EMS 必填可填000000
provinceName	String	是	（如广东省，不要缺少“省”）	收件省
cityName	String	是	（如深圳市，不要缺少“市”）	收件市
expAreaName	String	是	（如福田区，不要缺少“区”或“县”）	收件区
address	String	是	详细地址	地址

商品信息 Commodity

名称	类型	是否必需	描述
goodsName	String	是	商品名称
goodsCode	String	否	商品编码
goodsQuantity	Int	否	商品数量
goodsPrice	Double	否	商品价格百腾物流必填
goodsWeight	Double	否	商品重量kg
goodsDesc	String	否	描述
goodsVol	Double	否	商品体积m³

申报价值 Dutiable

名称	类型	是否必需	示例值	描述
declaredValue	Double	否		订单货物总声明价值，包含子母件，精确到小数点后3位

请求示例:

JSON返回示例：


{
	"appid": "你的appid",
	"sign": "1a2e36de8a7092ca1dcd99c368b8ce5f",
	"requestData": {
		"cpCode": "EMS",
		"orderCode": "EMS00000002",
		"customerName": "test",
		"customerPwd": "test",
		"sendSite": "",
		"sendStaff": "",
		"monthCode": "testytomonthcode",
		"payType": "1",
		"expType": "1",
		"receiver": {
			"Company": "test",
			"Name": "zhangsan",
			"Mobile": "138088080",
			"ProvinceName": "北京",
			"CityName": "北京市",
			"ExpAreaName": "朝阳区",
			"Address": "三里屯街道"
		},
		"sender": {
			"Company": "test",
			"Name": "wangwu",
			"Mobile": "13202022222",
			"ProvinceName": "上海",
			"CityName": "上海市",
			"ExpAreaName": "宝山区",
			"Address": "水产路"
		},
		"quantity": "1",
		"commodity": [{
			"GoodsName": "药品"
		}],
		"templateSize": "130"
	}
}

响应参数:

字段名称	类型	字段含义
success	Boolean	成功:true 失败:false
errorCode	String	响应码
errorMsg	String	消息体
orderCode	String	订单号
printTemplate	String	面单打印模板内容（html格式）
subCount	String	子单数量
subOrders	String	子单单号（数组形式）
subPrintTemplates	String	子单模板内容（html格式）
order	String	参考下面的订单信息结构体

订单信息 Order

名称	类型	是否必需	描述
orderCode	String	是	订单编号
shipperCode	String	是	快递公司编码
logisticCode	String	是	快递单号
markDestination	String	否	大头笔
signWaybillCode	String	否	签回单单号
originCode	String	否	始发地区域编码
originName	String	否	始发地/始发网点
destinatioCode	String	否	目的地区域编码
destinatioName	String	否	目的地/到达网点
sortingCode	String	否	分拣编码
packageCode	String	否	集包编码
packageName	String	否	集包地
destAllCen	String	否	目的地分拨
transType	Int	否	配送产品类型
transportType	Int	否	运输方式
shipInfo	String	否

正确返回示例

JSON返回示例：


{
	"success": true,
	"errorCode": null,
	"errorMsg": "该订单号已下单成功",
	"printTemplate": "...",
	"order": {
		"orderCode": "SF000004",
		"shipperCode": "SF",
		"logisticCode": "SF1605147284414",
		"markDestination": null,
		"signWaybillCode": null,
		"originCode": "021",
		"originName": null,
		"destinatioCode": "010W-BF-715",
		"destinatioName": null,
		"sortingCode": null,
		"packageCode": null,
		"packageName": null,
		"destAllCen": null,
		"transType": 0,
		"transportType": 0,
		"shipInfo": null
	}
}

错误返回示例

JSON返回示例：


{
    "success": false,
    "errorCode": "400",
    "errorMsg": "接口调用失败-收方地址不详细，请填写更为详细的地址后重新下单。",
    "printTemplate": null,
    "subCount": 0,
    "subOrders": null,
    "subPrintTemplates": null,
    "order": null
}

服务级错误码参照(error_code)：

响应结果

字段含义

success

true	请求成功
false	请求失败

errorCode

201	快递单不存在，请确认运单号或者快递公司是否正确
202	查询顺丰快递请指定手机号后四位
203	服务器繁忙,请稍后再试
204	当前快递公司不支持，请选择正确的快递公司编码
205	订阅失败，请稍后再试
54	请求参数有误，返回详细的错误信息，如必填快递编码参数未传值，则返回“快递公司编码不能为空”
209	调用频繁，请稍后再试
301	回调数据校验错误
302	接口不允许调用
400	接口调用失败
401	运单号未订阅，请先调用订阅接口后再调用此接口
402	subCallBackUrl字段不能为空
403	订阅失败，请检查顺丰手机号或入参是否正确

完整示例代码分享：

	语言	标题	提供者	时间
	java	yunketongApiDemo.java(5 KB)	2020-10-15 13:17:24

电子面单[简]

数据驱动未来

Data Drives The Future

立即注册

确认支付

电子面单[简]

产品功能

接口文档

功能介绍

应用场景

产品参数

使用流程

合作客户

服务保障

电子面单

请求Header:

请求参数说明:

requestData请求参数

发件人信息 Sender

收件人信息 Receiver

商品信息 Commodity

申报价值 Dutiable

请求示例:

响应参数:

订单信息 Order

正确返回示例

错误返回示例

推荐API

API资讯