# 新增企业


- 仅当开启"企业模式"时，企业才会存在主跟进人;
  - 开启路径为:"尘锋SCRM管理后台-配置-系统设置-业务模式-企业管理"
- 如未指定"公海"或"主跟进人"，则企业数据将进入公海,名称为:"预设公海(领取)"
- 新增企业时，通过"企业全称"判断是否重复，如已重复，则会返回已存在的企业id
- toB模式下，公海ID和跟进团队参数必选一个传递；


```
POST https://qw-openapi-tx.dustess.com/enterprise/v2/create/batch?accessToken=

Content-Type: application/json
```

**接口限制**：每分钟调用600次，单次最多500条；

**请求参数**

| 请求参数名                                 | 类型       | 说明                                                                                     | 是否必须 |
| ------------------------------------------ | ---------- | ---------------------------------------------------------------------------------------- | -------- |
| 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](https://open.dustess.com/doc-5158667.md) | 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`、`pdf`、`audio`、`spreadsheetml`(excel)、`presentationml`(ppt)、`video`、`other`  

**请求参数示例**


```json
{
	"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码   |

**注**：返回的list与入参params的数量、顺序一致

**成功响应示例**

```json
{
  "code": 0,
  "msg": "OK",
  "data": {
    "results": [
      {
        "id": "xxx",
        "msg": "",
        "code": 0
      }
    ]
  }
}

{
  "code": 0,
  "msg": "OK",
  "data": {
    "results": [
      {
        "id": "",
        "msg": "企业全称已存在",
        "code": 20070301,
      }
    ]
  }
}
```

