ERP 系统查询技能
统一调用规范
所有查询统一使用以下方式：
- 方法：POST
- Content-Type：application/json
- URL 格式：
{ERP_API_BASE_URL}/v1/{table}/lists
- Token：从环境变量
ERP_API_TOKEN 读取
const ERP_TOKEN = process.env.ERP_API_TOKEN;
const ERP_BASE_URL = process.env.ERP_API_BASE_URL;
const erpQuery = async (table, params = {}) => {
const url = `${ERP_BASE_URL}/v1/${table}/lists`;
const body = {
page: 1,
pagenum: 50,
like: {},
where: {},
order: {},
...params
};
const response = await fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'authorization': `Bearer ${ERP_TOKEN}`
},
body: JSON.stringify(body)
});
return await response.json();
};
表格映射
| 用户说的 | table 名称 | 说明 |
|---|
| 订单、销售单 | order | 销售订单 |
| 采购单、采购订单 | purchase | 采购单 |
| 需求单、需求 | demand | 需求单 |
| 入库单、入库记录 | purchase_in | 采购入库单 |
| 出库单、出库记录 | order_out | 销售出库单 |
| 客户、客户信息 | customer | 客户档案 |
| 供应商、供应商信息 | supplier | 供应商档案 |
| 现货、库存、有没有货 | products_inventory | 现货库存 |
查询参数说明
| 参数 | 类型 | 说明 |
|---|
| page | number | 页码，默认 1 |
| pagenum | number | 每页条数，默认 50 |
| like | object | 模糊搜索，如 {"model":"ABC"} |
| where | object | 精确过滤，如 {"status":"1"} |
| order | object | 排序，如 {"created_at":"desc"} |
调用示例
const data = await erpQuery('order', { where: { order_no: 'SO20240001' } });
const data = await erpQuery('products_inventory', { like: { model: 'ABS10' } });
const data = await erpQuery('customer', { like: { name: 'ABC公司' } });
const data = await erpQuery('supplier', { like: { name: '某供应商' } });
const data = await erpQuery('purchase', { where: { purchase_no: 'PO20240001' } });
const data = await erpQuery('purchase_in', { where: { purchase_no: 'PO20240001' } });
const data = await erpQuery('order_out', { where: { order_no: 'SO20240001' } });
const data = await erpQuery('demand', { like: { model: 'ABC123' } });
调用流程
- 识别意图：对照"表格映射"确定
table
- 提取参数：有单号用
where 精确匹配，有关键词用 like 模糊搜索，不足则主动询问
- 调用接口：使用
erpQuery(table, params) 发起请求
- 展示结果：以表格形式展示，标注总条数
- 报错处理：401 提示 Token 过期；空结果提示检查参数
注意事项
- Token 和 API 地址通过环境变量注入，在
openclaw.json 的 skills.entries.iccn-erp.env 中配置
- 更换 Token 只需修改
openclaw.json，无需改动此文件
- 模糊搜索用
like，精确匹配用 where，可同时使用