首页 生活常用 快递散件下单
快递散件下单

快递散件下单

  • 134
  • 150
提供韵达、圆通、申通、中通、百世、极兔等快递物流公司下单、更新、取消订单、运费估算等功能。
免费
https://api.jisuapi.com/expressorder/add
JSON
POST
https://api.jisuapi.com/expressorder/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 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 订单号 由我方生成,用来查询订单信息

请求代码:

查看代码
<?php

require_once 'curl.func.php';

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

$url = "https://api.jisuapi.com/expressorder/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'];

/**
 * 生成签名 
 * 
 */
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":"20210000000001233"
	}
}
                    

API错误码:

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

系统错误码:

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

活动推荐ACTIVITY 更多

  • orc活动

其它推荐RECOMMENDED DATA 更多