数据列表V2接口

有成产品

一站式解决企业管理难问题，帮助企业快速提升办公效率

“

有成系列产品，基于阿里钉钉平台开发，系统解决了企业多部门的业务需要，全方位提升企业办公效率和管理水平。 ”

全面化—— 管客、管人、管钱、管事，满足企业多方位需求

智能化—— 智能报表、智能会议、智慧费控，让工作更高效

移动化—— 多端支持、移动协同，随时随地完成各项业务操作

产品优势

8大核心优势，整体解决方案，企业的不二选择

安全可靠

基于钉钉平台研发

数据云加密，安全靠谱

易用高效

操作简单易上手

真正为企业办公提效

一体化

一体化的企业办公解决方案

满足企业各角色使用

多端协同

PC、移动协同

数据实时精准同步

灵活应变

经过市场考验

适用于各种类型的企业

功能完整

完善的产品功能和流程

满足复杂场景及个性化使用

快速响应

快速响应客户需求

积极优化改进

服务无忧

多对一服务模式

享受7*12小时无忧服务

接口说明：获取CRM开放的业务对象数据列表

请求说明

请求方式：post

请求参数数据类型：application/json

请求路径：/oapi/corp/v2/data/list.json

请求参数说明：

参数	参数类型	参数必填	说明
corpId	String	是	企业ID
corpAccessToken	String	是	访问企业数据合法性票据
deployId	String	是	业务对象deployId（如：customer、opportunity、sale_order等）
userId	String	否	用户ID，用于数据权限过滤
templateId	String	否	业务对象模板ID
formated	Boolean	否	是否格式化数据，默认false。true时返回格式化后的显示值
conditionConfig	List<Object>	否	筛选条件组列表，结构同V1列表接口
conditionConfig[0].conditions	List<Object>	否	字段条件列表
conditionConfig[0].conditions[0].comparison	String	是	比较符（详见比较符说明）
conditionConfig[0].conditions[0].deployId	String	是	字段所属业务对象deployId
conditionConfig[0].conditions[0].fieldName	String	是	字段英文名称
conditionConfig[0].conditions[0].fieldTitle	String	是	字段中文名称
conditionConfig[0].conditions[0].fieldValue	Object	是	筛选条件内容
conditionConfig[0].conditions[0].domType	String	是	字段类型
orderFields	List<Object>	否	排序字段列表
orderFields[0].fieldName	String	是	排序字段名称
orderFields[0].orderType	String	是	排序方式：asc升序、desc降序
page	Integer	否	页码，默认1
pageSize	Integer	否	每页条数，默认20，最大1000

比较符说明：

具体可参照：常见comparison查询条件组装格式示例

// 文本运算符

CONTAIN("contain", "包含"),

NOT_CONTAIN("not_contain", "不包含"),

YES("yes", "是"),

NOT("not", "不是"),

START("start", "以指定文本开始"),

END("end", "以指定文本结束"),

NULL("null", "空"),

NOT_NULL("not_null", "不为空"),

// 日期时间运算符

EQUAL("equal", "等于"),

NOT_EQUAL("not_equal", "不等于"),

BEFORE("before", "早于"),

AFTER("after", "晚于"),

DATE_RANGE("date_range", "时间段"),

N_DAY_AGO("n_day_ago", "前N天"),

N_DAY_AFTER("n_day_after", "后N天"),

N_MONTH_AGO("n_month_ago", "前N月"),

N_MONTH_AFTER("n_month_after", "后N月"),

BEFORE_N_DAYS("before_n_days", "N天前"),

AFTER_N_DAYS("after_n_days", "N天后"),

BEFORE_N_MONTHS("before_n_months", "N月前"),

AFTER_N_MONTHS("after_n_months", "N月后"),

// 单选多选,选择人组件

IN_ARRAY("in_array", "属于"),

NOT_IN_ARRAY("not_in_array", "不属于"),

REVERSE_IN_ARRAY("reverse_in_array", "在参数内"),

INTERSECTION("intersection", "有交集"),

NO_INTERSECTION("no_intersection", "无交集"),

// 数值金额

MORE("more", "大于"),

LESS("less", "小于"),

MORE_EQUAL("more_equal", "大于等于"),

LESS_EQUAL("less_equal", "小于等于"),

BETWEEN("between", "介于");

请求参数结构：

{

"corpId": "ding2037cc74cbb0f5e735c2f4657eb6378f",

"corpAccessToken": "8355993e7777895b9859f4771511530992ad4c",

"deployId": "customer",

"userId": "manager123",

"templateId": "",

"formated": false,

"conditionConfig": [

{

"conditions": [

{

"comparison": "CONTAIN",

"deployId": "customer",

"fieldName": "custom_name",

"fieldTitle": "客户名称",

"fieldValue": "测试",

"domType": "INPUT"

}

]

}

"orderFields": [

{

"fieldName": "created",

"orderType": "desc"

}

"page": 1,

"pageSize": 20

}

响应结果说明：

参数	参数类型	参数必填	说明
success	Boolean	是	请求成功状态，true成功、false失败
data	Object	是	查询结果对象
data.total	Long	是	查询结果总条数
data.list	List<Map<String,Object>>	是	结果数据列表
code	String	是	返回码
msg	String	是	返回码描述

响应结果结构示例：

a.正常结果

{

"success": true,

"code": "0",

"msg": "success",

"data": {

"total": 100,

"list": [

{

"id": 1154,

"custom_name": "测试客户",

"custom_nick": "测试简称",

"charger_id": "manager123",

"charger_name": "张经理",

"custom_level": "新建客户",

"custom_level_value": "new_customer",

"custom_source": "有成CRM",

"custom_source_value": "telephone_consultation",

"custom_province": "北京",

"custom_city": "北京市",

"custom_district": "东城区",

"custom_tele": "13800138000",

"custom_url": "www.ycbg.com",

"created": "2019/08/23 13:50:29",

"modified": "2019/09/03 14:55:39",

"flow_status": "已通过",

"flow_status_value": "pass",

"deal_status": "未赢单",

"deal_status_value": "undeal",

"sign_status": "未成交",

"sign_status_value": "unsign"

}

]

}

b.错误结果

{

"success": false,

"code": "12002",

"msg": "corpAccessToken不存在或已过期"

}