顺丰速运
连接顺丰速运，让 AI 查询物流轨迹与时效、校验寄件信息，并处理下单和面单打印。
通过顺丰开放平台连接查询路由、检查寄递方案、创建订单，并使用支持的打印模板准备面单。
Agent 能在 顺丰速运 里做什么
按任务分组，每组列出要调用的操作。
物流与估计
读取路由、承诺时间、服务时效和运费详情。
- Search Routes
- Estimate Delivery Time
- Query Delivery Time Price
- Query Waybill Fee
准备与创建订单
验证订单或创建实际寄件，并检查处理结果。
- Pre Order
- Create Order
- Query Order Result
运单打印
使用云模板生成 PDF、HTML 或打印机指令。
- Print Waybill Pdf
- Print Waybill Html
- Print Waybill Command
可以交给 Agent 的任务
方括号里填你的内容，任务标出的其他应用也要连接。
回复客户前核对包裹进度
汇总最新物流节点，标出返回记录中的派送异常。
查询这些顺丰运单号 [运单号]，对应寄件或收件手机号后四位是 [尾号]。按包裹整理最新节点、时间、地点和已报告的派送异常。
下单前检查寄件信息
验证拟寄订单，并查看返回的服务时段。
检查这份顺丰寄件能否受理：订单编号 [编号]、产品 [类型]、寄件人 [联系人与地址]、收件人 [联系人与地址]、物品 [名称]。说明问题和返回的服务时段，先不要下单。
比较寄递时效与预估运费
根据寄收地址和重量查询产品时效，以及可返回的运费估算。
比较从 [寄件地址] 到 [收件地址]、重 [公斤]、计划 [日期和时间] 寄出的顺丰方案。列出返回的送达时段与价格，未提供价格的请标注。
操作155
顺丰速运 连接器提供的全部操作，附名称和 id。
- Search Routes
search_routes查询最多10个顺丰快件的物流路线（追踪事件）。仅运单仅针对使用与你的partnerID绑定的月卡支付的货件查询回程路线；对于任何其他货件，请在 check_phone_nos 中传递发件人或收件人电话的最后 4 位数字。只有最近 3 个月的货物有路线。 - Query Delivery Time Price
query_delivery_time_price查询始发地和目的地的顺丰速运时效标准，可选择每个产品的运费价格。 - Estimate Delivery Time
estimate_delivery_time查询顺丰运单承诺派送时间，通过寄件人或收件人电话号码或支付运单的月卡验证。 - Validate Waybill No
validate_waybill_no检查运单号是否为有效的顺丰运单号。 - Filter Order
filter_order下单前请检查始发地和目的地地址是否在顺丰收派范围内（筛单）。 - Query Service Points
query_service_points列出某个地址或坐标周围附近的顺丰速运服务点（自营服务点、合作商家店、顺丰站、丰巢柜等）。 - Recommend Product
recommend_product推荐顺丰速运产品以及价格和承诺的货件送达时间。 - Recommend Vas
recommend_vas推荐增值服务（保鲜、保价、定时派送等）以及所选产品的发货价格。 - Check Pickup Time
check_pickup_time检查某个地址的顺丰收件是否可以按计划时间送达，可选择退回服务窗口。 - Create Order
create_order创建真实的顺丰快运订单（下订单）并分配运单号；可能会收取费用。支持中国大陆及港澳台线路。响应中包含筛选结果（filterResult）和分配的运单号。使用 pre_order 验证订单而不创建订单。 - Pre Order
pre_order验证是否接受顺丰速运订单（预下单）——检查货物、月卡、地址可达性和数量控制——无需创建订单，并返回可用的服务时间窗口。 - Update Order
update_order发货前确认 (deal_type inform) 或取消 (deal_type cancel) 顺丰速运订单，可选择更新重量、体积或收件人地址。确认需要运单号码。已取消的订单号无法重复使用。 - Query Order Result
query_order_result查询之前下的顺丰订单的处理结果，例如当create_order响应从未到达时。 - Get Sub Waybill Nos
get_sub_waybill_nos为现有顺丰速运订单分配额外的子运单号，每次调用最多 20 个。 - Intercept Order
intercept_order拦截、重定向、退回或调整在途顺丰运单（截单转寄返回），例如重定向至新地址或退回寄件人。仅限已领取的运单；使用 update_order 取消未发货的订单。 - Send Delivery Notice
send_delivery_notice发送顺丰运单派件通知，用于货物提前入库的预售场景。 - Query Waybill Fee
query_waybill_fee通过订单号（仅限你的partnerID下的订单）或运单号（运单月卡必须与你的partnerID绑定）查询顺丰快件的运费明细（清单运费）。 - Register Route Push
register_route_push注册顺丰订单或运单进行路线（追踪）推送。前提：SF控制台已配置路由推送回调（控制台 → 开发者对接 → 查看API → 路由注册接口 → 配置信息）；注册后，SF 将路由更新推送到该地址。 - Register Waybill Picture Push
register_waybill_picture_push注册运单进行运单图片推送（回单回单、清单清单、拍照回传照片证明等）。 SF生成AES加密图片后，将其推送到配置的回调中；签收后再登记，因为图片制作较晚。解密密钥来自SF控制台（控制台→开发者活动→查看API→图片注册及自治接口）。 - Print Waybill Pdf
print_waybill_pdf从云打印模板（云打印面单转PDF）生成运单PDF打印文件。返回需要 X-Auth-token 标头中返回的令牌的下载 URL（24 小时有效）。
顺丰速运 怎么登录
- 登录方式
- 自定义凭证提供顺丰开放平台 partnerId、checkWord，以及已配置签名算法和 sandbox 设置。
- 需要准备
- 获批准的顺丰开放平台应用、partnerId 与 checkWord。
- 说明
- 新应用通过沙箱测试后才可生产调用；非绑定月结卡运单查询需手机验证，路由覆盖最近三个月。