下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-r4wuabfo--crm-order-mgmt.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-r4wuabfo/crm-order-mgmt。35CRM 订单管理模块,涵盖销售合同、合同跟进、销售订单、订单跟进、收款计划、开票记录六大功能。
阅读全文 (展开查看完整说明)
概述
CRM 订单管理
参考文档索引
| 分类 | 文件 | 说明 |
|---|---|---|
| 认证 | [authentication.md](references/authentication.md) | Token 认证流程、请求规范 |
| 基础 | [base.md](references/base.md) | 工具函数、编码规范 |
| 枚举 | [enums.md](references/enums.md) | 时间常量、dbType、searchCondition 通用结构 |
| 销售合同 | [agree_ment.md](references/agree_ment.md) | 查询销售合同列表、新增销售合同 |
| 合同跟进 | [agree_ment_follow.md](references/agree_ment_follow.md) | 查询合同跟进列表、新增合同跟进 |
| 销售订单 | [contract_order.md](references/contract_order.md) | 查询销售订单列表、新增销售订单 |
| 订单跟进 | [contract_order_follow.md](references/contract_order_follow.md) | 查询订单跟进列表、新增订单跟进 |
| 收款计划 | [pay_plan.md](references/pay_plan.md) | 查询收款计划列表、新增收款计划 |
| 开票记录 | [invoice.md](references/invoice.md) | 查询开票记录列表、新增开票记录 |
第一步:收集凭据(每次对话开始时)
尚未获取凭据时,使用 AskUserQuestion 工具一次性收集 2 个参数:
AskUserQuestion({
questions: [
{ header: "平台地址", question: "CRM 平台的 base_url 是什么?",
options: [{ label: "在下方输入平台地址", description: "例如 https://crm.example.com" }] },
{ header: "Token", question: "API Token (PAT) 是什么?",
options: [{ label: "在下方输入 Token", description: "在下方粘贴 Token 字符串" }] },
]
})收集到凭据后,调用 scripts/crm_login.py 验证 Token 有效性:
python scripts/crm_login.py n --base-url <base_url> n --token <token>验证成功输出 JSON:{"success": true, "token": "...", "base_url": "..."}
凭据在当前会话中复用,不要重复询问。
常见操作速查
| 操作 | 接口 | 参考文档 |
|---|---|---|
| 查询销售合同列表 | POST /agreeMent/list | agree_ment.md |
| 新增销售合同 | viewId=AgreeMentAdd → POST /agreeMent/insert | agree_ment.md |
| 查询合同跟进列表 | POST /agreeMentFollow/list | agree_ment_follow.md |
| 新增合同跟进 | viewId=AgreeMentFollowAdd → POST /agreeMentFollow/insert | agree_ment_follow.md |
| 查询销售订单列表 | POST /ContractOrder/list | contract_order.md |
| 新增销售订单 | viewId=ContractOrderAdd → POST /ContractOrder/insert | contract_order.md |
| 查询订单跟进列表 | POST /ContractOrderFollow/list | contract_order_follow.md |
| 新增订单跟进 | viewId=ContractOrderFollowAdd → POST /ContractOrderFollow/insert | contract_order_follow.md |
| 查询收款计划列表 | POST /PayPlan/list | pay_plan.md |
| 新增收款计划 | viewId=PayPlanAdd → POST /PayPlan/insert | pay_plan.md |
| 查询开票记录列表 | POST /Invoice/list | invoice.md |
| 新增开票记录 | viewId=InvoiceAdd → POST /Invoice/insert | invoice.md |
脚本工具
crm_login.py — 验证 Token
python scripts/crm_login.py n --base-url https://xxx n --token xxx输出:{"success": true, "token": "...", "base_url": "..."}
crm_query.py — 通用查询(使用 Token)
python scripts/crm_query.py
--base-url https://xxx
--token xxx
--module-id agree_ment
--limit 25crm_form_submit.py — 通用表单提交(使用 Token)
# 仅查看模板
python scripts/crm_form_submit.py
--base-url https://xxx
--token xxx
--view-id AgreeMentAdd
--template-only
# 提交新增
python scripts/crm_form_submit.py
--base-url https://xxx
--token xxx
--view-id AgreeMentAdd
--data '{"name":"测试合同"}'关键注意事项
- 中文编码:所有含中文的请求必须通过 Python 脚本执行,不能用 Bash 直接 curl(详见 base.md)
- multipart 请求:使用
curl --data-binary @-通过 subprocess 发送 - 日期格式:提交格式必须为
Y-m-d H:i:s(含时间部分),如2026-06-05 00:00:00 - 响应数据位置:解析时用
resp.get('rows') or resp.get('data') or [] - 新增操作:使用通用表单流程(
scripts/crm_form_submit.py):view/form → 解析字段 → insert