SOP-002:客户创建快速指南

访问地址

http://localhost:3000/crm/customer

创建步骤

步骤一:进入客户列表页面

  • 点击左侧导航栏的「客户」菜单
  • 页面显示客户列表表格

步骤二:点击「创建客户」按钮

  • 位于页面右上角
  • 点击后弹出创建客户对话框

步骤三:填写必填字段

字段 说明 示例 验证规则
公司名称 客户的完整公司名称 测试公司-QA-E2E-20251221 必填,≥2 字符
客户简称 客户的简短名称 测试QA 必填,≥2 字符
联系电话 客户联系方式 13800138000 必填,≥2 字符

步骤四:提交创建

  • 点击「创建」按钮
  • 系统自动生成客户编号(如 KH20251221-0001)
  • 成功后显示提示信息并自动关闭对话框
  • 新客户出现在列表中

API 接口

创建客户

POST /api/v1/customers

请求体

{
  "customer": {
    "name": "测试公司-QA-E2E-20251221",
    "shortName": "测试QA",
    "phone": "13800138000"
  }
}

响应

{
  "id": 12345,
  "no": "KH20251221-0001",
  "name": "测试公司-QA-E2E-20251221",
  "shortName": "测试QA",
  "phone": "13800138000",
  ...
}

常见问题

Q: 创建时显示"最少两个字符"错误

A: 检查公司名称、客户简称、联系电话字段,确保每个字段至少输入 2 个字符。

Q: 客户编号格式是什么?

A: 系统自动生成,格式为 KH + YYYYMMDD + 序号,例如 KH20251221-0001

Q: 是否可以创建同名客户?

A: 系统允许相同的公司名称或简称,通过客户编号(no)和 ID 来唯一标识客户。

相关文档