快递电子面单

提供韵达、圆通、申通、中通、百世、极兔等快递物流公司电子面单下单、更新、取消订单等功能。下单后会返回可打印的面单内容，并自动推送物流轨迹信息，无需订阅。请在我的API那里填写订单状态通知URL，物流状态通知URL。您还可以使用单号订阅接口里的单号查询主动获取物流信息。

￥600.00/10000次

申请就送10次

接口已下架

接口地址： https://api.jisuapi.com/expressebill/add

返回格式： JSON

请求方法： POST

请求示例： https://api.jisuapi.com/expressebill/add?appkey=yourappkey

请求参数：

在线测试

参数名称	类型	必填	说明
type	string	是	快递公司
senderprovince	string	是	寄件省份
sendercity	string	是	寄件城市
sendertown	string	是	寄件县/区
senderaddress	string	是	寄件人地址
sendername	string	是	寄件人姓名
sendermobile	string	是	寄件人手机号(手机号和电话二选一)
sendertel	string	是	寄件人电话(手机号和电话二选一)
sendercompany	string	否	寄件公司
senderzipcode	string	否	寄件邮编
addresseeprovince	string	是	收件省份
addresseecity	string	是	收件城市
addresseetown	string	是	收件县/区
addresseeaddress	string	是	收件人详细地址
addresseename	string	是	收件人姓名
addresseemobile	string	是	收件人手机号(手机号和电话二选一)
addresseetel	string	是	收件人电话(手机号和电话二选一)
addresseecompany	string	否	收件公司
addresseezipcode	string	否	收件邮编
product	string	是	物品清单此处传json片段格式：[{"name":"名称","num":"数量","remark":"备注"}]
ordertype	int	是	订单类型 1普通 2代收货款 3到付 4保价
orderremark	string	否	订单备注
accountid	string	是	电子面单账号ID
password	string	是	电子面单密码
weight	string	否	重量
dimension	string	否	物品尺寸长宽高单位米
freighttype	string	否	运费类型
producttype	int	否	物品类型 0文件类 1电子产品类(包括家用电器) 2办公用品类/服装鞋帽/箱包类 3化妆品/美容产品类 4珠宝/手表/眼镜/贵重饰品类 5食品/保健药品类 6工艺品类(包括瓷器、茶具、烹饪用品) 7玩具/乐器类 8其他类 9大件
freight	string	否	运费
isnotice	int	否	是否通知快递员取件 1是 0否默认0
starttime	string	否	取件开始时间
endtime	string	否	取件结束时间
collectionamount	string	否	代收货款金额
insuredamount	string	否	保价金额
sign	string	是	签名MD5加密规则参考代码

返回参数：

参数名称	类型	说明
orderno	string	订单号由我方生成，用来查询订单信息
number	string	快递单号
ebill	string	电子面单信息
packageplace	string	集包地名称
code1	string	三段码中的第一段
code2	string	三段码中的第二段
code3	string	三段码中的第三段
qrcode	string	自动化二维码
startbranchcode	string	始发网点代码
printhtml	string	可打印的面单内容

请求代码：

查看代码

<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey

$url = "https://api.jisuapi.com/expressebill/add?appkey=$appkey";
$appsecret = 'ssssssssssss';
$post = ['type'=>'', 'senderprovince'=>'', 'sendercity'=>'', 'sendertown'=>'', 'senderaddress'=>'', 'sendername'=>'', 'sendermobile'=>'', 'sendertel'=>'', 'sendercompany'=>'', 'senderzipcode'=>'', 'addresseeprovince'=>'', 'addresseecity'=>'', 'addresseetown'=>'', 'addresseeaddress'=>'', 'addresseename'=>'', 'addresseemobile'=>'', 'addresseetel'=>'', 'addresseecompany'=>'', 'addresseezipcode'=>'', 'product'=>'', 'ordertype'=>'', 'orderremark'=>'', 'accountid'=>'', 'password'=>'', 'weight'=>'', 'dimension'=>'', 'freighttype'=>'', 'producttype'=>'', 'freight'=>'', 'isnotice'=>'', 'starttime'=>'', 'endtime'=>'', 'collectionamount'=>'', 'insuredamount'=>''];//不包含appkey
$post['sign'] = makeSign($post, $appsecret);
$result = curlOpen($url, ['ssl'=>true, 'post'=>$post]);

$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));

if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
echo $result['orderno'].' '.$result['number'].' '.$result['printhtml'];
foreach($result['ebill'] as $key=>$val)
{
	echo $val['packageplace'].' '.$val['code1'].' '.$val['code2'].' '.$val['code3'].' '.$val['qrcode'].' '.$val['startbranchcode'];
}

/**
 * 生成签名 
 * 
 */
