回复客户前核对包裹进度
查询这些顺丰运单号 [运单号]，对应寄件或收件手机号后四位是 [尾号]。按包裹整理最新节点、时间、地点和已报告的派送异常。
sf_express
顺丰速运 AI 员工
Leina 连接 顺丰速运，帮你跟踪包裹、比较寄递方案、准备寄件订单。在团队聊天中交代任务，Leina 完成工作，再把结果带回来。
连接 顺丰速运，选择要共享的内容，就可以交代第一项任务。
Leina + 顺丰速运 结果示例
你
查一下我提供的两个运单号和手机尾号，哪个包裹需要跟进？
Leina
包裹 B 的最新路由记录显示派送异常，包裹 A 正在派送。
顺丰速运 · 物流查询示例
两个包裹 · 进度核对
两个包裹的最新节点，其中一个存在需要跟进的派送异常。
- 包裹 A · 派送中
- 10:20 · 深圳南山营业点。最新节点：快递员正在派送。
- 包裹 B · 需要跟进
- 09:45 · 上海闵行营业点。最新节点：无法联系收件人。
- 跟进建议
- 核对包裹 B 的收件人联系方式，再联系安排后续派送。
什么是 顺丰速运 AI 智能体？
顺丰速运 AI 智能体通过你的顺丰开放平台连接查询包裹和处理寄件订单。提供运单或寄件信息，即可查询路由、校验订单或准备面单。
你指定资料来源和保存位置。Leina 使用连接有权访问的内容完成任务，再把结果交给你检查。
顺丰速运
顺丰速运提供快递与物流服务，其开放平台支持应用接入寄件、物流查询和面单操作。
-
提供运单信息
给出运单号及查询所需的手机验证信息。
-
查询顺丰路由
读取各包裹可查询的物流节点。
-
找出待跟进包裹
核对最新节点，标出已报告的异常。
-
准备客户回复
依据节点时间与地点，说明当前派送进度。
可以交给 Leina 的 顺丰速运 任务
复制示例，补充具体信息，然后在已接入的团队聊天中发给 Leina。
下单前检查寄件信息
检查这份顺丰寄件能否受理：订单编号 [编号]、产品 [类型]、寄件人 [联系人与地址]、收件人 [联系人与地址]、物品 [名称]。说明问题和返回的服务时段，先不要下单。
sf_express
比较寄递时效与预估运费
比较从 [寄件地址] 到 [收件地址]、重 [公斤]、计划 [日期和时间] 寄出的顺丰方案。列出返回的送达时段与价格，未提供价格的请标注。
sf_express
下一项 顺丰速运 工作，从一条消息开始。
连接工具，交代任务，查看结果
在团队聊天中告诉 Leina 你的需求，说明数据来源、保存位置和预期结果。
-
连接账号
连接任务涉及的工具，让 Leina 访问需要的内容。
-
尝试一个任务
提供资料来源、结果的保存位置，以及你希望完成的工作。
-
核对结果
查看任务结果，并核对应用中的变更。
让 Leina 在 顺丰速运 中动手完成工作
把这些日常工作交给你的 AI 员工。
Search Routes
查询最多10个顺丰快件的物流路线（追踪事件）。仅运单仅针对使用与您的partnerID绑定的月卡支付的货件查询回程路线；对于任何其他货件，请在 check_phone_nos 中传递发件人或收件人电话的最后 4 位数字。只有最近 3 个月的货物有路线。
Query Delivery Time Price
查询始发地和目的地的顺丰速运时效标准，可选择每个产品的运费价格。
Estimate Delivery Time
查询顺丰运单承诺派送时间，通过寄件人或收件人电话号码或支付运单的月卡验证。
Validate Waybill No
检查运单号是否为有效的顺丰运单号。
Filter Order
下单前请检查始发地和目的地地址是否在顺丰收派范围内（筛单）。
Query Service Points
列出某个地址或坐标周围附近的顺丰速运服务点（自营服务点、合作商家店、顺丰站、丰巢柜等）。
Recommend Product
推荐顺丰速运产品以及价格和承诺的货件送达时间。
Recommend Vas
推荐增值服务（保鲜、保价、定时派送等）以及所选产品的发货价格。
Check Pickup Time
检查某个地址的顺丰收件是否可以按计划时间送达，可选择退回服务窗口。
Create Order
创建真实的顺丰快运订单（下订单）并分配运单号；可能会收取费用。支持中国大陆及港澳台线路。响应中包含筛选结果（filterResult）和分配的运单号。使用 pre_order 验证订单而不创建订单。
Pre Order
验证是否接受顺丰速运订单（预下单）——检查货物、月卡、地址可达性和数量控制——无需创建订单，并返回可用的服务时间窗口。
Update Order
发货前确认 (deal_type inform) 或取消 (deal_type cancel) 顺丰速运订单，可选择更新重量、体积或收件人地址。确认需要运单号码。已取消的订单号无法重复使用。
Query Order Result
查询之前下的顺丰订单的处理结果，例如当create_order响应从未到达时。
Get Sub Waybill Nos
为现有顺丰速运订单分配额外的子运单号，每次调用最多 20 个。
Intercept Order
拦截、重定向、退回或调整在途顺丰运单（截单转寄返回），例如重定向至新地址或退回寄件人。仅限已领取的运单；使用 update_order 取消未发货的订单。
Send Delivery Notice
发送顺丰运单派件通知，用于货物提前入库的预售场景。
Query Waybill Fee
通过订单号（仅限您的partnerID下的订单）或运单号（运单月卡必须与您的partnerID绑定）查询顺丰快件的运费明细（清单运费）。
Register Route Push
注册顺丰订单或运单进行路线（追踪）推送。前提：SF控制台已配置路由推送回调（控制台 → 开发者对接 → 查看API → 路由注册接口 → 配置信息）；注册后，SF 将路由更新推送到该地址。
Register Waybill Picture Push
注册运单进行运单图片推送（回单回单、清单清单、拍照回传照片证明等）。 SF生成AES加密图片后，将其推送到配置的回调中；签收后再登记，因为图片制作较晚。解密密钥来自SF控制台（控制台→开发者活动→查看API→图片注册及自治接口）。
Print Waybill Pdf
从云打印模板（云打印面单转PDF）生成运单PDF打印文件。返回需要 X-Auth-token 标头中返回的令牌的下载 URL（24 小时有效）。
Print Waybill Command
将运单转换为打印机命令集（云打印面单转指令、cpcl 或 zpl），以文本或可下载文件形式内嵌返回。
Print Waybill Cainiao Template
对于已集成菜鸟打印组件的系统，将运单转换为菜鸟打印模板 URL（云打印面单转菜鸟模板）。
Print Waybill Html
从云打印模板（云打印面单转HTML）生成运单 HTML 打印文件。返回需要 X-Auth-token 标头中返回的令牌的下载 URL（24 小时有效）。
Submit Citywide Print
大同城同城货运单提交运单打印内容。默认异步：返回一个打印批号以用 sf_express.query_citywide_print_status 进行轮询；同步模式（最多 20 个文档）直接返回文件。
Query Citywide Print Status
查询大同城全市批量打印的状态和生成的PDF文件。
List Print Templates
列出商家发布的自定义打印模板及其占位符字段（ISV 自定义模板列表）。
Save Print Template
保存商家自定义打印模板（ISV 保存自定义模板）；相同的名称意味着相同模板的新版本。内容遵循SF标记语言规范。
Delete Print Template
删除商家自定义打印模板（ISV删除自定义模板）； SF 限制每个帐户的模板数量，因此请在添加新模板之前删除未使用的模板。
Coldchain Check Transport Flow
检查顺丰冷运是否可以为指定的产品始发地和目的地流提供服务，返回服务点的营业时间和可用温度水平。
Coldchain Estimate Transport Fee
估算一个流程和一种或多种产品的顺丰冷链运输费用，返回每种产品的费用明细。
Coldchain Estimate Delivery Time
估算一个流程和一种或多种产品的顺丰冷链交货时间，包括提货和交货运输时间。
Coldchain Create Order
创建顺丰冷链运输订单（陆运运输）。每月结算付款需要每月帐户 (PR_ACCOUNT)。
Coldchain Cancel Order
取消尚未受理的顺丰冷运订单。
Coldchain Query Waybill No
查询顺丰冷运订单生成的运单号（主运单、回签单号、子运单）。
Coldchain Query Route
通过运单号、顺丰订单号或客户订单号，结合订单源代码查询顺丰冷链路线事件。
Coldchain Query Order Info
查询顺丰冷运订单的完整明细，包括当事人、重量、货号、增值服务、回签单等。
Freight Create Ltl Order
对于大件或重型货物，下顺丰货运 (快运) 零担订单。这仅适用于大件特殊场景；对于常规包裹，请使用 sf_express.create_order。当提供 waybill_no 时，订单将使用该保留的主运单编号而不是生成一个。
Freight Cancel Ltl Order
取消顺丰货运零担订单。仅可取消尚未提货的订单。
Freight Get Ltl Order Result
获取通过快递呼叫（下呼叫）下达的顺丰零担订单的最新派送结果，包括分配的运单号。
Freight Append Ltl Sub Waybill
将分运单编号附加到顺丰货运零担订单中，供发货人在装箱后确定包裹数量。提货前只拥有订单；每个订单最多 1200 个分运单。如果运单已经打印，请稍后重新打印。
Freight Check Address Reachable
检查地址是否在顺丰货运取货或送货覆盖范围内（订单筛单）。
Freight Query Standard Price
查询顺丰快运产品在两个地址之间的标准基础运费。定价时至少需要重量、尺寸或声明值之一。
Freight Register Ltl Picture Push
注册顺丰货运运单，进行运单图片推送。推送到达前，必须在 SF 控制台配置图片推送回调。
Freight Query Crossborder Route
查询顺丰跨境大件运单路径。对于转单号 (转单号)，请使用 Freight_query_crossborder_transfer_routes。
Freight Query Crossborder Transfer Routes
查询顺丰跨境大件货件转单号的路线事件。
Freight List Crossborder Transfer Nos
列出顺丰跨境大件母运单的转单号。
Freight Report Work Order
向顺丰客服报告顺丰快运快件的工单。
Freight Reply Work Order
回复顺丰货运工单，由work_order_id或report_source_no（至少一个）标识。
Freight Create Tl Order
创建顺丰整车直达订单。设置generate_waybill_no，让SF分配运单号，或者传递您自己的waybill_no。当 pay_method 为 1（寄付月结）或 2（寄付转第三方）时，需要月卡（monthly_card）。
Freight Cancel Tl Order
取消顺丰货运整车订单。仅当订单处于可取消状态时取消才成功；否则错误消息会解释原因。
Freight Query Tl Order
通过客户订单号查询顺丰货运整车订单；当你有 waybill_no 时，也传递它。
Freight Create Vehicle Track Url
创建顺丰货运运单的车辆轨迹回放页面URL。需要支付运单的月卡。
Freight City Confirm Order
下达顺丰同城配送（城市商品货运）订单。 send_start_time 必须至少为未来 2 小时。
Freight City Calc Fee
下单前请计算顺丰同城配送的运费。
Freight City List Orders
列出顺丰货运城市配送订单的订购电话号码，以及可选的时间和分页过滤器。
Freight City Get Order Detail
通过订单号或客户订单号获取顺丰同城派送订单详情。
Freight City Cancel Order
取消顺丰货运同城配送订单。
Freight City List Available Vas
列出顺丰同城派送中某个城市和车型可享受的增值服务。
Freight City List Vehicles
列出顺丰同城派送中某个城市及业务场景可用的车型。
Freight City List Cities
列出顺丰货运可派送的城市。
Freight City List Appointment Times
获取顺丰货运城市派送中某城市可用的取件预约时间窗口。
Freight Append Install Service
将安装服务附加到现有 SF 运单。提货后才确认追加；最终结果通过安装状态推送到达。该接口需要顺丰销售上线（联系客户经理）。
Freight Create Install Order
创建 SF 安装订单 (安装单下单)：仅安装、提货并安装或维修。
Freight Update Install Order
更新安装订单的客户信息、非 SF 物流信息或货物图像。客户和物流信息只能在分配主数据之前更改；在签署运单之前，货物图像可能会发生变化。
Freight Cancel Install Order
取消附加安装服务；运单不得被领取。
Freight Query Install Order
按客户订单号查询 SF 安装订单的状态和费用明细。
Freight Create Recovery Order
创建顺丰回收单（回收单下单）以进行上门货物回收。取货日期必须在3天内，窗口全时段为08:00至21:00。
Freight Notify Install Arrival
将安装订单的货物标记为已到达 (到货通知)，可以选择填写取货地址。仅支持未到达到到达的转换。
Freight Cancel Recovery Order
取消顺丰恢复订单；一旦主人到来，就不可能了。
Freight Query Recovery Products
查询完整顺丰回收产品目录（回收品类）。列表很大，完整返回；缓存它而不是重复调用。
Freight Query Delivery Rules
查询一张或多张顺丰月卡绑定的宅配规则。
Freight Audit Value Added Service
审核增值服务请求（审核增值服务），例如JZ17 报表返现服务。
Freight Supplier Report Operation Node
向SF作为供应商报告安装任务操作节点：指派主控、取货、预约、到货检查、完成、审核、故障检测等。必填字段取决于操作代码；代码 3、17、20、21 需要图像。
Freight Supplier Query Appointment Times
查询供应商师傅可以为安装任务提供的预约时间（送装愉快可预约时间）。
Freight Bid Submit Quote
提交投标安装订单的供应商主报价 (回传报价)。
Freight Bid Report Operation Node
报告竞价安装订单的操作节点（供应商自主报价操作节点回传）。 opera_data所需的key取决于operate_code：OP000006需要installMaster+installConcat，OP000004需要appTime，OP000008/OP000001/OP000010需要imgUrl，OP000013需要closeReason。
Freight Bid Report Add Fee Result
报告船长对投标安装订单增加费用请求的决定。
Freight Supplier Apply Add Fee
作为供应商申请投标安装订单的附加费（供应商侧发起增加费用）。
Freight Supplier Query Add Fee Result
查询供应商增加费用申请结果（增加费用结果查询）；结果推送或报告失败时的回退。
Freight Bid Report Refund Result
报告主人对投标安装订单退款请求的决定。
Freight Bid Report Complaint Result
报告招标安装订单的投诉处理结果（接收投诉结果）。
Freight Bid Send Evidence Notice
处理投诉时要求客户补充证据（通知用户补充举证）。截止日期默认为通知时间后 12 小时。
Freight Bid Submit Master Evidence
提交师傅举证回传，以投诉投标安装单。
Freight Forward Upload Sign Image
上传顺丰货运转运单收件人签名或其他投递证明图片；顺丰审核后在运单上签字。图像 URL 必须可公开访问。
Freight Forward Upload Driver
承运商分配司机后，上传顺丰货运订单的取货司机信息。
Freight Forward Upload Track Batch
一次调用即可上传一张顺丰货运运单的多个车辆轨迹点。所有轨迹点必须属于同一运单号。
Freight Forward Upload Waybill Remark
上传顺丰货运转运单备注。
Freight Forward Upload Receipt
上传顺丰货运转运单回签单号。
Freight Forward Update Order Status
上传顺丰货运货件的实时订单状态更新。
Freight Forward Upload Route
上传顺丰货运转运运单的路线事件。增量上传，最新的在前；覆盖所有装货、卸货和发货节点（对已签名节点使用freight_forward_upload_sign_image）。
Freight Forward Upload Track
上传1个车辆轨迹点作为顺丰货运转运运单。
Freight Forward Apply Add Fee
在顺丰货运代理运单上申请附加最后一公里费用；目前仅支持入仓垫付（入仓预付，类型50）。
Freight Forward Place Return Order
为一张或多张顺丰货运代理运单下标快到付订单。
Freight Forward Report Exception
报告顺丰货运转运运单的异常情况，例如损坏、计数错误、延误或重新称重申诉。代码 SIGN_03/SIGN_05/SIGN_15/TRANSITING_15 需要延迟天数；重新称重代码 HANDOVER_06/TRANSITING_17 需要“weight”和“sub_items”。
Freight Forward Start Pay
获取未付款顺丰货代运单的付款二维码。
Freight Forward Apply Monthly Payment
将顺丰货代运单付款与月结卡号绑定，收取费用。需要月卡。
Freight Forward Upload Return Route
上传顺丰货运回执的路线事件。增量上传，最新的在前；覆盖所有装卸、出库、签收节点。
Freight Crossborder Report Trace
作为承运代理报告顺丰跨境大件快件的物流轨迹。路由先存储最新的；里程碑值使相应的节点对最终客户可见。
Freight Crossborder Place Order
下顺丰跨境大件订单并获取主运单号和分运单号。当settlement_type为2（寄付月结）时，需要月卡（monthly_card）。
Freight Crossborder Query Postcode Address
查询顺丰跨境大件货件是否有目的地邮编，返回地址信息和偏远地区标志。
Freight Crossborder Get Print Batch
启动顺丰跨境大件运单打印下载并获取打印批号。
Freight Crossborder Query Print Result
获取由 Freight_crossborder_get_print_batch 创建的打印批次的运单打印文件下载 URL。
Freight Crossborder Confirm Delivery Window
作为承运代理确认并更新 FBA 货件的新交货窗口选项。
Freight Crossborder Query Delivery Window Options
作为承运代理查询 FBA 货件的可选配送窗口选项。
Freight Crossborder Get Delivery Window
作为承运代理查询FBA货件当前的派送窗口。
Freight Crossborder Get Pod Info
查询顺丰跨境大件运单的投递凭证信息。
Freight Crossborder Upload Pod Files
上传 SF 跨境大件运单的投递证明文件，作为可公开访问的文件 URL。
Freight Crossborder Cancel Order
通过运单号取消一笔或多笔顺丰跨境大件订单。
Station Batch Inventory
批量上传合作站持有的运单600条航线（滞留件盘点）。
Station Handle Exception Return
报告外部车站运单异常退货（驿站异常件退件处理）。
Station Verify Waybill Number
检查运单号是否为顺丰运单号，车站通道。
Station Query Waybill Route
查询车站通道的运单路径事件。
Station Notify Recipient
向车站持有的运单收件人发送取件通知短信。
Station Send Waybill Sms
向收件人或发件人发送运单的固定模板通知短信。
Station Store Batch Inventory
批量上传便利店运单的600条航线（滞留件盘点）。
Station Query Centralization
通过车站通用查询API查询运单是否为集中（集收/集派）快件。
Station Update Outsource Info
提交或更新外包站区域的区域外包信息变更。
Station Upsert Robot Channel
创建或更新机器人/智能柜频道站（渠道新增/修改）。创建时省略virtual_addr；更新的时候传过去。
Station Upsert Cage Cabinet
创建或更新笼车柜； sn 字段是 upsert 键。
Station Store Handle Exception Return
报告商店运单异常退货（机场异常件退件处理）。
Station Check Delivery Operation
检查渠道操作员是否可以在门店办理运单（渠道可派件交接管控）。
Station Customer Send In Store
登记顾客到商店的寄件（顾客到店寄件）。当receiver_ payment为0（寄付）时，需要重量、pack_fee、insurance_money和insurance_fee。
Station Courier Pickup In Store
登记顺丰小哥到店收件（顺丰小哥到店收件）。
Station Store Receive Delivery
登记某店铺收到顺丰快递（门口接收小哥派件）转来的包裹。
Station Customer Pickup In Store
登记顾客在商店提取包裹（顾客到店取件）。当receiver_ payment为1（到付）时，需要重量、pack_fee、insurance_money、insurance_fee和successful_payed_fee。
Station Query Store Info
查询车站信息。需要 virtual_addr 或 store_code 之一。返回的字段名称因 api_version 而异。
Station Verify Fc Settlement
检查丰巢柜件投递费是否按月结算（丰巢订单结算结算，订单类型1派件投柜）。租赁和预订订单类型具有不同的有效负载，因此不包括在内。
Station Upsert Fc Outsource Store
创建或更新Hive Box区域外包商店（丰巢区域外包商店新增及更新）。
Station Upsert Ysf Outsource Store
创建或更新驿收发区域外包商店（驿收发区域外包商店新增及更新）。
Station Save Village Store
创建或更新乡镇代理站（乡镇代理基本信息新增）。
Station Upload Village Store Images
上传乡镇代理站的外部和内部图像（乡镇代理图片上传）。
Station Upsert Store Info
创建或更新城市车站的基本信息（驿站基本信息新增/更新）。当outsource_flag为1时，outsource_info被保存，并且是驿收发/丰巢商店所需的。
Station Save Xgj Store
创建或更新星管家电台的基本信息（星管家基本信息新增）。
Station Upload Xgj Images
上传星管家电台的身份、脸部和财产图像（星管家相册新增）； Identity_file_names 必须恰好包含 2 个图像。
Station Get Oss Token
获取直接上传图片的OSS token（获取OSSToken信息）。 oss_client_name 和 path_id 值来自您的顺丰速运联系人。
Station Query Grid Schedule
查询快递员在车站的班次的网格/箱分配（星管家排班信息查询）。
Station Upload Picture
为一个站点上传一张base64图片（图片上传）；图像不得超过 200 KB。
Station Submit Fc Resource
提交或更新丰巢服务站信息接收或更新。
Station Update Xgj Waybill Fee
更新星管家运单的派送及审核费用信息（星管家运单及悲伤费更新）。
Station Update Xgj Insurance Fee
更新星管家电台的每月保险费（星管家保险费更新）。
Station Submit Receipt Info
提交运单的收货信息及其费用、服务、标记和附加列表（回单信息）。
Station Query Waybill Info
查询运单联系人、付款人和费用明细（通用运单查询）。响应中的电话和地址字段由顺丰加密。
Station Upload Fc Images
上传 Hive Box 服务站的店面和内部图片（丰巢服务站相册新增）。
Station Upload Store Album
上传车站相册图像（新增），例如外观、许可证、海报和标牌照片。
Station Add Brand Inspection Images
提交站内任务品牌检查图片（品牌巡检相册新增）；重新提交相同的task_id会更新其图像。
Station Pre Handover Pack
实物交接前，在外部驿站派件预入库预存运单。
Station Handover Pack
在外部车站（外部驿站派件入库，657路）办理配送运单。
Station Customer Receive Pack
客户提货时在外部车站查看运单（外部驿站派件出库，658路）。
Station Save Store
创建或更新外部站（新增/修改外部驿站）。创建时省略virtual_addr；传递它来更新现有的电台。
Station Add Store Images
将营业执照、备案或相册图像文件名附加到外部站（外部驿站上传营业执照、最终备案、相册）。
Station Send Sms
从外部车站发送运单的取货代码短信（外部站驿传送短信）。
Station Check Waybill
检查运单是否对外站操作有效（外部驿站运单校验）；没有收件人手机的顺丰运单无法接收站内短信。
Station Temp Store
报告临时站暂存运单（驿站暂存）：bill_type 1 = 收端暂存（路线 410），2 = 派端暂存（路线 210）。
Station Verify Delivery Permission
检查渠道和快递员是否可以派件管控。信道码由SF分配（联系868850）。
Station Validate Delivery Password
在合作站验证客户的运单取件密码（验证取件密码）。
为你的 AI 员工连接更多工具
连接工作中使用的 App，让 Leina 获取任务需要的信息，继续推进工作。
Leina结果示例 包裹 B 的最新路由记录显示派送异常，包裹 A 正在派送。
两个包裹 · 进度核对
关于 顺丰速运 和 Leina，你可能还想知道
检查寄件信息会直接下单吗？
不会。下单前检查只校验拟寄信息；创建寄件订单是另一项操作，可能产生费用。
查件为什么需要手机尾号？
查询未绑定到当前连接月结账户的运单时，需要提供寄件人或收件人手机号后四位。
面单下载链接可以一直保留使用吗？
面单链接需要访问验证，24 小时后失效。请在有效期内保存或打印文件。
让 Leina 成为你的 顺丰速运 AI 员工
从手头的一项工作开始。告诉 Leina，你想要什么样的结果。
连接 顺丰速运，选择要共享的内容，就可以交代第一项任务。