同步经销商
1. 判断编码是否已存在，存在则执行修改逻辑，不存在则执行新增逻辑
2. 数量不能超过100条
请求流程
参阅 API开放平台接入指南
请求信息
|
协议 |
HTTPS |
|
请求方法 |
POST |
|
请求路径 |
/openapi/trace/app/v1/open/org/dealer |
|
请求头 |
Content-Type：application/json |
公共参数
通用请求头
请参阅 通用请求头
请求参数
|
名称 |
是否必须 |
参数类型 |
参数说明 |
| code | 是 | String | 编码 |
| name | 是 | String | 名称 |
| level | 是 | Integer | 经销商级别 |
| parentType | 是 | Long | 父级类型：如果是顶级可为0 |
| parentCode | 是 | String | 父级编码：如果是顶级可为空字符串 |
| districtCode | 否 | String | 所在地编码 |
| address | 否 | String | 详细地址 |
| districtCodes | 否 | String[] | 销售区域代码 |
| maxEmployees | 否 | Integer | 员工上限 |
| remark | 否 | String | 备注 |
| licensePath | 否 | String | 证照文件url地址 |
| manager | 否 | Object | 经销商负责人信息 dealer Manager Object containing mobile and name attributes |
| ├─ name | 是 | String | 负责人姓名 |
| ├─ cellphone | 是 | String | 负责人手机号 |
| flag | 否 | Integer | 1：启用 0：禁用 -1:删除 |
传出参数
|
名称 |
参数类型 |
参数说明 |
|
code |
int |
错误码，200：成功，其它为失败 |
|
message |
string |
消息内容 |
|
data |
object |
返回信息 |
|
dealerCode |
string |
经销商编号 |
|
dealerId |
string |
经销商id |
|
code |
string |
错误码，200：成功，其它为失败 |
|
message |
string |
消息内容 |
|
exception |
string |
异常信息 |
|
ext |
string |
扩展数据 |
|
meta |
string |
元数据，如参数校验的data信息等 |
|
timestamp |
string |
时间戳 |
|
traceId |
string |
链路追踪ID |
请求示例
[
{
"code": "dealer-001",
"name": "经销商001",
"level": 1,
"parentCode": "",
"parentType": 2,
"districtCode": "230602007000",
"address": "",
"districtCodes": ["130000000000", "230000000000"],
"maxEmployees": 0,
"licensePath": "",
"remark": "这是备注"
}
]
响应示例
{
"code": 200,
"message": "success",
"data": [
{
"dealerCode": "dealer-001",
"dealerId": "19",
"code": 200,
"message": "success"
},
{
"dealerCode": "dealer-002",
"dealerId": "20",
"code": 200,
"message": "success"
}
],
"timestamp": 1778133330115,
"traceId": "",
"exception": null,
"meta": null,
"ext": null
}
异常示例
{
"code": 500,
"message": "保存失败",
"data": [
{
"dealerCode": "dealer-001",
"dealerId": "",
"code": 20503007,
"message": "param：[name],verify fail：[20503007],error code: [20503007]"
},
{
"dealerCode": "dealer-002",
"dealerId": "20",
"code": 200,
"message": "success"
}
],
"timestamp": 1778134870569,
"traceId": "",
"exception": null,
"meta": null,
"ext": null
}