快递鸟接口文档之预约取件
在电商、ERP、打单工具或各类物流系统中，预约快递员上门揽件是常见的业务场景。快递鸟（KDNiao）提供了标准的 预约取件接口（RequestType: 1001），支持主流快递公司、快递柜及同城配送平台，帮助开发者快速实现“一键叫快递”功能。
本文将详细介绍如何对接快递鸟的 预约取件接口（OOrderService2），包括功能说明、接口信息、参数详解、请求示例及注意事项。
一、功能说明
核心作用：通知快递公司安排快递员在指定时间上门取件。
适用对象：散客用户（未签约大客户账号）已与快递网点签约并拥有大客户账号的企业用户（可结合电子面单接口使用）
业务流程：系统调用接口 → 快递公司接收订单 → 快递员按预约时间上门揽件 → 系统获取运单号
⚠️ 注意：该接口仅用于预约揽件，不生成电子面单。如需同时获取面单和单号，请使用 电子面单接口（EOrderService，RequestType=1007）。
二、接口基本信息
📌 重要提示：虽然文档中提到接口地址为
OOrderService2，但部分用户反馈该路径可能已调整或存在兼容性问题。若返回404或 “找不到资源”，请确认是否应使用EOrderService并设置RequestType=1001，或联系快递鸟技术支持核实最新接口地址。
三、支持的快递与服务类型
1. 快递公司（部分）
顺丰速运（SF）
中通快递（ZTO）
圆通速递（YTO）
韵达速递（YD）
申通快递（STO）
EMS
宅急送
京东快递（JD）
德邦（DBL）
优速、品骏、承诺达、顺心捷达等
2. 快递柜
丰巢快递柜（ShipperCode =
FCBOX）
3. 同城配送
闪送
达达（大马鹿）
✅ 具体支持列表请以快递鸟官方文档为准。
四、请求参数说明（应用级参数 RequestData）
以下为 JSON 格式的 RequestData 主要字段：
🔒 安全规范：请求报文中禁止出现以下特殊字符：
' " # & + < > % /
五、请求示例（JSON）
六、返回参数说明
成功返回示例：
七、常见问题与注意事项
接口返回 404？确认是否使用了正确的接口地址。部分用户反馈
OOrderService2可能已弃用，建议尝试使用EOrderService并设置RequestType=1001，或联系快递鸟客服确认。为何没有返回运单号？预约取件成功后，快递公司通常会在快递员实际揽件时才分配单号。部分快递（如顺丰）支持预下单返回单号，其他快递可能仅返回预约成功状态。
时间格式错误？
StartDate和EndDate必须为yyyy-MM-dd HH:mm:ss格式，且结束时间 > 开始时间。重复 OrderCode？使用相同
OrderCode重复请求，系统会返回第一次的结果（幂等性设计）。如何知道快递员是否已取件？可配合快递鸟的 【在途监控】 服务，订阅物流轨迹推送，实时获取揽件、运输、签收等状态。
八、总结
快递鸟的 预约取件接口（1001） 是实现“智能叫快递”功能的核心工具，适用于电商平台、SaaS 系统、小程序等多种场景。通过合理构造请求参数，即可高效完成快递预约，并获取运单信息。产品参考：https://www.kdniao.com/product-service/91
还未添加个人签名 2023-11-06 加入
还未添加个人简介
评论