快递接口api技术文档

快递接口api技术文档内容摘要：

同一线路不同快递公司的时效对比，帮助商家选择服务能力好的快递公司 ， 可根据快递不到区域，运费、时效、服务等综合判断最优快递。 接口规则 (1)、接口 只支持 Json格式 参数， 接口指令 2020。 只支持 POST请求方式， utf8编码。 (2)、支持增值服务，保价、代收货款、货款直退、货款垫付等。 (3)、测试地址： (3)、正式地址： 系统级输入参数 参数名称 类型 是否必须 描述 RequestData String R 请求内容， JSON或 XML格式 ,须和 DataType一致 EBusinessID String R 电商 ID RequestType String R 请求指令类型： 2020 DataSign String R 数据内容签名 DataType String O 请求、返回数据类型： 1xml,2json；默认为 xml格式 (本接口只支持 Json格式 ) 应用级输入参数 参数名称 类型 是否必须 描述 Receiver ProvinceName String R 收件省（如广东省，不要缺少 快递鸟 快递接口技术文档 8 / 51 “省”） CityName String R 收件市（如深圳市，不要缺少“市”） ExpAreaName String R 收件区（如福田区，不要缺少“区”或“县”） Subdistrict String O 收件街道（如华强北街道） Address String O 收件人详细地址 Sender ProvinceName String R 派 件省（如广东省，不要缺少“省”） CityName String R 派 件市（如深圳市，不要缺少“市”） ExpAreaName String R 派 件区（如福田区，不要缺少“区”或“县”） Subdistrict String O 派件街道（如华强北街道） Address String O 派 件人详细地址 Volume Double O 物品总体积 m3 Weight Double O 物 品总重量 kg GoodsCategory String O 商品类目 IsCOD Bool O 是否代收货款： ， ExpressList List O 商家合作 快递公司列表 SortBy Integer O 排序依据 :， ， 参数名称 类型 是否必须 描述 ExpressList ExpCode String R 快递公司编码 First Double R 首重价格 (元 ) Additional Double R 首重价格 (元 ) 快递鸟 快递接口技术文档 9 / 51 返回结 果参数 参数名称 类型 是否必须 描述 ExpressList List R 推荐快递公司列表 参数名称 类型 是否必须 描述 ExpressList ExpCode String R 快递公司编码 ExpName String R 快递公司名称 Fee Double O 总运费（元） EstimatedDeliveryTime Integer O 时效（ 预计到达时长 :小时 ） IsSupport String R 是否支持派件区域 （到不到 : ， ） 二、 在线下单 接口 功能说明 在线下单 接口 是 快递鸟提供给 独立 电商 、仓储管理系统、物流供应链 等物流 流 系统平台 使用的下单接口，为客户解决在线发货需求， 客户 通过网络 选择快递 公司发送请求通知贵公司有快递要发货，贵公司把数据通过此接口转发到快递鸟，由快递鸟为您安排 快递员上门取件 的服务。 接口规则 (1)、订单编号 (OrderCode)不可重复提交 ，重复 提交系统会 返回具体错误代码。 (2)、支持主流快递公司在线下单，请联系技术人员 (联系 方式请看文档尾部 )。 (3)、接口 只支持 Json格式 参数， 接口指令 1001。 只支持 POST请求方式， utf8编码。 (4)、支持增值服务，保价、代收货款、货款直退、货款垫付等。 (5)、测试地址： 快递鸟 快递接口技术文档 10 / 51 系统级输入参数 参数名称 类型 是否必须 描述 RequestData String R 请求内容， JSON或 XML格式 ,须和 DataType一致 EBusinessID String R 电商 ID RequestType String R 请求指 令类型： 1001 DataSign String R 数据内容签名 DataType String O 请求、返回数据类型： 1xml,2json；默认为 xml格式 (本接口只支持 Json格式 ) 应用级输入参数 参数名称 类型 是否必须 描述 WarehouseID String O 仓库标识 (备用字段 ) WarehouseAddress String O 仓库地址 (备用字段 ) CallBack String O 商户标识 (备用字段 ) MemberID String O 会员标识 (备用字段 ) ShipperCode String R 快递公司编码 LogisticCode String O 快递单号 OrderCode String R 订单编号 MonthCode String C 月结编码 PayType Int R 邮费支付方式 : 1现付， 2到付， 3月结，4第三方支付 ExpType Int R 快递类型： 1标准快件 快递鸟 快递接口技术文档 11 / 51 Cost Double O 寄件费（运费） OtherCost Double O 其他费用 Receiver Company String O 收件人公司 Name String R 收件人 Tel String R 电话与手机，必填一个 Mobile String PostCode String O 收件人邮编 ProvinceName String R 收件省（如广东省，不要缺少“省”） CityName String R 收件市（如深圳市，不要缺少“市”） ExpAreaName String O 收件区（如福田区，不要缺少“区”或“县”） Address String R 收件人详细地址 Sender Company String O 发件人公司 Name String R 发件人 Tel String R 电话与手机，必填一个 Mobile String PostCode String O 发件人邮编 ProvinceName String O 发件省（如广东省，不要缺少“省”） CityName String R 发件市（如深圳市，不要缺少“市”） ExpAreaName String O 发件区（如福田区，不要缺少“区”或“县”） Address String R 发件 详细地址 StartDate String O 上门取货时间段 : yyyyMMdd HH:mm:ss格式EndDate String O 快递鸟 快递接口技术文档 12 / 51 化，本文中所有时间格式相同 Weight Double O 物品总重量 kg Quantity Int O 件数 /包裹数 Volume Double O 物品总体积 m3 Remark String O 备注 AddService Name String 0 增值服务名称 Value String 0 增值服务值 CustomerID String 0 客户标识 (选填 ) Commodity GoodsName String R 商品名称 GoodsCode String O 商品编码 Goodsquantity Int O 件数 GoodsPrice Double O 商品价格 GoodsWeight Double O 商品重量 kg GoodsDesc String O 商品描述 GoodsVol Double O 商品体积 m3 返回结果参 数 参数名称 类型 必须要求 说明 EBusinessID String R 电商用户 ID Order OrderCode String R 订单编号 ShipperCode String R 快递公司编码 LogisticCode String O 快递单号 Success Bool R 成功与否 ResultCode String R 结果 编码 Reason String O 失败原因 快递鸟 快递接口技术文档 13 / 51 UniquerRequestNumber String R 唯一标识 Json 请求示例 { OrderCode: 012657018199, ShipperCode: SF, PayType: 1, MonthCode: 7553045845, ExpType: 1, Cost: , OtherCost: , Sender: { Company: LV, Name: Taylor, Mobile: 15018442396, ProvinceName: 上海 , CityName: 上海 , ExpAreaName: 青浦区 , Address: 明珠路 }, Receiver: { Company: GCCUI, Name: Yann, Mobile: 15018442396, ProvinceName: 北京 , CityName: 北京 , ExpAreaName: 朝阳区 , Address: 三里屯街道 }, Commodity: [ { GoodsName: 鞋子 , Goodsquantity: 1, GoodsWeight: } ], AddService: [ { Name: COD, Value: 1020 快递鸟 快递接口技术文档 14 / 51 } ], Weight: , Quantity: 1, Volume: , Remark: 小心轻放 } Json 请求返回示例 { EBusinessID: 1237100, Success: true, Order: { OrderCode: 012657018199, ShipperCode : SF , LogisticCode : }, ResultCode: 100, Reason: } 三 、取消订单 功能说明 物流公司还未 指派业务员去取件的物流订单可进行取消操作 ，撤销时需用户填写原因，填写后 快递鸟会通知 物流公司 取消订单。 接口规则 (1)、接口支持 Json/xml格式。 (2)、接口指令 1004。 快递鸟 快递接口技术文档 15 / 51 系统级输入参数 参数名称 类型 必须要求 说明 RequestData String R 请求内容， JSON或 XML格式 ,须和DataType一致 EBusinessID String R 电商 ID RequestType String R 请求指令类型： 1004 DataSign String R 数据内容签名 DataType String O 请求、返回数据类型： 1xml,2json；默认为 xml格式 应用级输入参数 参数名称 类型 必须要求 说明 Ord。