批量新增/修改经销商

#  批量新增/修改经销商 `公开`

## 支持场景
>  已支持：批量新增/修改经销商

## API描述
>  API描述：批量新增/修改经销商，单次请求最大限制100条。
纯新增场景接口响应时间建议设置5s左右，纯更新场景接口响应时间建议设置20s左右。

## 请求流程

>   1. 在超8平台中申请第三方系统的应用Access Key和密钥（线下）。
>   2. 第三方系统根据应用Access Key和密钥向系统发起**Access Token**申请【 [如何获取token](https://developers.yesno.com.cn/doc/57/ "如何获取token")】。
>   3. 三方系统调用防伪领域服务的开放接口进行数据对接。

> 具体请求请参阅：
>请参阅  [请求流程](https://developers.yesno.com.cn/doc/56/ "请求流程")

## 请求信息

| 协议     | HTTPS                                                  |
|----------|-----------------------------------------------------------------------------------------------|
| 请求方法 | POST                                                   |
| 请求路径 | /base/app/v1/open/org/dealer/add-upd-batch      |

##  header头
请参阅 [通用请求头](https://developers.yesno.com.cn/doc/56/ "请求头")

## 请求参数

| 名称         | 类型                      | 是否必须 | 默认值 | 备注                             | 其他信息          |
|--------------|---------------------------|----------|--------|----------------------------------|-------------------|
| enterpriseNo | String                    | 非必须   |        | 企业号，不填默认当前登录企业     |                   |
| dealerList   | List\<OpenDealerBatchItem\> | 必须     |        | 经销商列表，上限 100 条          | 见下方 dealerList 结构 |

### dealerList 结构（OpenDealerBatchItem）

| 名称          | 类型            | 是否必须 | 默认值 | 备注                                        | 其他信息          |
|---------------|-----------------|----------|--------|---------------------------------------------|-------------------|
| code          | String          | 必须     |        | 编码（长度 1~128）                          |                   |
| name          | String          | 必须     |        | 名称（长度 1~128）                          |                   |
| parents       | List\<ParentInfo\> | 必须     |        | 父级列表                                    | 见下方 parents 结构 |
| level         | Integer         | 必须     |        | 经销商级别（≥0）                            | **format:** int32 |
| districtCode  | String          | 非必须   |        | 区域代码                                    |                   |
| address       | String          | 非必须   |        | 地址（长度 ≤256）                           |                   |
| remark        | String          | 非必须   |        | 备注（长度 ≤512）                           |                   |
| maxEmployees  | Integer         | 非必须   |        | 员工上限（≥0）                              | **format:** int32 |
| licensePath   | String          | 非必须   |        | 证照路径（长度 ≤256）                       |                   |
| districtCodes | String[]        | 非必须   |        | 销售区域代码                                |                   |
| manager       | PersonUpdateInput | 非必须   |        | 负责人                                      | 见下方 manager 结构 |
| f0 ~ f9       | String          | 非必须   |        | 扩展字段                                    |                   |

### parents 结构（ParentInfo）

| 名称        | 类型   | 是否必须 | 默认值 | 备注                          | 其他信息          |
|-------------|--------|----------|--------|-------------------------------|-------------------|
| parentType  | Long   | 必须     |        | 父级类型：0 为顶级            | **format:** int64 |
| parentCode  | String | 必须     |        | 父级编码：顶级可为空字符串    |                   |
| salesmanId  | Long | 非必须     |        | 该父级对应的业务员Id（仅校验存在性，不校验父级下业务员有效性）    |                   |
### manager 结构（PersonUpdateInput）
> 1. 激活参数开启，manager必填。手机号不支持更新，更新需走页面“替换负责人”功能；
> 2. 激活参数关闭，manager所有字段传空字符串则删除负责人；
> 3. manager传null，忽略此字段更新。

| 名称        | 类型    | 是否必须 | 默认值 | 备注                          | 其他信息 |
|-------------|---------|----------|--------|-------------------------------|----------|
| name        | String  | 非必须   |        | 名称（长度 ≤32）              |          |
| cellphone   | String  | 必须     |        | 移动电话                     |          |
| telephone   | String  | 非必须   |        | 固定电话                      |          |
| email       | String  | 非必须   |        | 电子邮箱                      |          |
| address     | String  | 非必须   |        | 联系地址（长度 ≤256）         |          |

## 返回参数

| 名称      | 类型    | 是否必须 | 默认值 | 备注       | 其他信息          |
|-----------|---------|----------|--------|------------|-------------------|
| code      | integer | 必须     |        | 错误码     | **format:** int32 |
| data      | Object  | 非必须   |        | 返回数据   | 见下方 data 结构  |
| message   | string  | 非必须   |        | 消息内容   |                   |
| timestamp | integer | 非必须   |        | 时间戳     | **format:** int64 |
| traceId   | string  | 非必须   |        | 链路追踪ID |                   |

## data 结构（DealerBatchResult）

| 名称        | 类型                          | 是否必须 | 默认值 | 备注       | 其他信息          |
|-------------|-------------------------------|----------|--------|------------|-------------------|
| totalCount  | integer                       | 必须     |        | 总数       | **format:** int32 |
| addCount    | integer                       | 必须     |        | 新增成功数 | **format:** int32 |
| updateCount | integer                       | 必须     |        | 修改成功数 | **format:** int32 |
| failCount   | integer                       | 必须     |        | 失败数     | **format:** int32 |
| details     | List\<DealerBatchResultItem\> | 非必须   |        | 明细       | 见下方 details 结构 |

### details 结构（DealerBatchResultItem）

| 名称    | 类型         | 是否必须 | 默认值 | 备注                        | 其他信息 |
|---------|--------------|----------|--------|-----------------------------|----------|
| index   | integer      | 必须     |        | 序号                        | **format:** int32 |
| code    | string       | 必须     |        | 编码                        |          |
| name    | string       | 必须     |        | 名称                        |          |
| action  | string       | 必须     |        | 操作类型：ADD / UPDATE      |          |
| success | boolean      | 必须     |        | 是否成功                    |          |
| errors  | List\<String\> | 非必须   |        | 错误信息列表（失败时返回原因） |          |

## 请求示例

```json
{
    "enterpriseNo": "153049012753",
    "dealerList": [
        {
            "code": "D001",
            "name": "D001",
            "parents": [
                {
                    "parentType": 16,
                    "parentCode": "1-jxs-level2-1",
                    "salesmanId": 2054551241409826816
                },
                {
                    "parentType": 16,
                    "parentCode": "1-jxs-level2-2"
                }
            ],
            "level": 1,
            "districtCode": "340300000000",
            "address": "蚌山区东海大道",
            "remark": "批量新增测试-更新1",
            "maxEmployees": 50,
            "licensePath": "/license/d001.jpg",
            "districtCodes": [
                "340100000000",
                "340300000000"
            ],
            "manager": {
                "name": "张三3",
                "cellphone": "13800138003",
                "telephone": "0551-12345678",
                "address": "蚌埠市蚌山区"
            }
        }
    ]
}
```

## 响应示例

```json
{
	"code": 200,
	"message": "success",
	"data": {
		"totalCount": 1,
		"addCount": 1,
		"updateCount": 0,
		"failCount": 0,
		"details": [
			{
				"index": 0,
				"code": "D001",
				"name": "D001",
				"action": "ADD",
				"success": true,
				"errors": null
			}
		]
	},
	"extraData": null,
	"timestamp": 1786502383061,
	"traceId": "951dd06d-8c39-4599-a375-3ca6724820c4"
}
```

## 返回码
| 返回码 | 描述 |  解决方案|
| --- | --- | --- |
200|成功|
success|成功|
failed|失败|