cs.crm.customer-follow-ups.list
条件分页查询跟进记录列表
- 请求路由:
cs.crm.customer-follow-ups.list- 交互模型:
Request Stream- 访问限制: 无
请求
RSocket.rs({
"route" : "cs.crm.customer-follow-ups.list",
"args" : {
"search" : "跟进记录查询过滤参数对象",
"pg" : "分页排序参数"
}
});
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
search | Object | 否 | 跟进记录查询过滤参数对象 |
search.clientId | String | 否 | 客户 ID 过滤 |
search.leadId | String | 否 | 线索 ID 过滤 |
search.followMethod | String | 否 | 跟进方式过滤 |
search.dateFrom | String | 否 | 开始时间 |
search.dateTo | String | 否 | 结束时间 |
search.level | String | 否 | 客户等级过滤 |
search.follower | String | 否 | 跟进人过滤 (匹配 username) |
search.legalEntityIds | String[] | 否 | 法人主体id |
search.customerId | String | 否 | 客户id |
search.keyword | String | 否 | 模糊匹配关键字 |
search.from | String | 否 | 查询起始时间,时间样式为RFC3339格式,如:2019-04-18T00:13:39.649Z |
search.to | String | 否 | 查询终止时间,时间样式为RFC3339格式,如:2019-04-19T00:13:39.649Z |
pg | Object | 否 | 分页排序参数 |
pg.page | Number | 否 | 页码,首页从0开始 |
pg.size | Number | 否 | 每页记录,默认为10 |
pg.sort | String[] | 否 | 排序字段清单,默认为升序,需要指定降序时在字段名后面添加desc并用分号隔开。 例如:["id", "crDate;desc"] |
返回
符合查询条件的跟进记录列表 Flux 包装
[ ]
返回属性
| 名称 | 类型 | 说明 |
|---|---|---|
followUpId | String | 跟进记录唯一 ID,格式: FOL20260607-001 |
customer | String | 客户 ID (往来单位id) |
leadId | String | 线索 ID |
customerInfo | Object | 客户信息 |
customerInfo.country | String | 国家 |
customerInfo.countryEn | String | 国家(英文) |
customerInfo.abbreviation | String | 名称缩写 |
customerInfo.address | String | 地址(中文) |
customerInfo.addressEn | String | 地址(英文) |
customerInfo.contactPersons | Object[] | 联系人信息列表,支持多个联系人 |
customerInfo.contactPersons.[].username | String | 用户标识 |
customerInfo.contactPersons.[].name | String | 用户名称 |
customerInfo.contactPersons.[].nameEn | String | 英文称呼,用于外部联系人的英文通知;缺失时不自动翻译姓名。 |
customerInfo.contactPersons.[].mobile | String | 用户手机号 |
customerInfo.contactPersons.[].email | String | 用户邮箱 |
customerInfo.contactPersons.[].position | String | 职位 |
customerInfo.contactPersons.[].contactRoles | String[] | 联系人承担的职责,支持多选;未指定时为空集合 |
customerInfo.bankAccounts | Object[] | 银行账户列表,支持多个账户 |
customerInfo.bankAccounts.[].accountName | String | 开户名称 |
customerInfo.bankAccounts.[].bankName | String | 银行名称 |
customerInfo.bankAccounts.[].bankCode | String | 联行号 |
customerInfo.bankAccounts.[].bankAccount | String | 银行账号 |
customerInfo.bankAccounts.[].currency | String | 币制 |
customerInfo.bankAccounts.[].swiftCode | String | SWIFT CODE |
customerInfo.bankAccounts.[].address | String | 地址 |
customerInfo.bankAccounts.[].isDefault | Boolean | 是否默认 |
customerInfo.invoiceInfo | Object | 开票信息 |
customerInfo.invoiceInfo.companyName | String | 公司名称 |
customerInfo.invoiceInfo.taxIdentificationNumber | String | 纳税识别号 |
customerInfo.invoiceInfo.companyAddress | String | 公司地址 |
customerInfo.invoiceInfo.phone | String | 电话 |
customerInfo.invoiceInfo.bankAccount | String | 银行账号 |
customerInfo.invoiceInfo.contact | String | 联系人 |
customerInfo.invoiceInfo.email | String | 邮箱 |
customerInfo.extraProps | Object | 扩展信息 |
customerInfo.relatedCustomers | Object[] | 关联客户列表 |
customerInfo.relatedCustomers.[].tags | String[] | 该客户赋予当前往来单位的角色标签列表(如 shipper, consignee, importBuyer 等) |
customerInfo.relatedCustomers.[].extraProps | Object | 专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例) |
customerInfo.relatedCustomers.[].unitId | String | 往来单位唯一ID,主键 |
customerInfo.relatedCustomers.[].name | String | 名称(中文) |
customerInfo.relatedCustomers.[].nameEn | String | 名称(英文) |
customerInfo.unitId | String | 往来单位唯一ID,主键 |
customerInfo.name | String | 名称(中文) |
customerInfo.nameEn | String | 名称(英文) |
followMethod | String | 跟进方式 (基础数据id) |
followMethodInfo | Object | 跟进方式信息 |
followMethodInfo.itemId | String | 数据项唯一标识 |
followMethodInfo.name | String | 数据项名称(中文) |
followMethodInfo.nameEn | String | 数据项名称(英文) |
followMethodInfo.extendedProperties | Object | 扩展属性 用于存储一些额外的、非结构化的数据 |
followTime | String | 跟进时间(UTC时间) |
summary | String | 沟通摘要 |
nextPlan | String | 下一步计划 |
remindTime | String | 下次跟进提醒时间(UTC时间) |
follower | Object | 跟进人 |
follower.username | String | 用户标识 |
follower.name | String | 用户名称 |
follower.nameEn | String | 英文称呼,用于外部联系人的英文通知;缺失时不自动翻译姓名。 |
follower.mobile | String | 用户手机号 |
follower.email | String | 用户邮箱 |
follower.position | String | 职位 |
follower.contactRoles | String[] | 联系人承担的职责,支持多选;未指定时为空集合 |
legalEntityId | String | 法人主体id |
customerId | String | 客户id |
extraProps | Object | 扩展属性 |
crBy | String | 创建者 |
upBy | String | 最后修改者 |
crDate | String | 创建时间 |
upDate | String | 最后修改时间 |
tenantId | String | 租户ID |
id | Varies | 获取跟进记录唯一标识 |