《德邦开放平台和第三方接入商交互方案v1.3》由会员分享，可在线阅读，更多相关《德邦开放平台和第三方接入商交互方案v1.3（45页珍藏版）》请在金锄头文库上搜索。
1、 德邦开放平台和第三方接入商交互方案 1 / 45 德邦开放平台和第三方接入商交互方案德邦开放平台和第三方接入商交互方案 版本 V1.3 版本版本 修订说明修订说明 日期日期 作者作者 V0.9 创建 2013-8-13 樊帅、李鹏飞 V1.0 审核“ , “heavyRate“:1, “lightRate“:160, “lowestPrice“:51, “productCode“:“QC_JZQYC“, “productName“:“精准汽运(长途)“, “promiseArriveTime“:“第 3 天到第 4 天“ , “result“:“true“, “resultCode“:“10
2、00“, “uniquerRequestNumber“:“839296208933239“ 4.7 货物跟踪查询货物跟踪查询 4.7.1 接口说明接口说明 根据德邦物流运单号查询货物跟踪信息， 包括运单状态和跟踪信息， 跟踪信息格式大致 如下： 2013-07-27 19:18:40 已收取货物上海市营业网点库存中 2013-07-27 20:29:10 运输中, 离开 上海市营业网点 发往上海市运输中心 2013-07-27 21:12:21 运输中, 已到达 上海市运输中心 2013-07-29 03:30:06 运输中, 离开 上海市运输中心 发往 台州市运输中心 2013-07-29
3、08:15:07 运输中, 离开 台州市运输中心 发往 目的地台州市营业网点 2013-07-29 09:55:38 已到达 目的地台州市营业网点 2013-08-01 19:32:02 正常签收,签收人：五* 德邦开放平台和第三方接入商交互方案 35 / 45 4.7.2 业务流程业务流程 4.7.3 接口规格接口规格 接口名称 货物跟踪货物跟踪 接口提供方 德邦开放平台德邦开放平台 接口调用方 第三方接入平台第三方接入平台 接口内容 传入参数信息：传入参数信息： 参数名称参数名称 用途用途 params 请求参数 digest 密文摘要 timestamp 当前时间戳时间戳 company
4、Code 第三方接入商的公司编码 P Paramsarams 字段含义：字段含义： 字段字段 编码编码 类型类型 长度长度 是是 否否 必必 填填 备注备注 物流公司 ID logisticCompanyID String 32 是 DEPPON 运单 orders 是 仅支持单个运德邦开放平台和第三方接入商交互方案 36 / 45 单号查询 运单号 orders :mailNo String 15 是 德邦物流运单号 返回参数：返回参数： 字段字段 变量名变量名 类型类型 长度长度 是是 否否 必必 填填 备注备注 请求成功标识 result String 8 是 true or false
5、 结果代码 resultCode String 12 是 参见错误码描述 错误原因 reason String 64 否 请求唯一编号 uniquerRequestNumber String 32 是 响应参数 responseParam String 具体响应参数 responseParam 字段字段 变量名变量名 类型类型 长长 度度 是是 否否 必必 填填 备注备注 物流公司 ID logisticCompanyID String 32 是 DEPPON 追踪信息 orders 运单号 orders :mailNo String 32 否 运单状态 orders :orderStatus
6、 String 20 否 GOT:已开单 SIGNSUCCESS:正常签收/异常签收 运单轨迹 orders :steps 运单结果标识 orders :traceCode String 8 是 参见错误码 操作时间 steps :acceptTime Date 是 内容发生时间，format=“yyyy-MM-ddTHH:mm:ss.SSSZ“ 操作备注 steps :remark String 1024 是 货物跟踪内容，纯文本 唯一请求编码 uniquerRequestNumber String 32 是 德邦开放平台和第三方接入商交互方案 37 / 45 4.7.4 业务约束业务约束
7、(1)、货物跟踪接口传入参数为德邦物流运单号，当前支持单个运单号查询。 (2)、返回的信息包括当前运单状态(开单、运输中、签收)和运单跟踪信息。 (3)、运单跟踪信息按照发生的时间顺序排列。 4.7.5 报文格式报文格式 请求报文：请求报文： “logisticCompanyID”:”DEPPON”, “orders”: “mailNo”:”123456789” 响应报文：响应报文： “responseParam”: “logisticCompanyID”:”DEPPON”, “orders”: “mailNo”:”92189788”, “orderStatus”:”SIGNSUCCESS”,
8、 “traceCode”=”1000”, “steps”: “acceptTime”:” 2013-04-16T10:53:46.000+0800”, “remark”:”已收取货物，盐城营业网点库存中”, “acceptTime”:” 2013-04-17T09:13:25.000+0800”, “remark”:”离开 盐城营业网点 发往 南通运输中心”, “acceptTime”:” 2013-04-18T19:53:46.000+0800”, “remark”:”已到达 南通运输中心”, “acceptTime”:”2012-11-30 10:59:11”, “remark”:”已到达
9、 目的地,西安雁塔丁白路”, “acceptTime”:” 2013-05-16 09:26:19 “, “remark”:” 签收人：赵*” 德邦开放平台和第三方接入商交互方案 38 / 45 , “result”:”true”, “resultCode”:”1000”, “reason”:” 4.8 状态推送状态推送 4.8.1 接口说明接口说明 订单流入物流公司后，会经过很多的阶段，不同的阶段对应不同的订单或运单状态，德 邦物流会将订单状态等信息实时通知至订单所在接入商。 通知的的状态包括：已受理、已拒绝、揽货失败、已开单、正常签收、异常签收。 德邦开放平台和第三方接入商交互方案 39
10、/ 45 4.8.2 业务流程业务流程 4.8.3 接口规格接口规格 接口名称 状态推送状态推送 接口提第三方接入平台第三方接入平台 接口调德邦开放平台德邦开放平台 德邦开放平台和第三方接入商交互方案 40 / 45 供方 用方 接口内容 传入参数信息：传入参数信息： 字段字段 变量名变量名 类型类型 长度长度 是是 否否 必必 填填 备注备注 物流公司ID logisticCompanyID String 32 是 DEPPON 渠道单号 logisticID String 32 是 第三方接入平台生成的订单号 状态更新时间 gmtUpdated Date 是 状态类型 statusType
11、 String 是 参考订单状态枚举值 反馈原因 comments String 否 开单后，同时返回如下的运单详情开单后，同时返回如下的运单详情 运单号 mailNo String 32 是 开单后的运单号 发货部门编码 businessNetworkNo String 32 否 到达部门编码 toNetworkNo String 32 否 发货人公司 sender:companyName String 100 否 发货人名称 sender:name String 100 是 发货人邮编 sender:postCode String 10 否 发货人电话 sender:phone Strin
12、g 32 是 发货人手机 sender:mobile String 15 是 发货人省份 sender:province String 32 是 发货人城市 sender:city String 32 是 发货人区县 sender:county String 32 否 发货人详细地址 sender:address String 256 是 收货人公司 receiver:companyName String 100 否 收货人名称 receiver:name String 100 是 收货人邮编 receiver:postCode String 10 否 收货人电话 receiver:phone
13、 String 32 是 收货人手机 receiver:mobile String 15 是 收货人省份 receiver:province String 32 是 收货人城市 receiver:city String 32 是 收货人区县 receiver:county String 32 否 德邦开放平台和第三方接入商交互方案 41 / 45 收货人详细地址 receiver:address String 256 是 货物名称 cargoName String 30 是 总件数 totalNumber int 是 总重量 totalWeight double double (5,2) 否
14、单位 kg 总体积 totalVolume double double (5,2) 否 单位 m3 总价格 totalPrice BigDecimal 否 单位：元 支付方式 payType String 1 是 0:发货人付款（现付）1:收货人付款（到付） 运输方式 transportType String 20 是 HK_JZHK:精准空运 QC_JZKH:精准卡航 QC_JZQYC:精准汽运（长） QC_JZQYD:精准汽运（短） QC_JZCY:精准城运 运费 transportPrice BigDecimal 否 保价金额 insuranceValue BigDecimal 否 保价
15、费 insurancePrice BigDecimal 否 代收货款类型 codType String 2 否 3：三日退 1：即日退 代收货款 codValue BigDecimal 否 代收货款费 codPrice BigDecimal 否 上门接货 vistReceive String 1 否 是:Y 否：N 上门接货费 vistReceivePrice BigDecimal 否 送货方式 deliveryType String 2 否 0:自提 1:送货 （不含上楼） 2:机场自提 3:送货上楼 送货费 deliveryPrice BigDecimal 否 签收回单 backSignBill String 2 否 0:无需返单 2:客户签收单传真返回 德邦开放平台和第三方接入商交互方案 42 / 45 4: 运单到达联传真返回 签回收单费 backSignBillPrice BigDecimal 否 包装 packageService String 32 否 包装 （直接用中文） ： 纸、 纤、 木箱、木架、托膜、托木 包装服务费 packageServicePrice BigDecimal 否 短信通知 smsNotify String 1 否 Y：需要 N: 不需要 短信通知费 smsNotifyPrice BigDeci