function makeSign($queryarr, $appsecret)
{
    ksort($queryarr, SORT_STRING);
    $str = implode($queryarr);
    $str .= $appsecret;
    //exit($str);
    $str = md5($str);
    
    return $str;
}

JSON返回示例 :

{
    "status": 0,
    "msg": "ok",
    "result": {
        "orderno": "2021000000000",
        "number": "557039103353913",
        "ebill": {
            "packageplace": "上海分拨",
            "code1": "073",
            "code2": "00",
            "code3": "01",
            "qrcode": "",
            "startbranchcode": "",
			"shortaddress":"416A"
        },
        "printhtml": "可打印的HTML面单内容"
    }
}

接口地址： https://api.jisuapi.com/expressebill/update

返回格式： JSON

请求方法： POST

请求示例： https://api.jisuapi.com/expressebill/update?appkey=yourappkey

请求参数：

在线测试

参数名称	类型	必填	说明
type	string	是	快递公司
senderprovince	string	是	寄件省份
sendercity	string	是	寄件城市
sendertown	string	是	寄件县/区
senderaddress	string	是	寄件人地址
sendername	string	是	寄件人姓名
sendermobile	string	是	寄件人手机号(手机号和电话二选一)
sendertel	string	是	寄件人电话(手机号和电话二选一)
sendercompany	string	否	寄件公司
senderzipcode	string	否	寄件邮编
addresseeprovince	string	是	收件省份
addresseecity	string	是	收件城市
addresseetown	string	是	收件县/区
addresseeaddress	string	是	收件人详细地址
addresseename	string	是	收件人姓名
addresseemobile	string	是	收件人手机号(手机号和电话二选一)
addresseetel	string	是	收件人电话(手机号和电话二选一)
addresseecompany	string	否	收件公司
addresseezipcode	string	否	收件邮编
product	string	否	物品清单此处传json片段格式：[{"name":"名称","num":"数量","remark":"备注"}]
ordertype	int	否	订单类型
orderremark	string	否	订单备注
accountid	string	是	电子面单账号ID
password	string	是	电子面单密码
weight	string	否	重量
dimension	string	否	物品尺寸长宽高单位米
freighttype	string	否	运费类型
producttype	int	否	物品类型
freight	string	否	运费
isnotice	int	否	是否通知快递员取件 1是 0否默认0
starttime	string	否	取件开始时间
endtime	string	否	取件结束时间
collectionamount	string	否	代收货款金额
insuredamount	string	否	保价金额
sign	string	是	签名MD5加密规则参考代码
orderno	string	是	订单号

返回参数：

参数名称	类型	说明
orderno	string	订单号
number	string	快递单号
ebill	string	电子面单信息
packageplace	string	集包地名称
code1	string	三段码中的第一段
code2	string	三段码中的第二段
code3	string	三段码中的第三段
qrcode	string	自动化二维码
startbranchcode	string	始发网点代码
printhtml	string	可打印的面单内容

请求代码：

查看代码

<?php

require_once 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey

$url = "https://api.jisuapi.com/expressebill/update?appkey=$appkey";
$appsecret = 'ssssssssssss';
$post = ['type'=>'', 'senderprovince'=>'', 'sendercity'=>'', 'sendertown'=>'', 'senderaddress'=>'', 'sendername'=>'', 'sendermobile'=>'', 'sendertel'=>'', 'sendercompany'=>'', 'senderzipcode'=>'', 'addresseeprovince'=>'', 'addresseecity'=>'', 'addresseetown'=>'', 'addresseeaddress'=>'', 'addresseename'=>'', 'addresseemobile'=>'', 'addresseetel'=>'', 'addresseecompany'=>'', 'addresseezipcode'=>'', 'product'=>'', 'ordertype'=>'', 'orderremark'=>'', 'accountid'=>'', 'password'=>'', 'weight'=>'', 'dimension'=>'', 'freighttype'=>'', 'producttype'=>'', 'freight'=>'', 'isnotice'=>'', 'starttime'=>'', 'endtime'=>'', 'collectionamount'=>'', 'insuredamount'=>''];//不包含appkey
$post['sign'] = makeSign($post, $appsecret);
$result = curlOpen($url, ['ssl'=>true, 'post'=>$post]);

$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));

if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
echo $result['orderno'].' '.$result['number'].' '.$result['printhtml'];
foreach($result['ebill'] as $key=>$val)
{
	echo $val['packageplace'].' '.$val['code1'].' '.$val['code2'].' '.$val['code3'].' '.$val['qrcode'].' '.$val['startbranchcode'];
}

JSON返回示例 :

{
    "status": 0,
    "msg": "ok",
    "result": {
        "orderno": "2021000000000",
        "number": "557039103353913",
        "ebill": {
            "packageplace": "上海分拨",
            "code1": "073",
            "code2": "00",
            "code3": "01",
            "qrcode": "",
            "startbranchcode": "",
			"shortaddress":"416A"
        },
        "printhtml": "可打印的HTML面单内容"
    }
}

