dvcrn 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，可同时使用