C咖开放接口-同步仓库
1. 判断编码是否已存在，存在则执行修改逻辑，不存在则执行新增逻辑
2. 数量不能超过100条
请求流程
参阅 API开放平台接入指南
请求信息
|
协议 |
HTTPS |
|
请求方法 |
POST |
|
请求路径 |
/openapi/trace/app/v1/open/org/warehouse |
|
请求头 |
Content-Type：application/json |
公共参数
通用请求头
请参阅 通用请求头
请求参数
|
名称 |
是否必须 |
参数类型 |
参数说明 |
| code | 是 | String | 仓库编号 |
| name | 是 | String | 仓库名称 |
| type1 | 是 | String | 仓库类型:1-供应商仓库,2-普通仓库 |
| address | 否 | String | 地址 |
| districtCode | 否 | String | 区域代码 |
| f0 | 否 | String | 扩展字段 |
| f1 | 否 | String | 扩展字段 |
| f2 | 否 | String | 扩展字段 |
| f3 | 否 | String | 扩展字段 |
| f4 | 否 | String | 扩展字段 |
| f5 | 否 | String | 扩展字段 |
| f6 | 否 | String | 扩展字段 |
| f7 | 否 | String | 扩展字段 |
| f8 | 否 | String | 扩展字段 |
| f9 | 否 | String | 扩展字段 |
| manager | 否 | object | 负责人 |
| ├─ address | 否 | String | 联系地址 |
| ├─ cellphone | 否 | String | 移动电话 |
| ├─ check | 否 | Boolean | 是否检查 |
| 否 | String | 电子邮箱 | |
| ├─ name | 否 | String | 负责人名称 |
| ├─ telephone | 否 | String | 固定电话 |
| remark | 否 | String | 备注 |
| status | 否 | Integer | 状态：1-启用，2-禁用，默认启用 |
传出参数
|
名称 |
参数类型 |
参数说明 |
|
code |
int |
错误码，200：成功，其它为失败 |
|
message |
string |
消息内容 |
|
data |
object |
返回信息 |
|
warehouseCode |
string |
仓库编号 |
|
warehouseId |
string |
仓库id |
|
code |
string |
错误码，200：成功，其它为失败 |
|
message |
string |
消息内容 |
|
exception |
string |
异常信息 |
|
ext |
string |
扩展数据 |
|
meta |
string |
元数据，如参数校验的data信息等 |
|
timestamp |
string |
时间戳 |
|
traceId |
string |
链路追踪ID |
请求示例
[
{
"code": "w-001",
"name": "测试仓库",
"type1": 1,
"remark": "这是备注"
},{
"code": "w-002",
"name": "测试仓库2",
"type1": 2,
"remark": "这是备注"
}
]
响应示例
{
"code": 200,
"message": "success",
"data": [
{
"warehouseCode": "w-001",
"warehouseId": "19",
"code": 200,
"message": "success"
},
{
"warehouseCode": "w-002",
"warehouseId": "20",
"code": 200,
"message": "success"
}
],
"timestamp": 1778133330115,
"traceId": "",
"exception": null,
"meta": null,
"ext": null
}
异常示例
{
"code": 500,
"message": "保存失败",
"data": [
{
"warehouseCode": "w-001",
"warehouseId": "",
"code": 20503007,
"message": "param：[name],verify fail：[20503007],error code: [20503007]"
},
{
"warehouseCode": "w-002",
"warehouseId": "20",
"code": 200,
"message": "success"
}
],
"timestamp": 1778134870569,
"traceId": "",
"exception": null,
"meta": null,
"ext": null
}