接口地址： https://api.jisuapi.com/expressebill/cancel

返回格式： JSON

请求方法： POST

请求示例： https://api.jisuapi.com/expressebill/cancel?appkey=yourappkey

请求参数：

在线测试

参数名称	类型	必填	说明
orderno	string	是	订单号
number	string	是	快递单号
sign	string	是	签名MD5加密规则参考代码

返回参数：

参数名称	类型	说明
orderno	string	订单号
number	string	快递单号

请求代码：

查看代码

<?php

require 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$appsecret = 'ssssssssssss';
$post = ['type'=>'yunda', 'orderno'=>'201601241155888', 'number'=>'77888855888'];
$post['sign'] = makeSign($post, $appsecret);
$url = "https://api.jisuapi.com/expressebill/cancel?appkey=$appkey";
$result = curlOpen($url, ['ssl'=>true, 'post'=>$post]);

$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));
if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
echo $result['orderno'];

JSON返回示例 :

{
	"status":0,
	"msg":"ok",
	"result":{
		"orderno":"2021000000000"
	}
}

接口地址： https://api.jisuapi.com/expressebill/query

返回格式： JSON

请求方法： POST

请求示例： https://api.jisuapi.com/expressebill/query?appkey=yourappkey

请求参数：

在线测试

参数名称	类型	必填	说明
orderno	string	是	订单号
sign	string	是	签名MD5加密规则参考代码

返回参数：

参数名称	类型	说明
type	string	快递公司
orderno	string	订单号
number	string	快递单号
logisticsstatus	int	物流状态 1运输中 2派件中 3已签收 4签收失败 5收件扫描 6揽件扫描 7入中转 8出中转 9第三方代收入库 10第三方代收快递员取出 11退回件 12问题件 13拒收 14其他 15海外件入库扫描 16海外件出库扫描 17清关开始 18清关结束 19清关失败 20海外件干线到达 21海外件干线离开 22转单 23揽收失败 24已打包
printhtml	string	可打印的面单内容
ebill	string	电子面单信息
packageplace	string	集包地名称
code1	string	三段码中的第一段
code2	string	三段码中的第二段
code3	string	三段码中的第三段
startbranchcode	string	始发网点代码
qrcode	string	自动化二维码

请求代码：

查看代码

<?php

require 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$url = "https://api.jisuapi.com/expressebill/query?appkey=$appkey";
$result = curlOpen($url, ['ssl'=>true]);

$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));
if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
echo $result['orderno'].' '.$result['number'].' '.$result['printhtml'];
foreach($result['ebill'] as $key=>$val)
{
	echo $val['packageplace'].' '.$val['code1'].' '.$val['code2'].' '.$val['code3'].' '.$val['qrcode'].' '.$val['startbranchcode'];
}

JSON返回示例 :

{
	"status":0,
	"msg":"ok",
	"result":{
		"type":"sto",
		"orderno":"2021000000000",
		"number":"557039103353913",
		"logisticsstatus":"1",
		"printhtml":"可打印的HTML面单内容",
		"ebill":{
			"packageplace":"上海分拨",
			"code1":"073",
			"code2":"00",
			"code3":"01",
			"startbranchcode":"",
			"qrcode":"416A"
		}
	}
}

接口地址： https://api.jisuapi.com/expressebill/type

返回格式： JSON

请求方法： GET

请求示例： https://api.jisuapi.com/expressebill/type?appkey=yourappkey

请求参数：

在线测试

参数名称	类型	必填	说明

返回参数：

参数名称	类型	说明
name	string	快递公司名称
type	string	快递公司
letter	string	首字母
tel	string	电话
number	string	快递单号

请求代码：

查看代码

<?php

require 'curl.func.php';

$appkey = 'your_appkey_here';//你的appkey
$url = "https://api.jisuapi.com/expressebill/type?appkey=$appkey";
$result = curlOpen($url, ['ssl'=>true]);

$jsonarr = json_decode($result, true);
//exit(var_dump($jsonarr));
if($jsonarr['status'] != 0)
{
    echo $jsonarr['msg'];
    exit();
}

$result = $jsonarr['result'];
foreach($jsonarr['result'] as $val)
{
    echo $val['name'].' '.$val['type'].'
';
}

JSON返回示例 :

