快递查询-物流查询-快递物流查询接口介绍

目前电商、货运等行业都需要快递查询功能对运单号的物流轨迹进行跟踪。通过快递查询接口可以实时查询物流轨迹。支持顺丰、京东、EMS、申通、圆通、宅急送、韵达、中通、百世、天天、四通一达等1500物流公司与物流公司官网同步。可以实现将快递查询功能集成到自有的系统中方便用户实时跟踪物流信息。比如电商网站直接在“我的订单”页面内就能看到订单的物流状态。改变订单的状态和交易流程例如单号变为“已签收”就能让订单变为可以确认退换货等。物流平台可以自动筛选出“已签收”、“疑难件”等状态的单号减轻物流跟单人员的压力。评估选择快递公司根据“已签收”的运单数可以算出销售人员的业绩且便于应对货到付款的结算。请求参数名称类型必须说明numberString是运单编号expressCodeString否快递公司编号 例如圆通:YTO。快递公司编号不传时系统会自动识别快递公司编号但响应时间会比传递快递编号略长mobileString否顺丰速运、中通、跨越速运需要传入收/寄件人手机号或后四位手机号sortString否物流明细排序desc倒序asc升序默认asc成功返回样例{code:200,// 详见code返回码说明msg:成功,// code 对应的描述charge:true,// 计费标志taskNo:30853523396532582768,// 本次请求号data:{expressCode:ZTO,// 快递公司编号expressCompanyName:中通快递,// 快递公司名称expressCompanyLogo:,// 快递公司logonumber:73171992731469,// 运单编号logisticsStatus:SIGN,// 物流状态详见物流状态编码对照表;logisticsStatusDesc:已签收,// 物流状态描述theLastMessage:快件已在金华孝顺签收 签收人本人。如有疑问请电联15888996643, 投诉电话0579-82977127, 您的快递已经妥投。风里来雨里去, 只为客官您满意。上有老下有小, 赏个好评好不好【请在评价快递员处帮忙点亮五颗星星哦~】,// 运单号物流流转当前最新描述theLastTime:2021-11-23 12:24:58,// 运单号物流流转当前最新变更时间takeTime:2天17小时33分,//从揽收到送达所耗时间courier:付村二部傅军,// 快递员courierPhone:15888996643,// 快递员联系方式logisticsTraceDetails:[// 物流明细{time:1632123146000,// 物流变更时间logisticsStatus:ACCEPT,// 物流状态 详见物流状态编码对照表subLogisticsStatus:ACCEPT,// 物流子状态 详见物流状态编码对照表desc:【杭州电商仓配揽投部】已收寄,揽投员:刘岭,电话:13754324900,//物流路由信息描述内容areaCode:CN330100000000,// 路由节点所在地区行政编码, 未必会返回areaName:浙江省,杭州市// 路由节路由节点所在地区},{time:1632140994000,logisticsStatus:TRANSPORT,subLogisticsStatus:TRANSPORT,desc:离开【杭州电商仓配揽投部】,下一站【杭州萧山区东片集散中心】,areaCode:CN330100000000,areaName:浙江省,杭州市},...]}}物流状态对照表序号物流主状态物流子状态1WAIT_ACCEPT: 待揽收RECEIVE: 接单中WAIT_ACCEPT: 待揽收2ACCEPT: 已揽收ACCEPT: 已揽收3TRANSPORT: 运输中TRANSPORT: 运输中ON_THE_WAY: 在途中SEND_ON: 转单或修改地址转寄ARRIVE_CITY: 到达目的城市4DELIVERING: 派件中DELIVERING: 派件中STA_INBOUND: 已放入快递柜或驿站5AGENT_SIGN: 已代签收AGENT_SIGN: 已代签收6SIGN:已签收SIGN: 已签收STA_SIGN: 从快递柜或者驿站取出RETURN_SIGN:退回签收7FAILED:包裹异常FAILED: 包裹异常TIMEOUT_UNSIGEN: 超时未签收TIMEOUT_NO_UPDATE: 超时未更新REFUSE_SIGN: 拒收DELIVER_ABNORMAL: 派件异常STA_TIMEOUT_UNSIGEN: 快递柜或者驿站超时未取CONTACT_FAIL: 无法联系OVER_AREA: 超区RETENTION: 滞留件ISSUE: 问题件RETURN: 退回件SEND_NO_MESSAGE: 发货无信息DAMAGE: 破损CANCEL_ORDER:揽件取消示例代码importcom.anq.core.utils.HttpUtil;importcom.anq.core.utils.JsonUtil;importlombok.extern.slf4j.Slf4j;importorg.apache.commons.codec.digest.DigestUtils;importorg.junit.Test;importjava.util.HashMap;importjava.util.Map;Slf4jpublicclassExamples{StringappId;StringappSecret;StringapiUrl;Testpublicvoidexamples(){longtimestampSystem.currentTimeMillis();StringsignDigestUtils.sha256Hex(appIdappSecrettimestamp);// 生成signMapString,ObjectparamsnewHashMapString,Object();params.put(appId,appId);//params.put(timestamp,timestamp);params.put(sign,sign);params.put(productCode,express_query);// 固定值params.put(expressCode,);// 快递公司编号 例如圆通:YTO详见快递公司编码对照表params.put(number,);// 运单编号params.put(mobile,);// 手机号 顺丰速运、中通、跨越速运需要传入收/寄件人手机号或后四位手机号params.put(sort,);// 物流明细排序 desc倒序asc升序默认ascStringresultJsonHttpUtil.postForm(apiUrl,null,params);log.info(resultJson);JumeiOpenApiResponsejumeiOpenApiResponseJsonUtil.toObject(resultJson,JumeiOpenApiResponse.class)if(jumeiOpenApiResponse.getCode()200){//TODO}else{//TODO}}}