一、Express查询地图轨迹1.1接口格式提供统一格式的HTTPPOST或GET调用接口,返回格式支持JSON、xml、text、html数据。1.2请求地址https://poll.kuaidi100.com/po...请求参数:参数名称是否必填类型说明customer为字符串授权码,请申请企业版获取sign为字符串签名身份验证,按param按+key+customer的顺序进行MD5加密(注意字符串加密后必须转为32位大写),不需要加“+”号param为param拼接byotherfieldsparam数据结构:参数名称是否必填类型说明com字符串查询为快递公司编码,全部小写num为字符串查询的快递单号,单号最大长度为32个字符只能填写一个。顺丰快递运单号为必填项,其他快递公司可不填。如果座机号码有分机号码,分机号码不需要上传。)from为字符串的起点信息,如:广东省深圳市南山区金蝶软件园to为字符串的终点信息,如:北京市朝阳区国际金融大厦shownostringreturnformat:0:json格式(默认),1:xml,2:html,3:textorder无字符串返回结果排序:desc降序(默认),asc升序orderTime无字符串排序下单时间,格式为(yyyy-MM-ddHH:mm:ss)如:2020-12-1612:59:591.3请求实例customer=**sign=**param={"com":"ems","num":"em263999513jp","phone":"13868688888","from":"深圳市南山区广东金蝶软件园","to":"北京市朝阳区国际金融大厦","show":"0","order":"desc","orderTime":"2020-12-1612:59:59"}1.4返回结果字段名称类型字段含义messageString消息体,请忽略stateInteger快递订单当前状态,包括0在途,1收到,2问题,3签收,4退回,5派送,6退回,7中转单,10待清关,11清关进行中,12清关,13清关异常,14收件人拒收等13状态statusIntegercommunicationstatus,请忽略conditionString快递单明细状态标志,尚未实现,请忽略ischeckInteger是否签收标记,请忽略,详见状态字段comString快递公司代码,均为小写nuString单号trailUrlString轨迹图linkarrivalTimeString预计到达时间totalTimeString平均时间remainingTimeString多长时间到达isLoopBooleanisLoopBoolean是是否存在环路└number政区信息代码└name政区信息名称Θdatadata最新查询结果,数组,包含多项,全额,倒序(即最新时间在前),每一项是一个对象,对象包含字段,请展开└contextString内容└timeString时间,原始格式└ftimeString格式化时间└statusString该数据元素对应的签到状态,只有在实时查询界面提交resultv2标签后,行政区域代码该数据元对应的会出现└areaCodeString,只在实时查询界面提交└areaNameString数据元对应的行政区域名称会出现在resultv2标签后,只有在resultv2标签提交后才会出现实时查询接口。1.5提供数据内容{"message":"ok","nu":"YT4781863654577","ischeck":"1","com":"yuantong","status":"200","data":[{"time":"2020-11-3013:19:56","context":"圆通合作点【喵站】快件已到达财富金街大院地商站3号,联系电话18744663997","ftime":"2020-11-3013:19:56","areaCode":null,"areaName":null,"status":"在路上"},{"time":"2020-09-1217:40:58","context":"【广东省深圳市平湖公司】收件人:刘杰珍(18128837173)","ftime":"2020-09-1217:40:58","areaCode":"CN440307003000","areaName":"广东省深圳市龙岗区平湖","status":"收据"}],"state":"3","condition":"00","routeInfo":{"from":{"number":"CN4403","name":"广东,深圳"},"cur":{"number":"CN6101","name":"陕西西安"},"to":{"number":"CN6101","name":"陕西西安"}},"isLoop":false,"trailUrl":"https://api.kuaidi100.com/tools/map/bc80574d538262aecc897a469151f0e3","arrivalTime":"2020-12-1912:00","totalTime":"2天1小时","remainTime":"1day2hours"}1.6运单签收状态服务说明StatusValueNameMeaning0In-transit快件正在运输中1收件快件已被快递公司取件2困难快件100无法解决的状态,或状态需要手动干预,例如收件人电话错误3正常签收4签收货物退回发货人并签收5货物正在派送中6退回货物正在返回发货人的途中7货物中转其他快递公司post10待清关货物等待清关11清关中货物正在清关中12已清关货物已完成清关流程13异常清关货物在流程中出现异常清关14Rejection收件人明确拒收1.7跟踪链接申请示例"style="zoom:60%">1.8错误返回示例{"result":false,"returnCode":"400","message":"Couldnotfindthecorrespondingcompany"}信息代码信息内容描述原因及建议处理方法200查询成功400参数权限问题数据不全,未找到对应公司,非法IP,请申请授权,不支持该快递公司,单号问题等500查询无结果,请稍后再查询一会儿,表示查询失败,快递公司没有拿到有效数据501??Servererror快递100服务器出现空档或者临时异常,有时候如果因为没有按照规范提交请求的话,比如,快递公司的参数没有按照单据填写等等,也会报这个错误。502服务器忙。快递员100的服务器出现处理间隙或临时异常。请联系快递100排查原因。503验证签名失败,请检查加密方式,param+key+customer的顺序用MD5加密,加密后字符串转为大写。601没有可用的订单数量或没有权限使用此功能。企业及终端用户快递单号地图轨迹显示,物流节点文字信息及预计送达时间,物流轨迹信息可视化展示。通过调用地图轨迹接口,可以展示地图轨迹、物流节点信息、预计到达时间、快递订单状态等信息,丰富物流信息展示维度,提升客户查询体验。2.ExpressTrackingMapTrajectoryAPI应用场景在电商网页/APP/小程序中,客户在订单详情中查看所购商品的物流地图轨迹;与物流轨迹文字信息一起展示给客户,使订单在途状态可视化;获取物流路线城市信息,监控配送时效;预估包裹到达时间,并提示包裹需要多长时间到达,识别派送状态,并发送短信提醒客户签收;三、快递查询地图轨迹API收费模式1、收费方式快递查询地图轨迹是一项增值服务,该服务同时支持物流文本信息和地图链接,即包含实时查询接口功能。注册快100企业账号后,即可在企业管理后台查看地图轨迹包价格并进行购买。2、充电价新品限时优惠,活动时间:2021年1月1日-2021年3月31日,充值即可使用。原价/元优惠单价/单价优惠单价/元300020002000050000.0815001000100002000约0.0847505005000500约0.0915010010000.1快递查询图轨按订单计费,一个自然月内多次查询同一运单只收费一次。这个接口是单独收费的。3、开具发票速递100支持开具增值税发票。用户购买完成后,可进入企业管理后台-费用中心-支付记录-索取发票。默认开普通电子增值税发票,1000元以上可开增值税专用发票。官方源码文档:http://api.kuaidi100.com/docu...http://api.kuaidi100.com/docu...