{
    "status": 0,
    "msg": "ok",
    "result": [        
        {
            name: "中通",
			type: "ZTO",
			letter: "Z",
			tel: "95311",
			number: "421447644512",
			logo: "https://api.jisuapi.com/express/static/images/logo/80/zto.png"
        },
        {
            name: "圆通",
			type: "YTO",
			letter: "Y",
			tel: "021-69777888 021-69777999",
			number: "100668657244",
			logo: "https://api.jisuapi.com/express/static/images/logo/80/yto.png"
        },
        {
            name: "韵达",
			type: "YUNDA",
			letter: "Y",
			tel: "95546",
			number: "1202237859178",
			logo: "https://api.jisuapi.com/express/static/images/logo/80/yunda.png"
        },
        {
            name: "申通",
			type: "STO",
			letter: "S",
			tel: "95543",
			number: "403234843091",
			logo: "https://api.jisuapi.com/express/static/images/logo/80/sto.png"
        },
        {
            name: "百世快递",
			type: "HTKY",
			letter: "H",
			tel: "4009565656",
			number: "350630538314",
			logo: "https://api.jisuapi.com/express/static/images/logo/80/htky.png"
        },
        {
            name: "顺丰",
			type: "SFEXPRESS",
			letter: "S",
			tel: "95338",
			number: "952727764582",
			logo: "https://api.jisuapi.com/express/static/images/logo/80/sfexpress.png"
        }
    ]
}

接口地址：您设定的URL

返回格式： Array

请求方法： POST

请求示例：您设定的URL

接口说明：通知成功以后，需要输出“success”字符串

请求参数：

在线测试

参数名称	类型	必填	说明

返回参数：

参数名称	类型	说明
status	int	物流状态
orderno	string	订单号
type	string	快递公司
number	string	快递单号
statusdesc	string	物流状态描述快递公司原样返回

请求代码：

查看代码

<?php

$post = $_POST;
$sign = $_POST['sign'];
unset($post['sign']);

$appsecret = '123456789';//用户appsecret
if(checkSign($post, $appsecret, $sign))
{
    //0待处理 1已接单 2接单成功 3订单取消 4订单打回 5修改取件时间 6分配业务员 7业务员上门取件 8订单失败 10订单完成
    $status = trim($_POST['status']);
    $orderno = trim($_POST['orderno']);    
    $type = trim($_POST['type']);
    $number = trim($_POST['number']);
    
    echo 'success';
    exit();
}

JSON返回示例 :

接口地址：您设定的URL

返回格式： Array

请求方法： POST

请求示例：您设定的URL

接口说明：通知成功以后，需要输出“success”字符串

请求参数：

在线测试

参数名称	类型	必填	说明

返回参数：

参数名称	类型	说明
type	string	快递公司
orderno	string	订单号
number	string	快递单号
time	string	时间
status	int	物流状态
city	string	城市
branch	string	网点
nextcity	string	下一站城市
nextbranch	string	下一站名称
description	string	物流节点描述
deliverymobile	string	快递员电话
logisticsstatus	string	物流状态
list	string	轨迹列表
statusdesc	string	物流状态描述快递公司原样返回

请求代码：

查看代码

<?php

$post = $_POST;
$sign = $_POST['sign'];
unset($post['sign']);

$appsecret = '123456789';//用户appsecret
if(checkSign($post, $appsecret, $sign))
{
    $type = trim($_POST['type']);
    $orderno = trim($_POST['orderno']);
    $number = trim($_POST['number']);
	$logisticsstatus = trim($_POST['logisticsstatus']);
    $deliverymobile = trim($_POST['deliverymobile']);
	$list = json_decode(trim($_POST['list']), true);
    foreach($list as $val)
    {
        $time = trim($val['time']);    
        $city = trim($val['city']);
        $branch = trim($val['branch']);
        $nextcity = trim($val['nextcity']);
        $nextbranch = trim($val['nextbranch']);
        $description = trim($val['description']);
    }
    
    echo 'success';
    exit();
}

JSON返回示例 :

API错误码：

代号	说明
201	快递公司为空
202	不支持的快递公司
203	快递单号为空
204	快递单号错误
205	寄件人姓名不能为空
206	收件人姓名不能为空
207	寄件人省市都不能为空
208	订单号和快递单号不能都为空
209	收件人省市都不能为空
210	寄件人地址不能为空
211	收件人地址不能为空
212	寄件人手机号和电话不能都为空
213	收件人手机号和电话不能都为空
214	订单不存在
215	请在后台绑定账号密码
216	面单密码为空
217	签名为空
218	验签失败
230	未知错误

系统错误码：

代号	说明
101	APPKEY为空或不存在
102	APPKEY已过期
103	APPKEY无请求此数据权限
104	请求超过次数限制
105	IP被禁止
106	IP请求超过限制
107	接口维护中
108	接口已停用

计次套餐	套餐规格	价格
免费套餐	10次	0.00 元	≈0元/次
Level1	10000次	600.00 元	≈0.06元/次
Level2	50000次	2600.00 元	≈0.052元/次
Level3	100000次	4700.00 元	≈0.047元/次
Level4	1000000次	31000.00 元	≈0.031元/次