海外订单最晚交期查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md 安装规范名 @user_ac9585d3/platform-order-progress-last-delivery-date 的技能到当前 AI 助手。
技能介绍
这个接口解决什么问题
海外运营平台的订单进度链路里,"这批订单最晚什么时候必须交付"是一个高频但依赖平台数据的问题。无论是给销售承诺交期、倒推排产窗口,还是安排头程物流,都需要基于订单的 ordenIds 拿到准确的最晚交期(last_delivery_date)。如果由人工在运营后台逐单翻查,或者让上层 agent 直接拼装 HTTP 调用,会面临两个麻烦:接口地址与鉴权方式散落在各处,容易用错环境;多步骤业务链路里夹杂了查询逻辑,难以复用。这个 skill 把"查询最晚交期"收敛成一次原子调用,让编排层只关心流程顺序。
它如何工作
这个 skill 是最小颗粒度的接口封装,只负责一个平台动作:last_delivery_date。
- 固定入口:正式环境地址写死在 frontmatter 的
base_url中,即GET https://www.kutetailor.com/api/order/order/orden/getLastDeliveryDate,执行器不接受用户输入覆盖地址。 - 唯一 action:
last_delivery_date对应 HTTP GET,URL 为/order/orden/getLastDeliveryDate,查询参数是ordenIds,返回RS。 - 参数约定:tool arguments 统一使用嵌套的
params对象——最外层只放params,不要写成params.xxx这类点号顶层 key;Path 参数进params.path,Query 参数进params.query,JSON Body 进params.body,额外 Header 进params.headers。 - 鉴权方式:登录态接口通过
params.accessToken生成Authorization: Bearer;如果传入值已包含Bearer,不要重复拼接。 - 响应处理:返回结果以接口响应为事实来源,不做库存、价格、订单号、优惠金额或物流状态的补造;遇到认证、权限、参数或业务错误,把原始错误码和错误信息原样传给上层 agent。
适用边界
- 这是一个查询/计算类接口,不构成完整业务链路。需要组合多个步骤时,由上层 agent 按聚合 skill(
platform-order-progress)或计划文档编排多个原子 skill,本 skill 只完成自己这一步,并把关键返回字段交给后续 skill。 - 调用仍然受当前登录态、租户和用户权限约束,不是无状态的公开接口。
base_url、method 和参数位置都以上表为准,POST/PUT 默认发送 JSON body;如果上层网关另有约定,以网关契约为准。
使用场景
- 销售向海外客户承诺交付时间前,按一批订单号查询最晚交期,确认可承诺的交付窗口。
- 排产前根据订单的 ordenIds 查询最晚交期,倒推生产完工与头程物流的起始时间。
- 上层 agent 编排订单进度链路时,调用本接口获取最晚交期字段,再交给后续 skill 继续处理。
- 运营复核订单交付风险时,按 ordenIds 查询最晚交期,与当前进度对照判断是否紧张。
适合人员
- 需要向海外客户承诺交付时间的外贸销售或跟单员
- 负责海外订单排产与物流窗口倒推的供应链计划员
- 用 agent 编排订单进度查询链路的平台集成工程师
- 需要核对订单交付风险的海外运营专员