当前位置: API文档
warehouse_query.php(查询仓库)
1.1 接口描述:批量获取旺店通ERP内仓库档案信息 |
1.2 适用版本:客户端 V2.4.5.0及以上版本 |
1.3 全量获取:该接口是全量获取数据或按照warehouse_no获取,无法按照时间段增量获取数据。
|
2.1 暂无 |
环境 | HTTP地址 |
---|---|
测试环境 | https://sandbox.wangdian.cn/openapi2/warehouse_query.php |
正式环境 | https://api.wangdian.cn/openapi2/warehouse_query.php |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | sid | String | 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 | |
接口账号 | appkey | String | 是 | 本开放平台“自助对接”功能模块内自助申请,获取方式点击这里 | |
时间戳 | timestamp | int | 是 | 北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。 | |
签名 | sign | String | 是 | API输入参数签名结果,签名算法介绍单击这里 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
仓库编号 | warehouse_no | varchar | (40) | 否 | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库数据信息(不支持一次推送多个仓库编码) |
仓库类型 | type | tinyint | (4) | 否 | (0不限 1普通仓库 2自动流传外部 3京东仓储 4科捷 5百世物流 6SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 17POS 18虎符 20外部链路型 22抖店云仓 126分销委外仓 127其它) |
子类型 | sub_type | date | 否 | 仓库子类型(针对其它仓储 1米氏实体店 2 线下虚拟店) | |
分页大小 | page_size | int | 10 | 否 | 每页返回的数据条数,输入值范围1~100,不传本参数,输入值默认为40,使用举例单击这里 |
页号 | page_no | int | 10 | 否 | 不传值默认从0页开始 |
是否停用 | is_disabled | varhcar | 否 | 0未停用 1停用 默认为0 返回未停用仓库 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
错误码 | code | int | 40 | 是 | 状态码:0表示成功,其他表示失败 |
错误描述 | message | varchar | 255 | 是 | 错误描述 |
数据条数 | total_count | int | 10 | 否 | 只有page_no = 0 时,才返回的符合条件的数据总条数,用来分页 |
仓库详情数据节点 | warehouses | data[ ] | 是 | 仓库详情数据节点 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
仓库编号 | warehouse_no | varchar | 40 | 是 | 代表仓库所有属性的唯一编码,用于仓库区分,ERP内支持自定义(ERP仓库界面设置),用于获取指定仓库数据信息 |
仓库名称 | name | varchar | 64 | 是 | ERP仓库界面的仓库名称 |
仓库类别 | warehouse_type | tinyint | 4 | 是 | (0不限 1普通仓库 2自动流传外部 3京东仓储 4科捷 5百世物流 6SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 17POS 18虎符 20外部链路型 22抖店云仓 126分销委外仓 127其它) |
外部编号 | ext_warehouse_no | varchar | 40 | 是 | 外部仓库编号 |
省份 | province | varchar | 50 | 是 | 仓库设置的省份信息 |
城市 | city | varchar | 50 | 是 | 仓库设置的城市信息 |
区县 | district | varchar | 50 | 是 | 仓库设置的区县信息 |
地址 | address | varchar | 255 | 是 | 仓库地址 |
联系人 | contact | varchar | 20 | 是 | 仓库设置中的联系人 |
固话 | telno | varchar | 20 | 是 | 仓库设置中的固话信息 |
邮编 | zip | varchar | 255 | 是 | 邮编 |
手机 | mobile | varchar | 40 | 是 | 仓库设置中的手机信息 |
残次品库 | is_defect | tinyint | 1 | 是 | 是否是残次仓(0不是,1是) |
备注 | remark | varchar | 255 | 是 | 仓库设置中的备注信息 |
自定义 | prop1 | varchar | 100 | 是 | 自定义1(ERP内不显示该字段) |
自定义 | prop2 | varchar | 100 | 是 | 自定义2(ERP内不显示该字段) |
仓库id | warehouse_id | smallint | 是 | 仓库id | |
仓库类型 | type | tinyint | 是 | 仓库类型 (0不限 1普通仓库 2自动流传外部 3京东仓储 4科捷 5百世物流 6SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 17POS 18虎符 20外部链路型 22抖店云仓 126分销委外仓 127其它) | |
仓库子类型 | sub_type | tinyint | 是 | 仓库子类型 1米氏实体店 2 线下虚拟店 | |
API中商家的唯一标识 | api_key | varchar | 4096 | 是 | API中商家的唯一标识 |
货主编号/组织编码 | api_object_id | varchar | 40 | 是 | 和ext_warehouse_no一起保证唯一 |
标签 | tag | varchar | 11 | 是 | 委外仓禁止使用 |
区编号 | division_id | varchar | 20 | 是 | 区编号,云栈热敏用 |
标记 | flag | varchar | 11 | 是 | 用于下载标记 |
店铺ID | shop_id | smallint | 6 | 是 | 实体店仓库店铺id,米氏抢单用 |
使用外部库存 | is_outer_stock | varchar | 1 | 是 | 使用外部库存 |
是否是外部货品 | is_outer_goods | varchar | 1 | 是 | 代销仓库,货品没有所有权 |
拣货员数量 | picker_num | smallint | 6 | 是 | 仓库拣货员数量--智选批次使用 |
地理坐标_x | coordinates_x | decimal | (19,6) | 是 | 地理坐标_x |
地理坐标_y | coordinates_y | decimal | (19,6) | 是 | 地理坐标_y |
残次品/正品仓id | match_warehouse_id | smallint | 6 | 是 | 对应的残次品/正品仓id |
货到付款物流公司 | cod_logistics_id | int | 11 | 是 | 货到付款物流公司 |
是否停用 | is_disabled | tinyint | 1 | 是 | 是否停用 0未停用 1停用 |
仓库优先级 | priority | int | 11 | 是 | 仓库的优先级 |
创建时间 | created | datetime | 是 | 创建时间, 格式:yyyy-MM-dd HH:mm:ss | |
最后修改时间 | modified | datetime | 是 | 最后修改时间, 格式:yyyy-MM-dd HH:mm:ss |
6.2 异常响应示例
JSON | { "code": 1007, "message": "接口appkey已停用【解决办法:联系商务人员,重新开启接口appkey】 " } |