回复客户前核对包裹进度
汇总最新物流节点,标出返回记录中的派送异常。
查询这些顺丰运单号 [运单号],对应寄件或收件手机号后四位是 [尾号]。按包裹整理最新节点、时间、地点和已报告的派送异常。
Leina 连接 顺丰速运,帮你跟踪包裹、比较寄递方案、准备寄件订单。在团队聊天中交代任务,Leina 完成工作,再把结果带回来。
连接 顺丰速运,选择要共享的内容,就可以交代第一项任务。
你
查一下我提供的两个运单号和手机尾号,哪个包裹需要跟进?
Leina
包裹 B 的最新路由记录显示派送异常,包裹 A 正在派送。
顺丰速运 · 物流查询示例
两个包裹 · 进度核对
两个包裹的最新节点,其中一个存在需要跟进的派送异常。
顺丰速运 AI 智能体通过你的顺丰开放平台连接查询包裹和处理寄件订单。提供运单或寄件信息,即可查询路由、校验订单或准备面单。
你指定资料来源和保存位置。Leina 使用连接有权访问的内容完成任务,再把结果交给你检查。
给出运单号及查询所需的手机验证信息。
读取各包裹可查询的物流节点。
核对最新节点,标出已报告的异常。
依据节点时间与地点,说明当前派送进度。
复制示例,补充具体信息,然后在已接入的团队聊天中发给 Leina。
汇总最新物流节点,标出返回记录中的派送异常。
查询这些顺丰运单号 [运单号],对应寄件或收件手机号后四位是 [尾号]。按包裹整理最新节点、时间、地点和已报告的派送异常。
验证拟寄订单,并查看返回的服务时段。
检查这份顺丰寄件能否受理:订单编号 [编号]、产品 [类型]、寄件人 [联系人与地址]、收件人 [联系人与地址]、物品 [名称]。说明问题和返回的服务时段,先不要下单。
根据寄收地址和重量查询产品时效,以及可返回的运费估算。
比较从 [寄件地址] 到 [收件地址]、重 [公斤]、计划 [日期和时间] 寄出的顺丰方案。列出返回的送达时段与价格,未提供价格的请标注。
下一项 顺丰速运 工作,从一条消息开始。
在团队聊天中告诉 Leina 你的需求,说明数据来源、保存位置和预期结果。
提供顺丰开放平台 partnerId、checkWord,以及已配置签名算法和 sandbox 设置。
提供资料来源、结果的保存位置,以及你希望完成的工作。
查看任务结果,并核对应用中的变更。
把这些日常工作交给你的 AI 员工。
查询最多 10 个顺丰快件的物流路线(追踪事件)。仅运单仅针对使用与您的 partnerID 绑定的月卡支付的货件查询回程路线;对于任何其他货件,请在 check_phone_nos 中传递发件人或收件人电话的最后 4 位数字。只有最近 3 个月的货物有路线。
查询始发地和目的地的顺丰速运时效标准,可选择每个产品的运费价格。
查询顺丰运单承诺派送时间,通过寄件人或收件人电话号码或支付运单的月卡验证。
检查运单号是否为有效的顺丰运单号。
下单前请检查始发地和目的地地址是否在顺丰收派范围内(筛单)。
列出某个地址或坐标周围附近的顺丰速运服务点(自营服务点、合作商家店、顺丰站、丰巢柜等)。
推荐顺丰速运产品以及价格和承诺的货件送达时间。
推荐增值服务(保鲜、保价、定时派送等)以及所选产品的发货价格。
检查某个地址的顺丰收件是否可以按计划时间送达,可选择退回服务窗口。
创建真实的顺丰快运订单(下订单)并分配运单号;可能会收取费用。支持中国大陆及港澳台线路。响应中包含筛选结果(filterResult)和分配的运单号。使用 pre_order 验证订单而不创建订单。
验证是否接受顺丰速运订单(预下单)——检查货物、月卡、地址可达性和数量控制——无需创建订单,并返回可用的服务时间窗口。
发货前确认 (deal_type inform) 或取消 (deal_type cancel) 顺丰速运订单,可选择更新重量、体积或收件人地址。确认需要运单号码。已取消的订单号无法重复使用。
查询之前下的顺丰订单的处理结果,例如当 create_order 响应从未到达时。
为现有顺丰速运订单分配额外的子运单号,每次调用最多 20 个。
拦截、重定向、退回或调整在途顺丰运单(截单转寄返回),例如重定向至新地址或退回寄件人。仅限已领取的运单;使用 update_order 取消未发货的订单。
发送顺丰运单派件通知,用于货物提前入库的预售场景。
通过订单号(仅限您的 partnerID 下的订单)或运单号(运单月卡必须与您的 partnerID 绑定)查询顺丰快件的运费明细(清单运费)。
注册顺丰订单或运单进行路线(追踪)推送。前提:SF 控制台已配置路由推送回调(控制台 → 开发者对接 → 查看 API → 路由注册接口 → 配置信息);注册后,SF 将路由更新推送到该地址。
注册运单进行运单图片推送(回单回单、清单清单、拍照回传照片证明等)。SF 生成 AES 加密图片后,将其推送到配置的回调中;签收后再登记,因为图片制作较晚。解密密钥来自 SF 控制台(控制台→开发者活动→查看 API→图片注册及自治接口)。
从云打印模板(云打印面单转 PDF)生成运单 PDF 打印文件。返回需要 X-Auth-token 标头中返回的令牌的下载 URL(24 小时有效)。
将运单转换为打印机命令集(云打印面单转指令、cpcl 或 zpl),以文本或可下载文件形式内嵌返回。
对于已集成菜鸟打印组件的系统,将运单转换为菜鸟打印模板 URL(云打印面单转菜鸟模板)。
从云打印模板(云打印面单转 HTML)生成运单 HTML 打印文件。返回需要 X-Auth-token 标头中返回的令牌的下载 URL(24 小时有效)。
大同城同城货运单提交运单打印内容。默认异步:返回一个打印批号以用 sf_express.query_citywide_print_status 进行轮询;同步模式(最多 20 个文档)直接返回文件。
查询大同城全市批量打印的状态和生成的 PDF 文件。
列出商家发布的自定义打印模板及其占位符字段(ISV 自定义模板列表)。
保存商家自定义打印模板(ISV 保存自定义模板);相同的名称意味着相同模板的新版本。内容遵循 SF 标记语言规范。
删除商家自定义打印模板(ISV 删除自定义模板);SF 限制每个帐户的模板数量,因此请在添加新模板之前删除未使用的模板。
检查顺丰冷运是否可以为指定的产品始发地和目的地流提供服务,返回服务点的营业时间和可用温度水平。
估算一个流程和一种或多种产品的顺丰冷链运输费用,返回每种产品的费用明细。
估算一个流程和一种或多种产品的顺丰冷链交货时间,包括提货和交货运输时间。
创建顺丰冷链运输订单(陆运运输)。每月结算付款需要每月帐户 (PR_ACCOUNT)。
取消尚未受理的顺丰冷运订单。
查询顺丰冷运订单生成的运单号(主运单、回签单号、子运单)。
通过运单号、顺丰订单号或客户订单号,结合订单源代码查询顺丰冷链路线事件。
查询顺丰冷运订单的完整明细,包括当事人、重量、货号、增值服务、回签单等。
对于大件或重型货物,下顺丰货运 (快运) 零担订单。这仅适用于大件特殊场景;对于常规包裹,请使用 sf_express.create_order。当提供 waybill_no 时,订单将使用该保留的主运单编号而不是生成一个。
取消顺丰货运零担订单。仅可取消尚未提货的订单。
获取通过快递呼叫(下呼叫)下达的顺丰零担订单的最新派送结果,包括分配的运单号。
将分运单编号附加到顺丰货运零担订单中,供发货人在装箱后确定包裹数量。提货前只拥有订单;每个订单最多 1200 个分运单。如果运单已经打印,请稍后重新打印。
检查地址是否在顺丰货运取货或送货覆盖范围内(订单筛单)。
查询顺丰快运产品在两个地址之间的标准基础运费。定价时至少需要重量、尺寸或声明值之一。
注册顺丰货运运单,进行运单图片推送。推送到达前,必须在 SF 控制台配置图片推送回调。
查询顺丰跨境大件运单路径。对于转单号 (转单号),请使用 Freight_query_crossborder_transfer_routes。
查询顺丰跨境大件货件转单号的路线事件。
列出顺丰跨境大件母运单的转单号。
向顺丰客服报告顺丰快运快件的工单。
回复顺丰货运工单,由 work_order_id 或 report_source_no(至少一个)标识。
创建顺丰整车直达订单。设置 generate_waybill_no,让 SF 分配运单号,或者传递您自己的 waybill_no。当 pay_method 为 1(寄付月结)或 2(寄付转第三方)时,需要月卡(monthly_card)。
取消顺丰货运整车订单。仅当订单处于可取消状态时取消才成功;否则错误消息会解释原因。
通过客户订单号查询顺丰货运整车订单;当你有 waybill_no 时,也传递它。
创建顺丰货运运单的车辆轨迹回放页面 URL。需要支付运单的月卡。
下达顺丰同城配送(城市商品货运)订单。send_start_time 必须至少为未来 2 小时。
下单前请计算顺丰同城配送的运费。
列出顺丰货运城市配送订单的订购电话号码,以及可选的时间和分页过滤器。
通过订单号或客户订单号获取顺丰同城派送订单详情。
取消顺丰货运同城配送订单。
列出顺丰同城派送中某个城市和车型可享受的增值服务。
列出顺丰同城派送中某个城市及业务场景可用的车型。
列出顺丰货运可派送的城市。
获取顺丰货运城市派送中某城市可用的取件预约时间窗口。
将安装服务附加到现有 SF 运单。提货后才确认追加;最终结果通过安装状态推送到达。该接口需要顺丰销售上线(联系客户经理)。
创建 SF 安装订单 (安装单下单):仅安装、提货并安装或维修。
更新安装订单的客户信息、非 SF 物流信息或货物图像。客户和物流信息只能在分配主数据之前更改;在签署运单之前,货物图像可能会发生变化。
取消附加安装服务;运单不得被领取。
按客户订单号查询 SF 安装订单的状态和费用明细。
创建顺丰回收单(回收单下单)以进行上门货物回收。取货日期必须在 3 天内,窗口全时段为 08:00 至 21:00。
将安装订单的货物标记为已到达 (到货通知),可以选择填写取货地址。仅支持未到达到到达的转换。
取消顺丰恢复订单;一旦主人到来,就不可能了。
查询完整顺丰回收产品目录(回收品类)。列表很大,完整返回;缓存它而不是重复调用。
查询一张或多张顺丰月卡绑定的宅配规则。
审核增值服务请求(审核增值服务),例如 JZ17 报表返现服务。
向 SF 作为供应商报告安装任务操作节点:指派主控、取货、预约、到货检查、完成、审核、故障检测等。必填字段取决于操作代码;代码 3、17、20、21 需要图像。
查询供应商师傅可以为安装任务提供的预约时间(送装愉快可预约时间)。
提交投标安装订单的供应商主报价 (回传报价)。
报告竞价安装订单的操作节点(供应商自主报价操作节点回传)。opera_data 所需的 key 取决于 operate_code:OP000006 需要 installMaster+installConcat,OP000004 需要 appTime,OP000008/OP000001/OP000010 需要 imgUrl,OP000013 需要 closeReason。
报告船长对投标安装订单增加费用请求的决定。
作为供应商申请投标安装订单的附加费(供应商侧发起增加费用)。
查询供应商增加费用申请结果(增加费用结果查询);结果推送或报告失败时的回退。
报告主人对投标安装订单退款请求的决定。
报告招标安装订单的投诉处理结果(接收投诉结果)。
处理投诉时要求客户补充证据(通知用户补充举证)。截止日期默认为通知时间后 12 小时。
提交师傅举证回传,以投诉投标安装单。
上传顺丰货运转运单收件人签名或其他投递证明图片;顺丰审核后在运单上签字。图像 URL 必须可公开访问。
承运商分配司机后,上传顺丰货运订单的取货司机信息。
一次调用即可上传一张顺丰货运运单的多个车辆轨迹点。所有轨迹点必须属于同一运单号。
上传顺丰货运转运单备注。
上传顺丰货运转运单回签单号。
上传顺丰货运货件的实时订单状态更新。
上传顺丰货运转运运单的路线事件。增量上传,最新的在前;覆盖所有装货、卸货和发货节点(对已签名节点使用 freight_forward_upload_sign_image)。
上传 1 个车辆轨迹点作为顺丰货运转运运单。
在顺丰货运代理运单上申请附加最后一公里费用;目前仅支持入仓垫付(入仓预付,类型 50)。
为一张或多张顺丰货运代理运单下标快到付订单。
报告顺丰货运转运运单的异常情况,例如损坏、计数错误、延误或重新称重申诉。代码 SIGN_03/SIGN_05/SIGN_15/TRANSITING_15 需要延迟天数;重新称重代码 HANDOVER_06/TRANSITING_17 需要“weight”和“sub_items”。
获取未付款顺丰货代运单的付款二维码。
将顺丰货代运单付款与月结卡号绑定,收取费用。需要月卡。
上传顺丰货运回执的路线事件。增量上传,最新的在前;覆盖所有装卸、出库、签收节点。
作为承运代理报告顺丰跨境大件快件的物流轨迹。路由先存储最新的;里程碑值使相应的节点对最终客户可见。
下顺丰跨境大件订单并获取主运单号和分运单号。当 settlement_type 为 2(寄付月结)时,需要月卡(monthly_card)。
查询顺丰跨境大件货件是否有目的地邮编,返回地址信息和偏远地区标志。
启动顺丰跨境大件运单打印下载并获取打印批号。
获取由 Freight_crossborder_get_print_batch 创建的打印批次的运单打印文件下载 URL。
作为承运代理确认并更新 FBA 货件的新交货窗口选项。
作为承运代理查询 FBA 货件的可选配送窗口选项。
作为承运代理查询 FBA 货件当前的派送窗口。
查询顺丰跨境大件运单的投递凭证信息。
上传 SF 跨境大件运单的投递证明文件,作为可公开访问的文件 URL。
通过运单号取消一笔或多笔顺丰跨境大件订单。
批量上传合作站持有的运单 600 条航线(滞留件盘点)。
报告外部车站运单异常退货(驿站异常件退件处理)。
检查运单号是否为顺丰运单号,车站通道。
查询车站通道的运单路径事件。
向车站持有的运单收件人发送取件通知短信。
向收件人或发件人发送运单的固定模板通知短信。
批量上传便利店运单的 600 条航线(滞留件盘点)。
通过车站通用查询 API 查询运单是否为集中(集收/集派)快件。
提交或更新外包站区域的区域外包信息变更。
创建或更新机器人/智能柜频道站(渠道新增/修改)。创建时省略 virtual_addr;更新的时候传过去。
创建或更新笼车柜;sn 字段是 upsert 键。
报告商店运单异常退货(机场异常件退件处理)。
检查渠道操作员是否可以在门店办理运单(渠道可派件交接管控)。
登记顾客到商店的寄件(顾客到店寄件)。当 receiver_ payment 为 0(寄付)时,需要重量、pack_fee、insurance_money 和 insurance_fee。
登记顺丰小哥到店收件(顺丰小哥到店收件)。
登记某店铺收到顺丰快递(门口接收小哥派件)转来的包裹。
登记顾客在商店提取包裹(顾客到店取件)。当 receiver_ payment 为 1(到付)时,需要重量、pack_fee、insurance_money、insurance_fee 和 successful_payed_fee。
查询车站信息。需要 virtual_addr 或 store_code 之一。返回的字段名称因 api_version 而异。
检查丰巢柜件投递费是否按月结算(丰巢订单结算结算,订单类型 1 派件投柜)。租赁和预订订单类型具有不同的有效负载,因此不包括在内。
创建或更新 Hive Box 区域外包商店(丰巢区域外包商店新增及更新)。
创建或更新驿收发区域外包商店(驿收发区域外包商店新增及更新)。
创建或更新乡镇代理站(乡镇代理基本信息新增)。
上传乡镇代理站的外部和内部图像(乡镇代理图片上传)。
创建或更新城市车站的基本信息(驿站基本信息新增/更新)。当 outsource_flag 为 1 时,outsource_info 被保存,并且是驿收发/丰巢商店所需的。
创建或更新星管家电台的基本信息(星管家基本信息新增)。
上传星管家电台的身份、脸部和财产图像(星管家相册新增);Identity_file_names 必须恰好包含 2 个图像。
获取直接上传图片的 OSS token(获取 OSSToken 信息)。oss_client_name 和 path_id 值来自您的顺丰速运联系人。
查询快递员在车站的班次的网格/箱分配(星管家排班信息查询)。
为一个站点上传一张 base64 图片(图片上传);图像不得超过 200 KB。
提交或更新丰巢服务站信息接收或更新。
更新星管家运单的派送及审核费用信息(星管家运单及悲伤费更新)。
更新星管家电台的每月保险费(星管家保险费更新)。
提交运单的收货信息及其费用、服务、标记和附加列表(回单信息)。
查询运单联系人、付款人和费用明细(通用运单查询)。响应中的电话和地址字段由顺丰加密。
上传 Hive Box 服务站的店面和内部图片(丰巢服务站相册新增)。
上传车站相册图像(新增),例如外观、许可证、海报和标牌照片。
提交站内任务品牌检查图片(品牌巡检相册新增);重新提交相同的 task_id 会更新其图像。
实物交接前,在外部驿站派件预入库预存运单。
在外部车站(外部驿站派件入库,657 路)办理配送运单。
客户提货时在外部车站查看运单(外部驿站派件出库,658 路)。
创建或更新外部站(新增/修改外部驿站)。创建时省略 virtual_addr;传递它来更新现有的电台。
将营业执照、备案或相册图像文件名附加到外部站(外部驿站上传营业执照、最终备案、相册)。
从外部车站发送运单的取货代码短信(外部站驿传送短信)。
检查运单是否对外站操作有效(外部驿站运单校验);没有收件人手机的顺丰运单无法接收站内短信。
报告临时站暂存运单(驿站暂存):bill_type 1 = 收端暂存(路线 410),2 = 派端暂存(路线 210)。
检查渠道和快递员是否可以派件管控。信道码由 SF 分配(联系 868850)。
在合作站验证客户的运单取件密码(验证取件密码)。
连接工作中使用的 App,让 Leina 获取任务需要的信息,继续推进工作。
包裹 B 的最新路由记录显示派送异常,包裹 A 正在派送。
不会。下单前检查只校验拟寄信息;创建寄件订单是另一项操作,可能产生费用。
查询未绑定到当前连接月结账户的运单时,需要提供寄件人或收件人手机号后四位。
面单链接需要访问验证,24 小时后失效。请在有效期内保存或打印文件。
从手头的一项工作开始。告诉 Leina,你想要什么样的结果。
连接 顺丰速运,选择要共享的内容,就可以交代第一项任务。