# 厂家仓库保存
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsCompanyStorehouse/v1/saveCompanyStorehouse/{openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | VARCHAR(32) | 否 | 仓库id。id,code,name在修改时匹配仓库优先级依次降低 |
| code | VARCHAR(200) | 是 | 仓库编码。id,code,name在修改时匹配仓库优先级依次降低 |
| name | VARCHAR(200) | 是 | 仓库名称。id,code,name在修改时匹配仓库优先级依次降低 |
| locationA | VARCHAR(1000) | 否 | 标注位置 |
| locationC | VARCHAR(100) | 否 | 经纬度 维度在前精度在后用逗号拼接 |
| linkman | VARCHAR(200) | 是 | 联系人 |
| linkmanMobile | VARCHAR(200) | 是 | 联系人电话 |
| remark | VARCHAR(4000) | 否 | 说明 |
| address | VARCHAR(1000) | 是 | 仓库地址 |
| type | VARCHAR(200) | 是 | 仓库类型 类型库中的类型 |
| isEnable | VARCHAR(32) | 是 | 仓库状态 QY启用, TY停用 |
| operateType | VARCHAR(32) | 是 | 1：新增 2：修改 |
| depositFlag | VARCHAR(32) | 否 | 是否寄存-1：寄存，0：不寄存(默认为不寄存) |
| custodianCmId | VARCHAR(32) | 否 | 保管方客户id(保管方客户id与保管方客户编码两者传其一,优先取id) |
| custodianCmCode | VARCHAR(32) | 否 | 保管方客户编码(保管方客户id与保管方客户编码两者传其一,优先取id) |
| principalList | List | 否 | 仓库负责人列表 |
| principalList.empId | VARCHAR(32) | 否 | 负责人id(负责人id与编码、名称三者传其一,其次取id、编码、名称) |
| principalList.empCode | VARCHAR(32) | 否 | 负责人id(负责人id与编码、名称三者传其一,其次取id、编码、名称) |
| principalList.empName | VARCHAR(100) | 否 | 负责人名称(负责人id与编码、名称三者传其一,其次取id、编码、名称) |
| cusRange | Object | 是 | 客户范围对象 |
| cusRange.rangeType | VARCHAR(32) | 是 | 范围类型-1： 指定具体客户，2：按客户属性设置范围，all：全部 |
| cusRange.tradeType | VARCHAR(32) | 是 | 行业类型-1：标准客户，2：经销商，3：终端门店，all：全部 |
| cusRange.deptId | VARCHAR(32) | 否 | 客户属性-部门id，多个值用“,”分隔 |
| cusRange.deptName | VARCHAR(100) | 否 | 客户属性-部门名称，多个值用“,”分隔 |
| cusRange.deptCode | VARCHAR(100) | 否 | 客户属性-部门编码，多个值用“,”分隔 |
| cusRange.deptSourceCode | VARCHAR(100) | 否 | 客户属性-部门第三方系统的唯一标识，多个值用“,”分隔 |
| cusRange.customerLevelId | VARCHAR(32) | 否 | 客户属性-客户级别id，多个值用“,”分隔 |
| cusRange.customerLevelSourceCode | VARCHAR(100) | 否 | 客户属性-客户级别第三方系统的唯一标识，多个值用“,”分隔 |
| cusRange.customerLevelName | VARCHAR(100) | 否 | 客户属性-客户级别名称，多个值用“,”分隔 |
| cusRange.districtLevelId | VARCHAR(32) | 否 | 客户属性-销售区域级别id，多个值用“,”分隔 |
| cusRange.districtLevelCode | VARCHAR(100) | 否 | 客户属性-销售区域级别编码，多个值用“,”分隔 |
| cusRange.districtLevelName | VARCHAR(100) | 否 | 客户属性-销售区域级别名称，多个值用“,”分隔 |
| cusRange.typeId | VARCHAR(32) | 否 | 客户属性-类型id，多个值用“,”分隔 |
| cusRange.typeCode | VARCHAR(100) | 否 | 客户属性-类型编码，多个值用“,”分隔 |
| cusRange.typeName | VARCHAR(100) | 否 | 客户属性-类型名称，多个值用“,”分隔 |
| cusRange.typeSourceCode | VARCHAR(100) | 否 | 客户属性-类型第三方系统的唯一标识，多个值用“,”分隔 |
| cusRange.districtId | VARCHAR(32) | 否 | 客户属性-销售区域id，多个值用“,”分隔 |
| cusRange.districtCode | VARCHAR(100) | 否 | 客户属性-销售区域编码，多个值用“,”分隔 |
| cusRange.districtName | VARCHAR(100) | 否 | 客户属性-销售区域名称，多个值用“,”分隔 |
| cusRange.districtSourceCode | VARCHAR(100) | 否 | 客户属性-销售区域第三方系统的唯一标识，多个值用“,”分隔 |
| cusRange.uperCusId | VARCHAR(32) | 否 | 客户属性-上级客户id，多个值用“,”分隔 |
| cusRange.uperCusCode | VARCHAR(100) | 否 | 客户属性-上级客户编码，多个值用“,”分隔 |
| cusRange.uperCusName | VARCHAR(100) | 否 | 客户属性-上级客户名称，多个值用“,”分隔 |
| cusRange.uperCusSourceCode | VARCHAR(100) | 否 | 客户属性-上级客户第三方系统的唯一标识，多个值用“,”分隔 |
| cusRange.kasysId | VARCHAR(32) | 否 | 客户属性-ka系统id，多个值用“,”分隔 |
| cusRange.kasysName | VARCHAR(100) | 否 | 客户属性-ka系统名称，多个值用“,”分隔 |
| cusRange.dealerId | VARCHAR(32) | 否 | 客户属性-经销商id，多个值用“,”分隔 |
| cusRange.dealerCode | VARCHAR(100) | 否 | 客户属性-经销商编码，多个值用“,”分隔 |
| cusRange.dealerName | VARCHAR(100) | 否 | 客户属性-经销商名称，多个值用“,”分隔 |
| cusRange.dealerSourceCode | VARCHAR(100) | 否 | 客户属性-经销商第三方系统的唯一标识，多个值用“,”分隔 |
| cusRange.gradationId | VARCHAR(32) | 否 | 客户属性-客户层次id，多个值用“,”分隔 |
| cusRange.gradationCode | VARCHAR(100) | 否 | 客户属性-客户层次编码，多个值用“,”分隔 |
| cusRange.gradationName | VARCHAR(100) | 否 | 客户属性-客户层次名称，多个值用“,”分隔 |
| cusRange.perScaleId | VARCHAR(32) | 否 | 客户属性-人员规模id，多个值用“,”分隔 |
| cusRange.perScaleName | VARCHAR(100) | 否 | 客户属性-人员规模名称，多个值用“,”分隔 |
| cusRange.cusSourceId | VARCHAR(32) | 否 | 客户属性-来源id，多个值用“,”分隔 |
| cusRange.cusSourceName | VARCHAR(100) | 否 | 客户属性-来源名称，多个值用“,”分隔 |
| cusRange.tradeId | VARCHAR(32) | 否 | 客户属性-行业id，多个值用“,”分隔 |
| cusRange.tradeName | VARCHAR(100) | 否 | 客户属性-行业名称，多个值用“,”分隔 |
| cusRange.tradingareaBigId | VARCHAR(32) | 否 | 客户属性-大商圈id，多个值用“,”分隔 |
| cusRange.tradingareaBigName | VARCHAR(100) | 否 | 客户属性-大商圈名称，多个值用“,”分隔 |
| cusRange.tradingareaNomalId | VARCHAR(32) | 否 | 客户属性-商圈id，多个值用“,”分隔 |
| cusRange.tradingareaNomalName | VARCHAR(100) | 否 | 客户属性-商圈名称，多个值用“,”分隔 |
| cusRange.cmId | VARCHAR(2000) | 否 | 指定客户-经销商id，多个值用“,”分隔。rangeType为1时，cmId、cmSourceCode、 cmCode、cmName不能同时为空，如果同时存在，优先级依次降低 |
| cusRange.cmCode | VARCHAR(4000) | 否 | 指定客户-经销商编码，多个值用“,”分隔。rangeType为1时，cmId、cmSourceCode、 cmCode、cmName不能同时为空，如果同时存在，优先级依次降低 |
| cusRange.cmName | VARCHAR(4000) | 否 | 指定客户-经销商名称，多个值用“,”分隔。rangeType为1时，cmId、cmSourceCode、 cmCode、cmName不能同时为空，如果同时存在，优先级依次降低 |
| empRangeType | VARCHAR(32) | 是 | 人员范围类型-1：全公司，2：指定范围 |
| empRange | Object | 否 | 人员范围对象 |
| empRange.rangeType | VARCHAR(32) | 是 | 范围类型-2：指定人员属性 |
| empRange.deptId | VARCHAR(32) | 否 | 人员属性-部门id，多个值用“,”分隔 |
| empRange.deptName | VARCHAR(100) | 否 | 人员属性-部门名称，多个值用“,”分隔 |
| empRange.deptCode | VARCHAR(100) | 否 | 人员属性-部门编码，多个值用“,”分隔 |
| empRange.deptSourceCode | VARCHAR(100) | 否 | 人员属性-部门第三方系统的唯一标识，多个值用“,”分隔 |
响应示例：
{
"return_code": "1",
"return_msg": "",
"msg_id": "X0000000001"
}
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| msg_id | VARCHAR(32) | 消息ID |
| return_code | VARCHAR(32) | 响应编码：0成功 1失败 |
| return_msg | VARCHAR(100) | 响应说明 |
# 厂家仓库删除
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsCompanyStorehouse/v1/deleteCompanyStorehouse/{ openid }/{ timestamp }/{ digest }/{ msg_id }在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | VARCHAR(32) | 否 | 仓库id。id,code,name必填其一在删除时匹配仓库优先级依次降低 |
| code | VARCHAR(200) | 否 | 仓库编码。id,code,name必填其一在删除时匹配仓库优先级依次降低 |
| name | VARCHAR(200) | 否 | 仓库名称。id,code,name必填其一在删除时匹配仓库优先级依次降低 |
响应示例：
{
"return_code": "1",
"return_msg": "",
"msg_id": "X0000000001"
}
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| msg_id | VARCHAR(32) | 消息ID |
| return_code | VARCHAR(32) | 响应编码：0成功 1失败 |
| return_msg | VARCHAR(100) | 响应说明 |
# 客户与厂家仓库关系同步
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsCompanyStorehouse/v1/syncCmCompanyStorehouseRel/{ openid }/{ timestamp }/{ digest }/{ msg_id }在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cmCode | VARCHAR(32) | 是 | 客户编码 |
| companyStorehoustList.storeHouseCode | VARCHAR(200) | 是 | 仓库编码 |
| companyStorehoustList.isInner | VARCHAR(200) | 是 | 默认仓库；1：是、0：否（默认） |
响应示例：
{
"return_code": "0",
"return_msg": "",
"msg_id": ""
}
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| msg_id | VARCHAR(32) | 消息ID |
| return_code | VARCHAR(32) | 响应编码：0成功 1失败 |
| return_msg | VARCHAR(100) | 响应说明 |
# 厂家仓库查询
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dmsCompanyStorehouse/v1/queryCompanyStorehouse/{ openid }/{ timestamp }/{ digest }/{ msg_id }在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | VARCHAR(32) | 否 | 仓库id。id,code,name必填其一在查询时匹配仓库优先级依次降低 |
| code | VARCHAR(200) | 否 | 仓库编码。id,code,name必填其一在查询时匹配仓库优先级依次降低 |
| name | VARCHAR(200) | 否 | 仓库名称。id,code,name必填其一在查询时匹配仓库优先级依次降低 |
响应示例：
{
"return_code": "1",
"return_msg": "",
"msg_id": "X0000000001",
"response_data":"<<DATA>>"
}
数据DATA示例:
[
{
"address": "南京建邺区附近",
"code": "CK001",
"deptIds": "8877687688567643336,8843721637483091359",
"id": "8877687688567643336",
"isEnable": "1",
"locationA": "南京建邺区附近",
"locationC": "31.982588,118.734912",
"linkman": "联系人",
"linkmanMobile": "联系人电话",
"remark": "说明",
"name": "总仓库",
"typeId": "8843721637483091359",
"typeName": "主仓库",
"depositFlag": "1",
"custodianCmId":"保管方的id",
"custodianCmName":"保管方的名称",
"principalList": [
{
"empId": "4997502358874688433",
"empName": "y0111"
}
],
"cusRangeType": "2",
"cusRange":{
"tradeType": "3",
"rangeType": "2",
"deptId": "",
"deptName": "销售中心",
"deptCode": "",
"deptSourceCode": "",
"customerLevelId": "",
"customerLevelSourceCode": "",
"customerLevelName": "A",
"districtLevelId": "",
"districtLevelCode": "",
"districtLevelName": "",
"typeId": "",
"typeCode": "",
"typeName": "门店",
"typeSourceCode": "",
"districtId": "",
"districtCode": "",
"districtName": "华北大区",
"districtSourceCode": "",
"uperCusId": "",
"uperCusCode": "",
"uperCusName": "",
"uperCusSourceCode": "",
"kasysId": "",
"kasysName": "家乐福",
"dealerId": "",
"dealerCode": "",
"dealerName": "经销商6",
"dealerSourceCode": "",
"gradationId": "",
"gradationCode": "",
"gradationName": "测试门店01",
"perScaleId": "",
"perScaleName": "",
"cusSourceId": "",
"cusSourceName": "",
"tradeId": "",
"tradeName": "",
"tradingareaBigId": "",
"tradingareaBigName": "测试A",
"tradingareaNomalId": "",
"tradingareaNomalName": "A标签"
},
"empRangeType": "2",
"empRange":{
"rangeType": "2",
"deptName": "销售中心"
}
}
]
参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| id | VARCHAR(32) | 仓库编码 |
| code | VARCHAR(200) | 仓库编码 |
| name | VARCHAR(200) | 仓库名称 |
| locationA | VARCHAR(1000) | 标注位置 |
| locationC | VARCHAR(100) | 经纬度 维度在前精度在后用逗号拼接 |
| linkman | VARCHAR(200) | 联系人 |
| linkmanMobile | VARCHAR(200) | 联系人电话 |
| remark | VARCHAR(4000) | 说明 |
| address | VARCHAR(1000) | 仓库地址 |
| typeId | VARCHAR(200) | 仓库类型id 类型库里的类型 |
| typeName | VARCHAR(200) | 仓库类型名称 类型库里的类型 |
| isEnable | VARCHAR(32) | 仓库状态 QY启用 TY停用 |
| deptIds | TEXT | 配送部门 部门id逗号拼接 |
| mainExts | List | 列表 |
| mainExts.ext_key | VARCHAR(100) | 自定义字段名称 |
| mainExts.ext_value | VARCHAR(1000) | 自定义字段数据值 |
| mainExts.ext_column | VARCHAR(100) | 自定义字段编码 |
| deptList.id | VARCHAR(32) | 配送部门id |
| deptList.name | VARCHAR(100) | 配送部门名称 |
| deptList.code | VARCHAR(100) | 配送部门code |
| deptList.sourceCode | VARCHAR(100) | 配送部门第三方系统的唯一标识 |
| depositFlag | VARCHAR(32) | 是否寄存-1：寄存，0：不寄存(默认为不寄存) |
| custodianCmId | VARCHAR(32) | 保管方的id |
| custodianCmName | VARCHAR(100) | 保管方的名称 |
| principalList | List | 仓库负责人列表 |
| principalList.empId | VARCHAR(32) | 负责人ID |
| principalList.empName | VARCHAR(100) | 负责人名称 |
| cusRangeType | VARCHAR(32) | 客户范围类型-1：全公司，2：指定范围 |
| cusRange | Object | 客户范围对象 |
| cusRange.rangeType | VARCHAR(32) | 范围类型-1： 指定具体客户，2：按客户属性设置范围，all：全部 |
| cusRange.tradeType | VARCHAR(32) | 行业类型-1：标准客户，2：经销商，3：终端门店，all：全部 |
| cusRange.deptId | VARCHAR(32) | 客户属性-部门id，多个值用“,”分隔 |
| cusRange.deptName | VARCHAR(100) | 客户属性-部门名称，多个值用“,”分隔 |
| cusRange.deptCode | VARCHAR(100) | 客户属性-部门编码，多个值用“,”分隔 |
| cusRange.deptSourceCode | VARCHAR(100) | 客户属性-部门第三方系统的唯一标识，多个值用“,”分隔 |
| cusRange.customerLevelId | VARCHAR(32) | 客户属性-客户级别id，多个值用“,”分隔 |
| cusRange.customerLevelSourceCode | VARCHAR(100) | 客户属性-客户级别第三方系统的唯一标识，多个值用“,”分隔 |
| cusRange.customerLevelName | VARCHAR(100) | 客户属性-客户级别名称，多个值用“,”分隔 |
| cusRange.districtLevelId | VARCHAR(32) | 客户属性-销售区域级别id，多个值用“,”分隔 |
| cusRange.districtLevelCode | VARCHAR(100) | 客户属性-销售区域级别编码，多个值用“,”分隔 |
| cusRange.districtLevelName | VARCHAR(100) | 客户属性-销售区域级别名称，多个值用“,”分隔 |
| cusRange.typeId | VARCHAR(32) | 客户属性-类型id，多个值用“,”分隔 |
| cusRange.typeCode | VARCHAR(100) | 客户属性-类型编码，多个值用“,”分隔 |
| cusRange.typeName | VARCHAR(100) | 客户属性-类型名称，多个值用“,”分隔 |
| cusRange.typeSourceCode | VARCHAR(100) | 客户属性-类型第三方系统的唯一标识，多个值用“,”分隔 |
| cusRange.districtId | VARCHAR(32) | 客户属性-销售区域id，多个值用“,”分隔 |
| cusRange.districtCode | VARCHAR(100) | 客户属性-销售区域编码，多个值用“,”分隔 |
| cusRange.districtName | VARCHAR(100) | 客户属性-销售区域名称，多个值用“,”分隔 |
| cusRange.districtSourceCode | VARCHAR(100) | 客户属性-销售区域第三方系统的唯一标识，多个值用“,”分隔 |
| cusRange.uperCusId | VARCHAR(32) | 客户属性-上级客户id，多个值用“,”分隔 |
| cusRange.uperCusCode | VARCHAR(100) | 客户属性-上级客户编码，多个值用“,”分隔 |
| cusRange.uperCusName | VARCHAR(100) | 客户属性-上级客户名称，多个值用“,”分隔 |
| cusRange.uperCusSourceCode | VARCHAR(100) | 客户属性-上级客户第三方系统的唯一标识，多个值用“,”分隔 |
| cusRange.kasysId | VARCHAR(32) | 客户属性-ka系统id，多个值用“,”分隔 |
| cusRange.kasysName | VARCHAR(100) | 客户属性-ka系统名称，多个值用“,”分隔 |
| cusRange.dealerId | VARCHAR(32) | 客户属性-经销商id，多个值用“,”分隔 |
| cusRange.dealerCode | VARCHAR(100) | 客户属性-经销商编码，多个值用“,”分隔 |
| cusRange.dealerName | VARCHAR(100) | 客户属性-经销商名称，多个值用“,”分隔 |
| cusRange.dealerSourceCode | VARCHAR(100) | 客户属性-经销商第三方系统的唯一标识，多个值用“,”分隔 |
| cusRange.gradationId | VARCHAR(32) | 客户属性-客户层次id，多个值用“,”分隔 |
| cusRange.gradationCode | VARCHAR(100) | 客户属性-客户层次编码，多个值用“,”分隔 |
| cusRange.gradationName | VARCHAR(100) | 客户属性-客户层次名称，多个值用“,”分隔 |
| cusRange.perScaleId | VARCHAR(32) | 客户属性-人员规模id，多个值用“,”分隔 |
| cusRange.perScaleName | VARCHAR(100) | 客户属性-人员规模名称，多个值用“,”分隔 |
| cusRange.cusSourceId | VARCHAR(32) | 客户属性-来源id，多个值用“,”分隔 |
| cusRange.cusSourceName | VARCHAR(100) | 客户属性-来源名称，多个值用“,”分隔 |
| cusRange.tradeId | VARCHAR(32) | 客户属性-行业id，多个值用“,”分隔 |
| cusRange.tradeName | VARCHAR(100) | 客户属性-行业名称，多个值用“,”分隔 |
| cusRange.tradingareaBigId | VARCHAR(32) | 客户属性-大商圈id，多个值用“,”分隔 |
| cusRange.tradingareaBigName | VARCHAR(100) | 客户属性-大商圈名称，多个值用“,”分隔 |
| cusRange.tradingareaNomalId | VARCHAR(32) | 客户属性-商圈id，多个值用“,”分隔 |
| cusRange.tradingareaNomalName | VARCHAR(100) | 客户属性-商圈名称，多个值用“,”分隔 |
| cusRange.cmId | VARCHAR(2000) | 指定客户-经销商id，多个值用“,”分隔。rangeType为1时，cmId、cmSourceCode、 cmCode、cmName不能同时为空，如果同时存在，优先级依次降低 |
| cusRange.cmCode | VARCHAR(4000) | 指定客户-经销商编码，多个值用“,”分隔。rangeType为1时，cmId、cmSourceCode、 cmCode、cmName不能同时为空，如果同时存在，优先级依次降低 |
| cusRange.cmName | VARCHAR(4000) | 指定客户-经销商名称，多个值用“,”分隔。rangeType为1时，cmId、cmSourceCode、 cmCode、cmName不能同时为空，如果同时存在，优先级依次降低 |
| empRangeType | VARCHAR(32) | 人员范围类型-1：全公司，2：指定范围 |
| empRange | Object | 人员范围对象 |
| empRange.rangeType | VARCHAR(32) | 范围类型-2：指定人员属性 |
| empRange.deptId | VARCHAR(32) | 人员属性-部门id，多个值用“,”分隔 |
| empRange.deptName | VARCHAR(100) | 人员属性-部门名称，多个值用“,”分隔 |
| empRange.deptCode | VARCHAR(100) | 人员属性-部门编码，多个值用“,”分隔 |
| empRange.deptSourceCode | VARCHAR(100) | 人员属性-部门第三方系统的唯一标识，多个值用“,”分隔 |