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();
};

表格映射

查询参数说明

调用示例

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' } });

调用流程

1. 识别意图：对照"表格映射"确定 table
2. 提取参数：有单号用 where 精确匹配，有关键词用 like 模糊搜索，不足则主动询问
3. 调用接口：使用 erpQuery(table, params) 发起请求
4. 展示结果：以表格形式展示，标注总条数
5. 报错处理：401 提示 Token 过期；空结果提示检查参数

注意事项

• Token 和 API 地址通过环境变量注入，在 openclaw.json 的 skills.entries.iccn-erp.env 中配置
• 更换 Token 只需修改 openclaw.json，无需改动此文件
• 模糊搜索用 like，精确匹配用 where，可同时使用