inventory/batch_get
目录 |
1.接口说明
1.1接口描述
批量获取存货信息
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
基础数据同步或前端展示
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/inventory/batch_get |
| 格式 | JSON |
| https请求方式 | GET |
| 编码类型 | UTF-8 |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | string | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| page_index | 否 | string | 页号 |
| rows_per_page | 否 | string | 每页行数 |
| code_begin | 否 | string | 起始存货编码 |
| code_end | 否 | string | 结束存货编码 |
| name | 否 | string | 存货名称关键字 |
| invaddcode | 否 | string | 存货代码 |
| specs | 否 | string | 规格型号关键字 |
| sort_code | 否 | string | 所属分类码 |
| sort_name | 否 | string | 所属分类 |
| start_date_begin | 否 | date | 起始启用日期，格式：yyyy-MM-dd |
| start_date_end | 否 | date | 结束启用日期，格式：yyyy-MM-dd |
| modifydate_begin | 否 | date | 起始变更日期，格式：yyyy-MM-dd |
| modifydate_end | 否 | date | 结束变更日期，格式：yyyy-MM-dd |
| sale_flag | 否 | number | 是否内销（0否1是） |
| bexpsale | 否 | number | 是否外销（0否1是） |
3.3请求示例
GET https://api.yonyouup.com/api/inventory/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&page_index=1&rows_per_page=20&ds_sequence=1
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| page_index | string | 页号 | |
| rows_per_page | string | 每页行数 | |
| row_count | string | 总行数 | |
| page_count | string | 页数 | |
| code | string | 存货编码 | |
| name | string | 存货名称 | |
| invaddcode | string | 存货代码 | |
| specs | string | 规格型号 | |
| sort_code | string | 所属分类码 | |
| main_measure | string | 主计量单位 | |
| puunit_code | string | 采购默认单位编码 | |
| puunit_name | string | 采购默认单位名称 | |
| puunit_ichangrate | number | 采购默认单位换算率 | |
| saunit_code | string | 销售默认单位编码 | |
| saunit_name | string | 销售默认单位名称 | |
| saunit_ichangrate | number | 销售默认单位换算率 | |
| stunit_code | string | 库存默认单位编码 | |
| stunit_name | string | 库存默认单位名称 | |
| stunit_ichangrate | number | 库存默认单位换算率 | |
| unitgroup_code | string | 计量单位组编码 | |
| unitgroup_type | number | 计量单位组类型(0=无换算;1=固定;2=浮动) | |
| bbarcode | boolean | 条形码管理 | |
| barcode | string | 条形码 | |
| ref_sale_price | number | 参考售价 | |
| bsuitretail | boolean | 适用零售(0:否 1：是) | |
| bottom_sale_price | number | 最低售价 | |
| start_date | date | 启用日期 | |
| end_date | date | 停用日期 | |
| ModifyDate | date | 变更日期 | |
| defwarehouse | string | 默认仓库 | |
| defwarehousename | string | 默认仓库名称 | |
| iSupplyType | string | 供应类型 | |
| drawtype | string | 领料方式 | |
| iimptaxrate | number | 进项税率 | |
| tax_rate | number | 销项税率 | |
| self_define1 | string | 自定义项1 | |
| self_define2 | string | 自定义项2 | |
| self_define3 | string | 自定义项3 | |
| self_define4 | string | 自定义项4 | |
| self_define5 | string | 自定义项5 | |
| self_define6 | string | 自定义项6 | |
| self_define7 | string | 自定义项7 | |
| self_define8 | string | 自定义项8 | |
| self_define9 | string | 自定义项9 | |
| self_define10 | string | 自定义项10 | |
| self_define11 | string | 自定义项11 | |
| self_define12 | string | 自定义项12 | |
| self_define13 | string | 自定义项13 | |
| self_define14 | string | 自定义项14 | |
| self_define15 | string | 自定义项15 | |
| self_define16 | string | 自定义项16 | |
| invcode | string | entry | 存货编码 |
| free1 | string | entry | 自由项1 |
| free2 | string | entry | 自由项2 |
| free3 | string | entry | 自由项3 |
| free4 | string | entry | 自由项4 |
| free5 | string | entry | 自由项5 |
| free6 | string | entry | 自由项6 |
| free7 | string | entry | 自由项7 |
| free8 | string | entry | 自由项8 |
| free9 | string | entry | 自由项9 |
| free10 | string | entry | 自由项10 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"page_index":"2",
"rows_per_page":"10",
"row_count":"23",
"errmsg":"",
"errcode":"0",
"page_count":"3",
"inventory":[
{
"bottom_sale_price":null,
"code":"01019002077",
"sort_code":"0101",
"ref_sale_price":null,
"sort_name":"PC原辅材料",
"end_date":null,
"invaddcode":null,
"entry":[
{
"invcode":"01019002077",
"free1":"",
"free3":"",
"free2":"",
"free5":"",
"free4":"",
"free7":"",
"free6":"",
"free9":"",
"free10":"",
"free8":""
}
],
"name":"五金件",
"main_measure":"0108",
"ccomunitname":"PCS",
"start_date":"2010-01-0100:00:00.0",
"specs":"8025风扇网罩"
},
{
"bottom_sale_price":null,
"code":"01019002078",
"sort_code":"0101",
"ref_sale_price":null,
"sort_name":"PC原辅材料",
"end_date":null,
"invaddcode":null,
"entry":[
{
"invcode":"01019002078",
"free1":"",
"free3":"",
"free2":"",
"free5":"",
"free4":"",
"free7":"",
"free6":"",
"free9":"",
"free10":"",
"free8":""
}
],
"name":"辅材",
"main_measure":"0108",
"ccomunitname":"PCS",
"start_date":"2010-01-0100:00:00.0",
"specs":"硬盘减震橡胶圈"
}
]
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode" : "30021",
"errmsg" : "此应用未上线"
}