API开放平台

TIP

# 仓库新增接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/ess_storehouse/v1/addEsssStorehouse/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
        "code": "002",
        "emp_id": "",
        "emp_name": "",
        "emp_code": "zcb",       
        "is_inner": "0",
        "name": "测试仓库122",
        "view_users": "",
        "view_users_name": "zcb,zcb1",
        "view_users_code": "",
        "district_ids": "",
        "district_names": "华南大区",
        "district_codes": "2121"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
code VARCHAR(32) 是 仓库编码
name VARCHAR(32) 是 仓库名称
emp_id VARCHAR(32) 否 负责人ID；负责人ID、名称、编码不能同时为空，如果同时存在，优先级依次降低
emp_name VARCHAR(32) 否 负责人名称
emp_code VARCHAR(32) 否 负责人编码
view_users VARCHAR(32) 否 查询权限人员ID;传入员工ID，多个值用“,”分隔，不传则权限为全公司。ID、名称、编码，如果同时存在，优先级依次降低
view_users_name VARCHAR(32) 否 查询权限人员名称
view_users_code VARCHAR(32) 否 查询权限人员编码
district_ids VARCHAR(32) 否 配送区域ID
district_names VARCHAR(32) 否 配送区域名称
district_codes VARCHAR(32) 否 配送区域编码
is_inner VARCHAR(32) 否 默认仓库；1：是、0：否（默认）

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

# 仓库（车辆）查询接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/ess_storehouse/v1/queryEsssStorehouse/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "condition":"",
  "status": "1",
  "is_enable": "0",
  "type": "2",
  "page_number": "1",
  "page_length": "",
  "start_create_date": "2021-12-12",
  "end_create_date": "2022-12-12"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page_number INT 是 页码默认1，每页默认1000条
page_length INT 否 页长，默认为1000
condition VARCHAR(200) 否 仓库名称、仓库编码、仓库id三选一
status CHAR 否 状态，0、删除，1、未删除
is_enable varchar(2) 否 停用启用状态，1、启用，0、停用
type varchar(2) 否 仓库类型,1、仓库，2、车
start_create_date VARCHAR(32) 否 创建时间开始。格式：yyyy-MM-dd
end_create_date VARCHAR(32) 否 创建时间结束。格式：yyyy-MM-dd

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",  
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
    {
        "id":5631794108288395000,
        "code": "CL001123",
        "storehouse_name": "京A0000001",
        "type": "2",
        "district": "全部",
        "enabled": "0",
        "status": "1",
        "car_weight": "0",
        "car_weight_unit": "t",
        "car_volume": "0",
        "car_volume_unit": "m3",
        "assign": [
          {
            "name": "myoursky",
            "source_code": "flow_01"
          }
        ],
        "view_permission": [
          {
              "name": "全部",
              "source_code": ""
          }
        ]
    }
]

参数说明：

参数 类型 必填 说明
id INT8 是 勤测数据库中，该条数据的id
code varchar(200) 是 编号
storehouse_name varchar(200) 是 仓库名称/车号
type varchar(2) 是 仓库类型，1、仓库，2、车
enabled varchar(2) 是 停用启用状态，1、启用，0、停用
status varchar(2) 是 状态，0、删除，1、未删除
district VARCHAR(200) 否 配送区域，若有多个地区，以,拼接
car_weight NUMERIC(20,2) 否 车载重量
car_weight_unit varchar(10) 否 车载重量单位
car_volume NUMERIC(20,2) 否 车载容量
car_volume_unit varchar(10) 否 车载容量单位
assign List 负责人/司机 列表
assign.name varchar(200) 是 负责人/司机
assign.source_code varchar(200) 是 对方企业数据库中负责人/司机的code
view_permission List 查看权限 列表
view_permission.name varchar(200) 是 人员/部门 名称
view_permission.source_code varchar(200) 否 对方企业数据库中人员/部门的code，如果查看权限为全部，则此字段为空

← 库存查询接口 →