# wms-standard-openapi **Repository Path**: WdtWMS/wms-standard-openapi ## Basic Information - **Project Name**: wms-standard-openapi - **Description**: 旺店通WMS标准对外接口SKILL - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-05-28 - **Last Updated**: 2026-11-05 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README --- name: wms-standard-openapi description: 对接 WMS 标准对外接口,发起带签名认证的请求。当用户需要调用 WMS API、查询 WMS 数据或与 WMS 服务集成时使用。 version: 1.0.0-prod --- # WMS标准对外接口请求 Skill 向 WMS 标准对外接口发起带签名认证的 API 请求。 ## 安装方式 ### 方式一:把 Skill 地址发给 AI Agent 直接对 Agent 说: > 请帮我安装这个 Skill: > `https://gitee.com/WdtWMS/wms-standard-openapi.git` > 安装完成后请继续完成初始化,并告诉我如何开始调用 WMS 接口、查询库存和订单数据。 ### 方式二:一行命令安装 ```bash npx skills install https://gitee.com/WdtWMS/wms-standard-openapi.git ``` ## 使用流程 1. **CLI准备** — 优先使用 `dist/linux/wms-standard-openapi-cli`,如果 Linux CLI 暂时不存在,再回退到 Windows CLI 2. **准备凭证** — 读取 `assets/config.json`,若 `url` / `sid` / `appkey` / `appsecret` 为空则向用户索要后写入 3. **获取参数** — 确认接口方法和请求参数(根据用户意图推断或直接询问),已接入接口可先用 `--help api` 或 `--help ` 查看 4. **执行请求** — 调用 CLI 发起带签名的认证请求 5. **返回结果** — 解析 JSON 响应,以可读格式呈现 ## 相关文件 - `cli-prepare.md` - `install/install.sh` - `install/install.ps1` - `more/cli-download.md` ## 当前已接入分类(44 个接口) - 基础信息类(10 个) - 库存类(6 个) - 入库类(5 个) - 出库类(10 个) - 仓内操作类(5 个) - 货主物流单量费用类(5 个) - 售后类(1 个) - 运输管理TMS(1 个) - 立库类(1 个) ## 注意事项 - 接口方法和参数必须符合 WMS 标准对外接口文档,不要自行猜测 - `url`、`sid`、`appkey`、`appsecret` 这些凭证信息需要**联系旺店通WMS的实施同学**获取 - 响应中的错误码原样告知用户,不要自行解释其含义 - 当接口文档要求 `compress_response_body=1` 时,调用时必须显式传入 - 对于复杂数组参数,优先建议使用聊天式收参、`--from-file` 或完整 JSON 请求体,避免 PowerShell 转义干扰 ## 使用示例 **场景一:自然语言查询** > 用户:帮我查一下条码,货主编号 98763210,条码 052603 推断使用 `goods.barcode.query` 接口,参数 `{"owner_no":"98763210","barcode":"052603"}`,返回格式化的货品条码信息。 **场景二:明确指定接口** > 用户:调用 `sys.shop.query`,参数 `sid=abc` 直接使用指定的方法和参数发起请求。 **场景三:先核对请求** > 用户:调用 `stockin.query`,先别真发,参数 `start_check_time=2018-06-01 00:00:00`,`end_check_time=2018-07-01 00:00:00`,`owner_no=test` 使用 `--dry-run` 生成签名和请求体,先给用户核对。