获取客户拜访记录表 API

Path	Method	Created At
/api/customers/visits/paginate	POST	2025-11-29 00:39:11

Request

Key	Rule	Description
customer_id	string,size:24	客户不存在
page	integer,min:1,max:100	页码必须是正整数
page_size	integer,min:5,max:1000	每页数量必须是正整数

Response

Key	Type	Example	Comment
id	string	1	拜访记录ID
boId	string	7da823	商机编号
title	string	张三	拜访标题
contents	string	说说	拜访内容
feedback	string	挺好	客户反馈
expenses	float	23.34	花费
actionItems	string	落实会议要求	下一步计划
problem	string	没有问题	存在的问题
outcome	string	合作圆满	成果
type	enum	CustomerActivityType	拜访类型
source	string	CUSTOMER	来源
projectStage	string	TARGET	阶段ID
projectStagePath	string	["需求沟通", "技术交流"]	项目阶段
participants	object_array		参与人员
-> id	int	1	用户编号
-> name	string	张三	姓名
createdAt	string	2024-12-19 14:52:00	创建时间
createdBy	int	1	创建人
createdByName	string	李四	创建人姓名

TypeScript Result Example:

interface Participants {
  /** 用户编号 */
  id: number;
  /** 姓名 */
  name: string;
}

interface Result {
  /** 拜访记录ID */
  id: string;
  /** 商机编号 */
  boId: string;
  /** 拜访标题 */
  title: string;
  /** 拜访内容 */
  contents: string;
  /** 客户反馈 */
  feedback: string;
  /** 花费 */
  expenses: any;
  /** 下一步计划 */
  actionItems: string;
  /** 存在的问题 */
  problem: string;
  /** 成果 */
  outcome: string;
  /** 拜访类型 */
  type: ResultType;
  /** 来源 */
  source: string;
  /** 阶段ID */
  projectStage: string;
  /** 项目阶段 */
  projectStagePath: string;
  /** 参与人员 */
  participants: Participants[];
  /** 创建时间 */
  createdAt: string;
  /** 创建人 */
  createdBy: number;
  /** 创建人姓名 */
  createdByName: string;
}

enum ResultType {
  /** 销售活动 */
  SALES = "SALES",
  /** 售前活动 */
  PRE_SALES = "PRE_SALES",
  /** 售后活动 */
  AFTER_SALES = "AFTER_SALES",
  /** 联合活动 */
  JOINT = "JOINT",
  /** 商务拜访 */
  BUSINESS_VISIT = "BUSINESS_VISIT",
  /** 其他活动 */
  OTHER = "OTHER"
}

Enums

CustomerActivityType

Const	Description
SALES	销售活动
PRE_SALES	售前活动
AFTER_SALES	售后活动
JOINT	联合活动
BUSINESS_VISIT	商务拜访
OTHER	其他活动