《快递鸟预约取件接口API对接说明手册》由会员分享，可在线阅读，更多相关《快递鸟预约取件接口API对接说明手册（9页珍藏版）》请在金锄头文库上搜索。
1、快递鸟预约取件接口 API 对接说明手册一、接口描述/说明（1）在线下单接口（预约取件接口）是提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口。（2）为客户解决在线发货需求，商户通过网络选择快递公司发送请求通知快递公司有快递要发货。（3）订单编号（OrderCode ）不可重复提交，重复提交系统会返回具体错误代码。（4）接口支持的消息接收方式为 HTTP POST，请求方法的编码格式 (utf-8)：application/x-www-form-urlencoded;charset=utf-8。（5）接口地址： API 测试地址：http:/testapi.kdniao.c
2、c:8081/api/OOrderServiceAPI 正式地址：http:/api.kdniao.cc/api/OOrderService（6）接口使用：在快递鸟网站申请接口 KEY请求系统级参数说明：参数名称 类型 说明 必须要求RequestData String请求内容需进行 URL(utf-8)编码。请求内容JSON 格式，须和 DataType 一致。REBusinessID String 商户 ID，请在我的服务页面查看。 RRequestType String 请求指令类型：1001 RDataSign String数据内容签名：把(请求内容(未编码)+AppKey)进行 MD
3、5 加密，然后 Base64 编码，最后 进行 URL(utf-8)编码。详细过程R请查看 Demo。DataType String 请求、返回数据类型：只支持 JSON 格式 R备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）二、接口参数请求内容字段定义参数 类型 说明 必须要求WarehouseID String 仓库标识 OWarehouseAddress String 仓库地址 OCallBack String 商户标识 OMemberID String 会员标识 OShipperCode String 快递公
4、司编码 RLogisticCode String 快递单号 OOrderCode String 订单编号 RMonthCode String 月结编码 CPayType Int邮费支付方式:1-现付，2-到付，3-月结，4-第三方支付RExpType Int 快递类型：1-标准快件 RCost Double 寄件费（运费） OOtherCost Double 其他费用 OCompany String 收件人公司 OName String 收件人 RTel StringMobile String电话与手机，必填一个 RPostCode String 收件人邮编 OProvinceName Str
5、ing收件省（如广东省，不要缺少“省”）RCityName String收件市（如深圳市，不要缺少“市”）RExpAreaName String收件区（如福田区，不要缺少“区”或“县”） OReceiverAddress String 收件人详细地址 RCompany String 发件人公司 OName String 发件人 RSenderTel String 电话与手机，必填一个 RMobile StringPostCode String 发件人邮编 OProvinceName String发件省（如广东省，不要缺少“省”）RCityName String发件市（如深圳市，不要缺少“市”）
6、RExpAreaName String发件区（如福田区，不要缺少“区”或“县”） OAddress String 发件人详细地址 RStartDate String OEndDate String上门取货时间段:yyyy-MM-dd HH:mm:ss格式化，本文中所有时间格式相同OWeight Double 物品总重量 kg OQuantity Int 件数/包裹数 OVolume Double 物品总体积 m3 ORemark String 备注 OAddServicesName String 增值服务名称 OValue String 增值服务值 OAddServiceCustomerID
7、String 客户标识（选填） OCommoditysGoodsName String 商品名称 RGoodsCode String 商品编码 OGoodsquantity Int 商品数量 OGoodsPrice Decimal 商品价格 OGoodsWeight Decimal 商品重量 OGoodsDesc String 商品描述 OCommodityGoodsVol Double 商品体积 m3 O返回参数定义参数名称 类型 说明 必须要求EBusinessID String 用户 ID ROrderCode String 订单编号 RShipperCode String 快递公司编码
8、 ROrderLogisticCode String 快递单号 OSuccess Bool 成功与否 RResultCode String 结果编码 RReason String 失败原因 OUniquerRequestNumber String 唯一标识 R三、示例请求示例 JSONOrderCode: 012657018199,ShipperCode: SF,PayType: 1,MonthCode: 7553045845,ExpType: 1,Cost: 1.0,OtherCost: 1.0,Sender: Company: LV,Name: Taylor,Mobile: 1501844
9、2396,ProvinceName: 上海,CityName: 上海, ExpAreaName: 青浦区,Address: 明珠路,Receiver: Company: GCCUI,Name: Yann,Mobile: 15018442396,ProvinceName: 北京,CityName: 北京,ExpAreaName: 朝阳区,Address: 三里屯街道,Commodity: GoodsName: 鞋子,Goodsquantity: 1,GoodsWeight: 1.0,AddService: Name: COD, Value: 1020,Weight: 1.0,Quantity:
10、1,Volume: 0.0,Remark: 小心轻放返回示例 JSON失败：EBusinessID: 1237100,Success: false,ResultCode: 105,Reason: 该订单已经存在，请勿重复操作,UniquerRequestNumber:451d3c7c-b428-490a-a4ed-e368f15f6c74成功：EBusinessID: 1237100,Success: true, Order: OrderCode: 012657018199, ShipperCode : SF , LogisticCode : ,ResultCode: 100,Reason:
