新增企业
POST https://qw-openapi-tx.dustess.com/enterprise/v2/create/batch?accessToken=
Content-Type: application/json
请求参数名 | 类型 | 说明 | 是否必须 |
---|---|---|---|
params | Object[] | 批量新增参数列表 (单次不超过500) | true |
params.company | Object | 企业基础信息 | true |
params.company.fullName | String | 企业全称 | true |
params.company.categoryID | String | 企业类型 | true |
params.company.name | String | 企业简称 | false |
params.company.code | String | 企业编码 | false |
params.company.tel | String | 电话 | false |
params.company.web | String | 网址 | false |
params.company.provCity | String | 省市Code | false |
params.company.address | String | 地址 | false |
params.company.industry | String | 行业类型, 枚举值:参考下方特殊说明 | false |
params.company.peoples | String | 人员规模,枚举值 ("1-50人","51-100人","101-200人","201-500人","501-1000人","1000人以上",) | false |
params.company.level | String | 企业等级ID | false |
params.company.sourceCode | String | 来源id,可传任意层级的来源id,该联系人会挂在来源id的所属层级 | false |
params.company.tags | String[] | 标签ID | false |
params.company.udf | object | 自定义字段 | false |
params.company.udf.model_data | object [] | 自定义字段 | false |
params.company.udf.model_data[].key | string | 自定义字段id查询企业字段ID | false |
params.company.udf.model_data[].value | string | 自定义字段name | false |
params.pool | String | 公海ID (不可与 主跟进人ID 同时存在) | false |
params.follower | Object | 跟进团队 | false |
params.follower.owner | String | 主跟进人ID | false |
params.followStatus | Object | 跟进状态 | false |
params.followStatus.followStatusID | String | 跟进状态ID | false |
params.followStatus.invalidReason | String | 无效原因ID | false |
params.followStatus.invalidOtherText | String | 其他无效原因, 无效原因为其他时必填 | false |
"出行行业",
"电商行业",
"教育行业",
"互联网金融/银行",
"医疗/健康",
"美容/健身",
"旅游/酒店",
"票务",
"直播",
"招聘/人力",
"餐饮",
"快递/物流",
"企业服务",
"婚恋",
"O2O生活",
"公共服务",
"制造业",
"房产行业",
"政府行业",
"保健品行业",
"软件系统行业",
"游戏行业",
"物业行业",
"婚纱摄影行业",
"农林牧渔行业",
"建筑装饰行业",
"其他",
文件类型, 可填为: word
、image
、text
、audio
、spreadsheetml
(excel)、presentationml
(ppt)、video
、other
{
"params": [
{
"company": {
"fullName": "企业全称",
"name": "简称",
"tel": "13888888888",
"web": "http://www.xxx.com",
"provCity": "100000",
"address": "四川省金牛区茶店子街道",
"peoples": "1000人以上",
"level": "level_id",
"udf": {
"model_data": [
{
"key": "f0ce66-lkroqp0e",
"value": null // 代表空值,置空该字段的值
},
{
"key": "tqlcsb-ll4uqr23",
"value": "单行/多行传入值" // 单多行文本的值
},
{
"key": "ytwhyh-ll4uqr23",
"value": "2023-08-12" // 日期的值
},
{
"key": "wbwsja-ll4uqr23",
"value": "2023-08-15 14:00:00" // 时间日期的值
},
{
"key": "c75noa-1h0hsvcb5",
"value": "99" // 数字类型传入实例
},
{
"key": "60mdnv-lhen3uic",
"value": "[\"1\"]" // 单多选传入实例,单选仅支持传入一个值,多选可传入多个值
},
{
"key": "75yey8-ljze44hq",
// 多级联选传入实例,单选仅支持传入一个值,多选可传入多个值;每个值需包含父级选项id,使用「/」分割选项id:一级选项id/二级选项id/三级选项id
"value": "[\"1679051431107665933/1679051431107665934\",\"1679051431107665933/1679051431107665934/1679051431107665935/1679051431107665940\"]"
},
{
"key": "ys8xs5-lk0vvuoy",
// 附件字段传入实例
"value": "[{\"name\":\"企业列表.xlsx\",\"url\":\"https://cdn-member-test.dustess.com/W00000000545/static/l/l/d/9/lld9nnx7p91692084131697.xlsx\",\"size\":11085,\"type\":\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\"]"
}
]
},
"tags": [
"tag1"
],
"sourceCode": "xxx-xxx-xxx-xxx",
},
"pool": "xxx-xxx-xxx-xxx", // 不可与follower同时存在
"follower": {
"owner": "1"
},
"followStatus": {
"followStatusID": "xxx-xxx-xxx-xxx",
"invalidReason": "other",
"invalidOtherText": "其他原因"
},
}
]
}
响应参数名 | 类型 | 说明 |
---|---|---|
code | Int | 响应码 |
msg | String | 消息提示 |
data | Object | 返回数据 |
data.results | Object[] | 返回数据列表 |
data.results.id | String | 创建企业ID |
data.results.msg | Bool | 创建企业消息返回 |
data.results.code | Int | 创建企业code码 |
{
"code": 0,
"msg": "OK",
"data": {
"results": [
{
"id": "xxx",
"msg": "",
"code": 0
}
]
}
}
{
"code": 0,
"msg": "OK",
"data": {
"results": [
{
"id": "",
"msg": "企业全称已存在",
"code": 20070301,
}
]
}
}
修改于 2025-03-20 07:55:54