EPC系统对接
对接接口前获取token接口
物流单据同步
同步经销商
上海中商网络股份有限公司版权所有
-
+
首页
同步经销商
### API描述 API描述:经销商基础数据同步接口 编码已存在则执行修改逻辑,编码不存在则执行新增逻辑 ### 请求信息 | | | |------|------ | 请求方法 | POST | 【测试】请求路径 | https://api-fat.yesno.com.cn/hivezs/epc/sync/dealer | 【生产】请求路径 | https://sapi.supercarrier8.com/hivezs/epc/sync/dealer ### 传入参数 json格式,与单据同步不同 | 参数名称 | 是否必填 | 参数类型 | 参数说明 | |-------------|------|--------|-------------------------------------------------| | app_key | 是 | string | 见[获取token](https://developers.yesno.com.cn/doc/818/ "获取token") | | access_token | 是 | string | token| | bizparams | 是 | object | json数据| 示例: ``` { "app_key": "test123", "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJPQXV0aC1Kd3QiLCJleHAiOiJcL0RhdGUoMTc3OTMwMzE2MDc4MSlcLyIsImNsYWltMSI6MCwiY2xhaW0yIjoiY2xhaW0yLXZhbHVlIiwiT3BlbklkIjoiOWVmOTU2ODMtNDJlMy00YThhLTkzMWUtZDJhYzNlMDVhMTIxIiwiYWNjZXNzS2V5IjoidGVzdDEyMyJ9.T11K4Se0oHcpur27uh4OTl2bOmqu3KK1SSZSs4772Qc", "bizparams": { "remark": "nono", "code": "test20260521001", "name": "测试经销商0521001", "parentDealerNo": "", "areaId": "310101", "address": "xxxxxx地址", "contactName": "联系人123", "contactTel": "", "contactAddress": "联系人地址123", "flag":1, "level": null } } ``` #### 参数说明 | 字段 | 必须 | 规则 | 描述 | | :--- | :--- | :--- | :--- | | code | 是 | 4~30位的数字、字母或下划线 | 编号 | | name | 是 | 1-128位的任意字符 | 名称 | | parentDealerNo | 否 |4~30位的数字、字母或下划线 |上级经销商编号,默认顶级| | areaId | 否 | 所在地的区域编码(第三级别区域单位,如:310101(黄浦区)) |全国统一编码 | address | 否 | 1-128位的任意字符 | 详细地址 | | contactName | 否 | 不可超过50字符 | 联系人 | | contactTel | 否 | 手机号码格式校验 | 联系人电话 | | contactAddress | 否 | 数据最大长度超限(150) | 联系人地址 | | level | 否 | 从1开始 | 经销商级别,默认1 | | flag | 是 | 1:启用 0:禁用 -1:删除 | 1:启用 0:禁用 -1:删除 | ### 出参示例json ``` json 成功: { "code": 200, "message": "success", "data":null, "timestamp": 1773381729223, "traceId": "0fd5b036-3baa-4f53-ba95-37833ea2c154", "exception": null, "meta": null, "ext": null } 失败 错误码:25920001~25929001 参数校验失败httpstatus=400 { "code": 400, "message": "状态输入错误", "data": null, "timestamp": 1779334383601, "traceId": "", "exception": "Invalid parameter [status]: [状态输入错误]", "meta": null, "ext": null } token失败 { "code": 25920101, "message": "token校验失败", "data": { "status": 200, "code": 25920101, "reason": "token校验失败", "data": null }, "timestamp": 1779332229866, "traceId": "", "exception": null, "meta": { "status": 200, "code": 25920101, "reason": "token校验失败", "data": null }, "ext": null } ``` ### 错误码 25920001=编号已存在 25920002=正在处理该经销商编号数据 25920003=经销商等级不存在 25920004=一级经销商无需设置上级经销商 25920005=请传递上级经销商编号 25920006=区域名称不匹配 25920007=未找到上级经销商 25920008=当前经销商等级与上级经销商等级不匹配 25920009=经销商同步失败 25920010=不存在经销商不可为删除状态 25920101=token校验失败 25920102=token过期
zhangjiahao
2026年5月21日 13:50
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档
PDF文档(打印)
分享
链接
类型
密码
更新密码
有效期