首页 生活常用 快递电子面单
快递电子面单

快递电子面单

  • 134
  • 150
提供韵达、圆通、申通、中通、百世、极兔等快递物流公司电子面单下单、更新、取消订单等功能。下单后会返回可打印的面单内容,并自动推送物流轨迹信息,无需订阅。请在我的API那里填写订单状态通知URL,物流状态通知URL。您还可以使用单号订阅接口里的单号查询主动获取物流信息。
600.00 /10000次
申请就送10次
每满600减30
https://api.jisuapi.com/expressebill/add
JSON
POST
https://api.jisuapi.com/expressebill/add?appkey=yourappkey

请求参数:

API在线测试
参数名称类型必填说明
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面单内容"
    }
}
                    

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元/次

活动推荐ACTIVITY 更多

  • orc活动

其它推荐RECOMMENDED DATA 更多