跟踪已验证运单
使用正确手机验证输入读取路由事件。
/oo 顺丰速运: 查询顺丰运单号[最多十个运单号],check_phone_nos 为寄件或收件手机号后四位[数字],总结返回路由事件。
让接入的 AI 助手查询物流路由与时效、下单前验证寄件信息,并管理支持的寄件和打印操作。说明目标和需要处理的记录,便于它调用对应操作。
将提示词复制到已安装 oo Skill 的 Agent,补充页面链接和原始笔记后执行。
使用正确手机验证输入读取路由事件。
/oo 顺丰速运: 查询顺丰运单号[最多十个运单号],check_phone_nos 为寄件或收件手机号后四位[数字],总结返回路由事件。
验证拟寄订单,不创建实际运单。
/oo 顺丰速运: 为顺丰 order_id [ID]、express_type_id [ID]、sender [详情]、recipient [详情]、cargo_name [名称]执行 pre_order,解释受理情况与可用时段。
在 Agent 中配置 oo CLI 和 oo Skill。
安装 OOMOL →提供顺丰开放平台 partnerId、checkWord,以及已配置签名算法和 sandbox 设置。
连接 顺丰速运 →使用 /oo,说明要读取的页面、修改的内容和保存位置。
连接指南 →选择你的 Agent
顺丰速运 集成向 AI 助手开放支持的服务操作,可用于查询物流路由与时效、下单前验证寄件信息,并管理支持的寄件和打印操作。
读取路由、承诺时间、服务时效和运费详情。
验证订单或创建实际寄件,并检查处理结果。
使用云模板生成 PDF、HTML 或打印机指令。
查询最多10个顺丰快件的物流路线(追踪事件)。仅运单仅针对使用与您的partnerID绑定的月卡支付的货件查询回程路线;对于任何其他货件,请在 check_phone_nos 中传递发件人或收件人电话的最后 4 位数字。只有最近 3 个月的货物有路线。
sf_express.search_routes 查询始发地和目的地的顺丰速运时效标准,可选择每个产品的运费价格。
sf_express.query_delivery_time_price 查询顺丰运单承诺派送时间,通过寄件人或收件人电话号码或支付运单的月卡验证。
sf_express.estimate_delivery_time 检查运单号是否为有效的顺丰运单号。
sf_express.validate_waybill_no 下单前请检查始发地和目的地地址是否在顺丰收派范围内(筛单)。
sf_express.filter_order 列出某个地址或坐标周围附近的顺丰速运服务点(自营服务点、合作商家店、顺丰站、丰巢柜等)。
sf_express.query_service_points 推荐顺丰速运产品以及价格和承诺的货件送达时间。
sf_express.recommend_product 推荐增值服务(保鲜、保价、定时派送等)以及所选产品的发货价格。
sf_express.recommend_vas 检查某个地址的顺丰收件是否可以按计划时间送达,可选择退回服务窗口。
sf_express.check_pickup_time 创建真实的顺丰快运订单(下订单)并分配运单号;可能会收取费用。支持中国大陆及港澳台线路。响应中包含筛选结果(filterResult)和分配的运单号。使用 pre_order 验证订单而不创建订单。
sf_express.create_order 验证是否接受顺丰速运订单(预下单)——检查货物、月卡、地址可达性和数量控制——无需创建订单,并返回可用的服务时间窗口。
sf_express.pre_order 发货前确认 (deal_type inform) 或取消 (deal_type cancel) 顺丰速运订单,可选择更新重量、体积或收件人地址。确认需要运单号码。已取消的订单号无法重复使用。
sf_express.update_order 查询之前下的顺丰订单的处理结果,例如当create_order响应从未到达时。
sf_express.query_order_result 为现有顺丰速运订单分配额外的子运单号,每次调用最多 20 个。
sf_express.get_sub_waybill_nos 拦截、重定向、退回或调整在途顺丰运单(截单转寄返回),例如重定向至新地址或退回寄件人。仅限已领取的运单;使用 update_order 取消未发货的订单。
sf_express.intercept_order 发送顺丰运单派件通知,用于货物提前入库的预售场景。
sf_express.send_delivery_notice 通过订单号(仅限您的partnerID下的订单)或运单号(运单月卡必须与您的partnerID绑定)查询顺丰快件的运费明细(清单运费)。
sf_express.query_waybill_fee 注册顺丰订单或运单进行路线(追踪)推送。前提:SF控制台已配置路由推送回调(控制台 → 开发者对接 → 查看API → 路由注册接口 → 配置信息);注册后,SF 将路由更新推送到该地址。
sf_express.register_route_push 注册运单进行运单图片推送(回单回单、清单清单、拍照回传照片证明等)。 SF生成AES加密图片后,将其推送到配置的回调中;签收后再登记,因为图片制作较晚。解密密钥来自SF控制台(控制台→开发者活动→查看API→图片注册及自治接口)。
sf_express.register_waybill_picture_push 从云打印模板(云打印面单转PDF)生成运单PDF打印文件。返回需要 X-Auth-token 标头中返回的令牌的下载 URL(24 小时有效)。
sf_express.print_waybill_pdf 将运单转换为打印机命令集(云打印面单转指令、cpcl 或 zpl),以文本或可下载文件形式内嵌返回。
sf_express.print_waybill_command 对于已集成菜鸟打印组件的系统,将运单转换为菜鸟打印模板 URL(云打印面单转菜鸟模板)。
sf_express.print_waybill_cainiao_template 从云打印模板(云打印面单转HTML)生成运单 HTML 打印文件。返回需要 X-Auth-token 标头中返回的令牌的下载 URL(24 小时有效)。
sf_express.print_waybill_html 大同城同城货运单提交运单打印内容。默认异步:返回一个打印批号以用 sf_express.query_citywide_print_status 进行轮询;同步模式(最多 20 个文档)直接返回文件。
sf_express.submit_citywide_print 查询大同城全市批量打印的状态和生成的PDF文件。
sf_express.query_citywide_print_status 列出商家发布的自定义打印模板及其占位符字段(ISV 自定义模板列表)。
sf_express.list_print_templates 保存商家自定义打印模板(ISV 保存自定义模板);相同的名称意味着相同模板的新版本。内容遵循SF标记语言规范。
sf_express.save_print_template 删除商家自定义打印模板(ISV删除自定义模板); SF 限制每个帐户的模板数量,因此请在添加新模板之前删除未使用的模板。
sf_express.delete_print_template 检查顺丰冷运是否可以为指定的产品始发地和目的地流提供服务,返回服务点的营业时间和可用温度水平。
sf_express.coldchain_check_transport_flow 估算一个流程和一种或多种产品的顺丰冷链运输费用,返回每种产品的费用明细。
sf_express.coldchain_estimate_transport_fee 估算一个流程和一种或多种产品的顺丰冷链交货时间,包括提货和交货运输时间。
sf_express.coldchain_estimate_delivery_time 创建顺丰冷链运输订单(陆运运输)。每月结算付款需要每月帐户 (PR_ACCOUNT)。
sf_express.coldchain_create_order 取消尚未受理的顺丰冷运订单。
sf_express.coldchain_cancel_order 查询顺丰冷运订单生成的运单号(主运单、回签单号、子运单)。
sf_express.coldchain_query_waybill_no 通过运单号、顺丰订单号或客户订单号,结合订单源代码查询顺丰冷链路线事件。
sf_express.coldchain_query_route 查询顺丰冷运订单的完整明细,包括当事人、重量、货号、增值服务、回签单等。
sf_express.coldchain_query_order_info 对于大件或重型货物,下顺丰货运 (快运) 零担订单。这仅适用于大件特殊场景;对于常规包裹,请使用 sf_express.create_order。当提供 waybill_no 时,订单将使用该保留的主运单编号而不是生成一个。
sf_express.freight_create_ltl_order 取消顺丰货运零担订单。仅可取消尚未提货的订单。
sf_express.freight_cancel_ltl_order 获取通过快递呼叫(下呼叫)下达的顺丰零担订单的最新派送结果,包括分配的运单号。
sf_express.freight_get_ltl_order_result 将分运单编号附加到顺丰货运零担订单中,供发货人在装箱后确定包裹数量。提货前只拥有订单;每个订单最多 1200 个分运单。如果运单已经打印,请稍后重新打印。
sf_express.freight_append_ltl_sub_waybill 检查地址是否在顺丰货运取货或送货覆盖范围内(订单筛单)。
sf_express.freight_check_address_reachable 查询顺丰快运产品在两个地址之间的标准基础运费。定价时至少需要重量、尺寸或声明值之一。
sf_express.freight_query_standard_price 注册顺丰货运运单,进行运单图片推送。推送到达前,必须在 SF 控制台配置图片推送回调。
sf_express.freight_register_ltl_picture_push 查询顺丰跨境大件运单路径。对于转单号 (转单号),请使用 Freight_query_crossborder_transfer_routes。
sf_express.freight_query_crossborder_route 查询顺丰跨境大件货件转单号的路线事件。
sf_express.freight_query_crossborder_transfer_routes 列出顺丰跨境大件母运单的转单号。
sf_express.freight_list_crossborder_transfer_nos 向顺丰客服报告顺丰快运快件的工单。
sf_express.freight_report_work_order 回复顺丰货运工单,由work_order_id或report_source_no(至少一个)标识。
sf_express.freight_reply_work_order 创建顺丰整车直达订单。设置generate_waybill_no,让SF分配运单号,或者传递您自己的waybill_no。当 pay_method 为 1(寄付月结)或 2(寄付转第三方)时,需要月卡(monthly_card)。
sf_express.freight_create_tl_order 取消顺丰货运整车订单。仅当订单处于可取消状态时取消才成功;否则错误消息会解释原因。
sf_express.freight_cancel_tl_order 通过客户订单号查询顺丰货运整车订单;当你有 waybill_no 时,也传递它。
sf_express.freight_query_tl_order 创建顺丰货运运单的车辆轨迹回放页面URL。需要支付运单的月卡。
sf_express.freight_create_vehicle_track_url 下达顺丰同城配送(城市商品货运)订单。 send_start_time 必须至少为未来 2 小时。
sf_express.freight_city_confirm_order 下单前请计算顺丰同城配送的运费。
sf_express.freight_city_calc_fee 列出顺丰货运城市配送订单的订购电话号码,以及可选的时间和分页过滤器。
sf_express.freight_city_list_orders 通过订单号或客户订单号获取顺丰同城派送订单详情。
sf_express.freight_city_get_order_detail 取消顺丰货运同城配送订单。
sf_express.freight_city_cancel_order 列出顺丰同城派送中某个城市和车型可享受的增值服务。
sf_express.freight_city_list_available_vas 列出顺丰同城派送中某个城市及业务场景可用的车型。
sf_express.freight_city_list_vehicles 列出顺丰货运可派送的城市。
sf_express.freight_city_list_cities 获取顺丰货运城市派送中某城市可用的取件预约时间窗口。
sf_express.freight_city_list_appointment_times 将安装服务附加到现有 SF 运单。提货后才确认追加;最终结果通过安装状态推送到达。该接口需要顺丰销售上线(联系客户经理)。
sf_express.freight_append_install_service 创建 SF 安装订单 (安装单下单):仅安装、提货并安装或维修。
sf_express.freight_create_install_order 更新安装订单的客户信息、非 SF 物流信息或货物图像。客户和物流信息只能在分配主数据之前更改;在签署运单之前,货物图像可能会发生变化。
sf_express.freight_update_install_order 取消附加安装服务;运单不得被领取。
sf_express.freight_cancel_install_order 按客户订单号查询 SF 安装订单的状态和费用明细。
sf_express.freight_query_install_order 创建顺丰回收单(回收单下单)以进行上门货物回收。取货日期必须在3天内,窗口全时段为08:00至21:00。
sf_express.freight_create_recovery_order 将安装订单的货物标记为已到达 (到货通知),可以选择填写取货地址。仅支持未到达到到达的转换。
sf_express.freight_notify_install_arrival 取消顺丰恢复订单;一旦主人到来,就不可能了。
sf_express.freight_cancel_recovery_order 查询完整顺丰回收产品目录(回收品类)。列表很大,完整返回;缓存它而不是重复调用。
sf_express.freight_query_recovery_products 查询一张或多张顺丰月卡绑定的宅配规则。
sf_express.freight_query_delivery_rules 审核增值服务请求(审核增值服务),例如JZ17 报表返现服务。
sf_express.freight_audit_value_added_service 向SF作为供应商报告安装任务操作节点:指派主控、取货、预约、到货检查、完成、审核、故障检测等。必填字段取决于操作代码;代码 3、17、20、21 需要图像。
sf_express.freight_supplier_report_operation_node 查询供应商师傅可以为安装任务提供的预约时间(送装愉快可预约时间)。
sf_express.freight_supplier_query_appointment_times 提交投标安装订单的供应商主报价 (回传报价)。
sf_express.freight_bid_submit_quote 报告竞价安装订单的操作节点(供应商自主报价操作节点回传)。 opera_data所需的key取决于operate_code:OP000006需要installMaster+installConcat,OP000004需要appTime,OP000008/OP000001/OP000010需要imgUrl,OP000013需要closeReason。
sf_express.freight_bid_report_operation_node 报告船长对投标安装订单增加费用请求的决定。
sf_express.freight_bid_report_add_fee_result 作为供应商申请投标安装订单的附加费(供应商侧发起增加费用)。
sf_express.freight_supplier_apply_add_fee 查询供应商增加费用申请结果(增加费用结果查询);结果推送或报告失败时的回退。
sf_express.freight_supplier_query_add_fee_result 报告主人对投标安装订单退款请求的决定。
sf_express.freight_bid_report_refund_result 报告招标安装订单的投诉处理结果(接收投诉结果)。
sf_express.freight_bid_report_complaint_result 处理投诉时要求客户补充证据(通知用户补充举证)。截止日期默认为通知时间后 12 小时。
sf_express.freight_bid_send_evidence_notice 提交师傅举证回传,以投诉投标安装单。
sf_express.freight_bid_submit_master_evidence 上传顺丰货运转运单收件人签名或其他投递证明图片;顺丰审核后在运单上签字。图像 URL 必须可公开访问。
sf_express.freight_forward_upload_sign_image 承运商分配司机后,上传顺丰货运订单的取货司机信息。
sf_express.freight_forward_upload_driver 一次调用即可上传一张顺丰货运运单的多个车辆轨迹点。所有轨迹点必须属于同一运单号。
sf_express.freight_forward_upload_track_batch 上传顺丰货运转运单备注。
sf_express.freight_forward_upload_waybill_remark 上传顺丰货运转运单回签单号。
sf_express.freight_forward_upload_receipt 上传顺丰货运货件的实时订单状态更新。
sf_express.freight_forward_update_order_status 上传顺丰货运转运运单的路线事件。增量上传,最新的在前;覆盖所有装货、卸货和发货节点(对已签名节点使用freight_forward_upload_sign_image)。
sf_express.freight_forward_upload_route 上传1个车辆轨迹点作为顺丰货运转运运单。
sf_express.freight_forward_upload_track 在顺丰货运代理运单上申请附加最后一公里费用;目前仅支持入仓垫付(入仓预付,类型50)。
sf_express.freight_forward_apply_add_fee 为一张或多张顺丰货运代理运单下标快到付订单。
sf_express.freight_forward_place_return_order 报告顺丰货运转运运单的异常情况,例如损坏、计数错误、延误或重新称重申诉。代码 SIGN_03/SIGN_05/SIGN_15/TRANSITING_15 需要延迟天数;重新称重代码 HANDOVER_06/TRANSITING_17 需要“weight”和“sub_items”。
sf_express.freight_forward_report_exception 获取未付款顺丰货代运单的付款二维码。
sf_express.freight_forward_start_pay 将顺丰货代运单付款与月结卡号绑定,收取费用。需要月卡。
sf_express.freight_forward_apply_monthly_payment 上传顺丰货运回执的路线事件。增量上传,最新的在前;覆盖所有装卸、出库、签收节点。
sf_express.freight_forward_upload_return_route 作为承运代理报告顺丰跨境大件快件的物流轨迹。路由先存储最新的;里程碑值使相应的节点对最终客户可见。
sf_express.freight_crossborder_report_trace 下顺丰跨境大件订单并获取主运单号和分运单号。当settlement_type为2(寄付月结)时,需要月卡(monthly_card)。
sf_express.freight_crossborder_place_order 查询顺丰跨境大件货件是否有目的地邮编,返回地址信息和偏远地区标志。
sf_express.freight_crossborder_query_postcode_address 启动顺丰跨境大件运单打印下载并获取打印批号。
sf_express.freight_crossborder_get_print_batch 获取由 Freight_crossborder_get_print_batch 创建的打印批次的运单打印文件下载 URL。
sf_express.freight_crossborder_query_print_result 作为承运代理确认并更新 FBA 货件的新交货窗口选项。
sf_express.freight_crossborder_confirm_delivery_window 作为承运代理查询 FBA 货件的可选配送窗口选项。
sf_express.freight_crossborder_query_delivery_window_options 作为承运代理查询FBA货件当前的派送窗口。
sf_express.freight_crossborder_get_delivery_window 查询顺丰跨境大件运单的投递凭证信息。
sf_express.freight_crossborder_get_pod_info 上传 SF 跨境大件运单的投递证明文件,作为可公开访问的文件 URL。
sf_express.freight_crossborder_upload_pod_files 通过运单号取消一笔或多笔顺丰跨境大件订单。
sf_express.freight_crossborder_cancel_order 批量上传合作站持有的运单600条航线(滞留件盘点)。
sf_express.station_batch_inventory 报告外部车站运单异常退货(驿站异常件退件处理)。
sf_express.station_handle_exception_return 检查运单号是否为顺丰运单号,车站通道。
sf_express.station_verify_waybill_number 查询车站通道的运单路径事件。
sf_express.station_query_waybill_route 向车站持有的运单收件人发送取件通知短信。
sf_express.station_notify_recipient 向收件人或发件人发送运单的固定模板通知短信。
sf_express.station_send_waybill_sms 批量上传便利店运单的600条航线(滞留件盘点)。
sf_express.station_store_batch_inventory 通过车站通用查询API查询运单是否为集中(集收/集派)快件。
sf_express.station_query_centralization 提交或更新外包站区域的区域外包信息变更。
sf_express.station_update_outsource_info 创建或更新机器人/智能柜频道站(渠道新增/修改)。创建时省略virtual_addr;更新的时候传过去。
sf_express.station_upsert_robot_channel 创建或更新笼车柜; sn 字段是 upsert 键。
sf_express.station_upsert_cage_cabinet 报告商店运单异常退货(机场异常件退件处理)。
sf_express.station_store_handle_exception_return 检查渠道操作员是否可以在门店办理运单(渠道可派件交接管控)。
sf_express.station_check_delivery_operation 登记顾客到商店的寄件(顾客到店寄件)。当receiver_ payment为0(寄付)时,需要重量、pack_fee、insurance_money和insurance_fee。
sf_express.station_customer_send_in_store 登记顺丰小哥到店收件(顺丰小哥到店收件)。
sf_express.station_courier_pickup_in_store 登记某店铺收到顺丰快递(门口接收小哥派件)转来的包裹。
sf_express.station_store_receive_delivery 登记顾客在商店提取包裹(顾客到店取件)。当receiver_ payment为1(到付)时,需要重量、pack_fee、insurance_money、insurance_fee和successful_payed_fee。
sf_express.station_customer_pickup_in_store 查询车站信息。需要 virtual_addr 或 store_code 之一。返回的字段名称因 api_version 而异。
sf_express.station_query_store_info 检查丰巢柜件投递费是否按月结算(丰巢订单结算结算,订单类型1派件投柜)。租赁和预订订单类型具有不同的有效负载,因此不包括在内。
sf_express.station_verify_fc_settlement 创建或更新Hive Box区域外包商店(丰巢区域外包商店新增及更新)。
sf_express.station_upsert_fc_outsource_store 创建或更新驿收发区域外包商店(驿收发区域外包商店新增及更新)。
sf_express.station_upsert_ysf_outsource_store 创建或更新乡镇代理站(乡镇代理基本信息新增)。
sf_express.station_save_village_store 上传乡镇代理站的外部和内部图像(乡镇代理图片上传)。
sf_express.station_upload_village_store_images 创建或更新城市车站的基本信息(驿站基本信息新增/更新)。当outsource_flag为1时,outsource_info被保存,并且是驿收发/丰巢商店所需的。
sf_express.station_upsert_store_info 创建或更新星管家电台的基本信息(星管家基本信息新增)。
sf_express.station_save_xgj_store 上传星管家电台的身份、脸部和财产图像(星管家相册新增); Identity_file_names 必须恰好包含 2 个图像。
sf_express.station_upload_xgj_images 获取直接上传图片的OSS token(获取OSSToken信息)。 oss_client_name 和 path_id 值来自您的顺丰速运联系人。
sf_express.station_get_oss_token 查询快递员在车站的班次的网格/箱分配(星管家排班信息查询)。
sf_express.station_query_grid_schedule 为一个站点上传一张base64图片(图片上传);图像不得超过 200 KB。
sf_express.station_upload_picture 提交或更新丰巢服务站信息接收或更新。
sf_express.station_submit_fc_resource 更新星管家运单的派送及审核费用信息(星管家运单及悲伤费更新)。
sf_express.station_update_xgj_waybill_fee 更新星管家电台的每月保险费(星管家保险费更新)。
sf_express.station_update_xgj_insurance_fee 提交运单的收货信息及其费用、服务、标记和附加列表(回单信息)。
sf_express.station_submit_receipt_info 查询运单联系人、付款人和费用明细(通用运单查询)。响应中的电话和地址字段由顺丰加密。
sf_express.station_query_waybill_info 上传 Hive Box 服务站的店面和内部图片(丰巢服务站相册新增)。
sf_express.station_upload_fc_images 上传车站相册图像(新增),例如外观、许可证、海报和标牌照片。
sf_express.station_upload_store_album 提交站内任务品牌检查图片(品牌巡检相册新增);重新提交相同的task_id会更新其图像。
sf_express.station_add_brand_inspection_images 实物交接前,在外部驿站派件预入库预存运单。
sf_express.station_pre_handover_pack 在外部车站(外部驿站派件入库,657路)办理配送运单。
sf_express.station_handover_pack 客户提货时在外部车站查看运单(外部驿站派件出库,658路)。
sf_express.station_customer_receive_pack 创建或更新外部站(新增/修改外部驿站)。创建时省略virtual_addr;传递它来更新现有的电台。
sf_express.station_save_store 将营业执照、备案或相册图像文件名附加到外部站(外部驿站上传营业执照、最终备案、相册)。
sf_express.station_add_store_images 从外部车站发送运单的取货代码短信(外部站驿传送短信)。
sf_express.station_send_sms 检查运单是否对外站操作有效(外部驿站运单校验);没有收件人手机的顺丰运单无法接收站内短信。
sf_express.station_check_waybill 报告临时站暂存运单(驿站暂存):bill_type 1 = 收端暂存(路线 410),2 = 派端暂存(路线 210)。
sf_express.station_temp_store 检查渠道和快递员是否可以派件管控。信道码由SF分配(联系868850)。
sf_express.station_verify_delivery_permission 在合作站验证客户的运单取件密码(验证取件密码)。
sf_express.station_validate_delivery_password 没有匹配的工具。
不会,它验证拟下单信息;create_order 创建实际订单,可能产生费用。
仅运单号查询限于绑定 partnerID 的月结卡寄件,其他运单需寄件或收件手机号后四位。
PDF 和 HTML URL 需要在 X-Auth-token 中提供返回 token,有效期 24 小时。
管理 OOMOL 可以使用哪些可选存储。你随时可以在页脚重新修改这些选择。