文档介绍：【场景需求描述】电商平台及ISV商家对物流api接口的需求有很多,今天我们主要分享的就是快递鸟快递单号查询接口的对接指南,快递单号查询接口对接的应用场景有很多,很多场景会遇到,最主要的就是电商网站用户打开“我的订单”时调用此API显示物流信息详情,电商管理后台的物流系统,客服在对账前查询所有运单的签收状态,并追踪问题,电商平台对商家物流管控,要求必须在多久快递必须发出要看到揽件状态,多久必须收到货物看到签收状态,根据这些状态对商家管控从而提高用户的整体满意度。下图是电商平台、买家、商家的下单发货流程图。 【对接使用流程】1、将快递单号和快递公司编码发送給快递鸟2、快递鸟根据单号和快递公司查询到物流轨迹状态3、快递鸟将查询到的物流轨迹状态反馈給电商平台或ISV服务商4、电商平台或ISV服务商接收数据并实时处理做数据展示或应用 【接口描述说明】(1)查询接口支持按照运单号查询(单个查询)。(2)接口需要指定快递单号的快递公司编码,格式不对或则编码错误都会返失败的信息。如:EMS物流单号应选择快递公司编码(EMS)查看快递公司编码(3)返回的物流跟踪信息按照发生的时间升序排列。(4)接口指令1002。(5)接口支持的消息接收方式为HTTPPOST,请求方法的编码格式(utf-8):"application/x-ded;charset=utf-8"。(6)测试地址:http://sandboxapi.:8080/kdniaosandbox/gateway/(7)正式地址:http://api./Ebusiness/:参数名称类型说明必须要求RequestData String 请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。 REBusinessID String 商户ID,请在我的服务页面查看。 RRequestType String 请求指令类型:1002 RDataSign String 数据内容签名:把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后进行URL(utf-8)编码。详细过程请查看Demo。 RDataType String 请求、返回数据类型:2-json; O备注:R-必填(Required),O-可选(Optional),C-报文中该参数在一定条件下可选(Conditional)【接口参数】请求内容字段定义:参数名称类型说明必须要求OrderCode String 订单编号 OShipperCode String 快递公司编码 ode String 物流单号 R返回参数定义:参数名称类型说明必须要求EBusinessID String 用户ID ROrderCode String 订单编号 OShipperCode String 快递公司编码 ode String 物流运单号 ess Bool 成功与否 RReason String 失败原因 OState String 物流状态:2-在途中,3-签收,4-问题件 eptTime String 时间 eptStation String 描述 RRemark String 备注 O【示例】请求示例JSON{"OrderCode":"","ShipperCode":"SF","ode":"1**********"}返回示例JSON没有物流轨迹的{"EBusinessID":"1109259","Traces":[],"OrderCode":"","ShipperCode":"SF","ode":"1**********","ess":false,"Reason":null}有物流轨迹的{"EBusinessID":"1109259","OrderCode":"","ShipperCode":"SF","ode":"1**********","ess":true,"State":3,"Reason":null,"Traces":[{"AcceptTime":"2014/06/2508:05:37","AcceptStation":"正在派件..(派件人:邓裕富,电话:**********)[深圳市]","Remark":null},{"AcceptTime":"2014/06/2504:01:28","AcceptStation":"快件在深圳集散中心,准备送往下一站深圳[深圳市]","Remark":null},{"AcceptTime":"2014/06/2501:41:06","AcceptStation":"快件在深圳集散中心[深圳市]","Remark":