bom/batch_get
目录 |
1.接口说明
1.1接口描述
批量获取物料清单
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
产品设计、产品生产
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/bom/batch_get |
| 格式 | JSON |
| https请求方式 | GET |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | sting | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| bomtype | 否 | number | BOM类型(主要/替代) |
| version | 否 | number | 版本号 |
| versiondesc | 否 | string | 版本说明 关键字 |
| versioneffdate | 否 | date | 版本生效日 |
| identcode | 否 | string | 替代标识 |
| identdesc | 否 | string | 替代说明 关键字 |
| cinvcode | 否 | string | 母件编码 |
| cinvname | 否 | string | 母件名称关键字 |
| cinvstd | 是 | string | 规格型号 |
| cinvccode | 否 | string | 存货大类编码 |
| cinvcname | 否 | string | 存货大类关键字 |
| free1 | 否 | string | 自由项1 |
| free2 | 否 | string | 自由项2 |
| free3 | 否 | string | 自由项3 |
| free4 | 否 | string | 自由项4 |
| free5 | 否 | string | 自由项5 |
| free6 | 否 | string | 自由项6 |
| free7 | 否 | string | 自由项7 |
| free8 | 否 | string | 自由项8 |
| free9 | 否 | string | 自由项9 |
| free10 | 否 | string | 自由项10 |
| status | 否 | number | 状态(1:新建/3:审核/4:停用) |
| createuser | 否 | string | 创建人关键字 |
| closeuser | 否 | string | 关闭人关键字 |
3.3请求示例
GET https://api.yonyouup.com/api/bom/batch_get?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=26d2fc4a06844448957a7f8260f3d08b&bomtype=xxxxx&version=xxxxx&versiondesc=xxxxx&versioneffdate=xxxxx&identcode=xxxxx&identdesc=xxxxx&cinvcode=xxxxx&cinvname=xxxxx&cinvstd=xxxxx&cinvccode=xxxxx&cinvcname=xxxxx&free1=xxxxx&free2=xxxxx&free3=xxxxx&free4=xxxxx&free5=xxxxx&free6=xxxxx&free7=xxxxx&free8=xxxxx&free9=xxxxx&free10=xxxxx&status=xxxxx&createuser=xxxxx&closeuser=xxxxx
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| bomid | number | 主键ID | |
| bomtype | number | BOM类型(主要/替代) | |
| version | number | 版本号 | |
| versiondesc | string | 版本说明 | |
| versioneffdate | date | 版本生效日 | |
| versionenddate | date | 版本失效日 | |
| identcode | string | 替代标识 | |
| identdesc | string | 替代说明 | |
| parentid | number | 母件物料Id | |
| cinvcode | string | 存货编码 | |
| cinvname | string | 存货名称 | |
| cinvstd | string | 规格型号 | |
| cinvccode | string | 存货大类编码 | |
| cinvcname | string | 存货名称 | |
| free1 | string | 自由项1 | |
| free2 | string | 自由项2 | |
| free3 | string | 自由项3 | |
| free4 | string | 自由项4 | |
| free5 | string | 自由项5 | |
| free6 | string | 自由项6 | |
| free7 | string | 自由项7 | |
| free8 | string | 自由项8 | |
| free9 | string | 自由项9 | |
| free10 | string | 自由项10 | |
| parentscrap | number | 母件损耗率 | |
| define1 | string | 表头自定义项1 | |
| define2 | string | 表头自定义项2 | |
| define3 | string | 表头自定义项3 | |
| define4 | date | 表头自定义项4 | |
| define5 | number | 表头自定义项5 | |
| define6 | date | 表头自定义项6 | |
| define7 | number | 表头自定义项7 | |
| define8 | string | 表头自定义项8 | |
| define9 | string | 表头自定义项9 | |
| define10 | string | 表头自定义项10 | |
| define11 | string | 表头自定义项11 | |
| define12 | string | 表头自定义项12 | |
| define13 | string | 表头自定义项13 | |
| define14 | string | 表头自定义项14 | |
| define15 | number | 表头自定义项15 | |
| define16 | number | 表头自定义项16 | |
| status | number | 状态(1:新建/3:审核/4:停用) | |
| createuser | string | 创建人 | |
| createdate | date | 创建日期 | |
| closeuser | string | 关闭人 | |
| closedate | date | 关闭日期 | |
| opcomponentid | number | entry | 子件ID |
| bomid | number | entry | 主键ID |
| sortseq | number | entry | 序号 |
| opseq | string | entry | 工序代号 |
| componentid | number | entry | 子件物料Id |
| effbegdate | date | entry | 子件生效日 |
| effenddate | date | entry | 子件失效日 |
| fvflag | number | entry | 固定/变动批量(0/1) |
| baseqtyn | number | entry | 基本用量-分子 |
| baseqtyd | number | entry | 基本用量-分母 |
| compscrap | number | entry | 子件损耗率 |
| byproductflag | boolean | entry | 是否联副产品 |
| auxunitcode | string | entry | 辅助计量单位 |
| changerate | number | entry | 换算率 |
| auxbaseqtyn | number | entry | 辅助基本用量 |
| producttype | number | entry | 产出类型(1:空/2:联产品/3:副产品) |
| define22 | string | entry | 表体自定义项1 |
| define23 | string | entry | 表体自定义项2 |
| define24 | string | entry | 表体自定义项3 |
| define25 | string | entry | 表体自定义项4 |
| define26 | number | entry | 表体自定义项5 |
| define27 | number | entry | 表体自定义项6 |
| define28 | string | entry | 表体自定义项7 |
| define29 | string | entry | 表体自定义项8 |
| define30 | string | entry | 表体自定义项9 |
| define31 | string | entry | 表体自定义项10 |
| define32 | string | entry | 表体自定义项11 |
| define33 | string | entry | 表体自定义项12 |
| define34 | number | entry | 表体自定义项13 |
| define35 | number | entry | 表体自定义项14 |
| define36 | date | entry | 表体自定义项15 |
| define37 | date | entry | 表体自定义项16 |
| remark | string | entry | 备注 |
| recursiveflag | boolean | 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 |
| cinvcode | string | entry | 存货编码 |
| cinvname | string | entry | 存货名称 |
| cinvstd | string | entry | 规格型号 |
| cinvccode | string | entry | 存货大类编码 |
| cinvcname | string | entry | 存货名称 |
| offset | number | entry | 偏置期 |
| wiptype | number | entry | WIP属性(1入库/2工序/3领料/4虚拟) |
| accucostflag | boolean | entry | 是/否累计成本（1/0） |
| drawdeptcode | string | entry | 领料部门 |
| cdepname | string | entry | 部门 |
| whcode | string | entry | 仓库代号 |
| cwhname | string | entry | 仓库 |
| optionalflag | boolean | entry | 是否可选(1/0) |
| mutexrule | number | entry | 互斥原则(1-ONE/2-ALL/3-ANY/4-AL0) |
| planfactor | number | entry | 计划比例 |
| costwiprel | boolean | entry | 成本投产推算 |
| dsubflag | number | entry | 替代标识 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"bom":[
{
"free1":"",
"free3":"",
"define1":"",
"free2":"",
"versionenddate":"2099-12-3100:00:00.0",
"define2":"",
"free5":"",
"define3":"",
"createdate":"2014-12-0200:00:00.0",
"free4":"",
"define4":"",
"define5":"",
"parentid":"55",
"free7":"",
"define6":"",
"free6":"",
"define16":"",
"define7":"",
"free9":"",
"define8":"",
"cinvcode":"1006",
"free8":"",
"free10":"",
"define9":"",
"version":"10",
"cinvname":"复印机",
"createuser":"demo",
"parentscrap":"0.000",
"versiondesc":"10",
"bomtype":"1",
"versioneffdate":"2000-01-0100:00:00.0",
"cinvcname":"办公用品",
"bomid":"1000000027",
"status":"3",
"cinvstd":"",
"closedate":"",
"cinvccode":"10",
"define15":"",
"define14":"",
"define13":"",
"identcode":"",
"define12":"",
"define11":"",
"define10":"",
"entry":[
{
"recursiveflag":"0",
"remark":"",
"whcode":"30",
"cinvcode":"01019002063",
"cinvname":"主板",
"optionalflag":"0",
"cwhname":"PC原材料仓",
"opcomponentid":"1000000009",
"producttype":"1",
"drawdeptcode":"0501",
"cdepname":"一车间",
"bomid":"1000000003",
"effenddate":"2099-12-3100:00:00.0",
"fvflag":"1",
"componentid":"81",
"define29":"",
"define27":"",
"define28":"",
"baseqtyd":"1.000000",
"auxbaseqtyn":"",
"define33":"",
"define32":"",
"define31":"",
"define30":"",
"define37":"",
"define36":"",
"define35":"",
"define34":"",
"sortseq":"20",
"wiptype":"3",
"costwiprel":"0",
"changerate":"",
"free1":"",
"free3":"",
"free2":"",
"free5":"",
"accucostflag":"1",
"free4":"",
"free7":"",
"dsubflag":"0",
"free6":"",
"free9":"",
"free8":"",
"free10":"",
"define24":"",
"define23":"",
"compscrap":"0.000",
"define26":"",
"define25":"",
"define22":"",
"offset":"0",
"baseqtyn":"1.000000",
"cinvcname":"PC原辅材料",
"cinvstd":"超微X8DTL-3f-B",
"byproductflag":"0",
"opseq":"0000",
"cinvccode":"0101",
"mutexrule":"2",
"auxunitcode":"",
"planfactor":"100.000",
"effbegdate":"2000-01-0100:00:00.0"
},
{
"recursiveflag":"0",
"remark":"",
"whcode":"30",
"cinvcode":"01019002063",
"cinvname":"主板",
"optionalflag":"0",
"cwhname":"PC原材料仓",
"opcomponentid":"1000000086",
"producttype":"1",
"drawdeptcode":"0501",
"cdepname":"一车间",
"bomid":"1000000014",
"effenddate":"2099-12-3100:00:00.0",
"fvflag":"1",
"componentid":"81",
"define29":"",
"define27":"",
"define28":"",
"baseqtyd":"1.000000",
"auxbaseqtyn":"",
"define33":"",
"define32":"",
"define31":"",
"define30":"",
"define37":"",
"define36":"",
"define35":"",
"define34":"",
"sortseq":"20",
"wiptype":"3",
"costwiprel":"0",
"changerate":"",
"free1":"",
"free3":"",
"free2":"",
"free5":"",
"accucostflag":"1",
"free4":"",
"free7":"",
"dsubflag":"0",
"free6":"",
"free9":"",
"free8":"",
"free10":"",
"define24":"",
"define23":"",
"compscrap":"0.000",
"define26":"",
"define25":"",
"define22":"",
"offset":"0",
"baseqtyn":"1.000000",
"cinvcname":"PC原辅材料",
"cinvstd":"超微X8DTL-3f-B",
"byproductflag":"0",
"opseq":"0000",
"cinvccode":"0101",
"mutexrule":"2",
"auxunitcode":"",
"planfactor":"100.000",
"effbegdate":"2000-01-0100:00:00.0"
}
],
"identdesc":"",
"closeuser":""
},
{
"free1":"",
"free3":"",
"define1":"",
"free2":"",
"versionenddate":"2099-12-3100:00:00.0",
"define2":"",
"free5":"",
"define3":"",
"createdate":"2014-12-0100:00:00.0",
"free4":"",
"define4":"",
"define5":"",
"parentid":"58",
"free7":"",
"define6":"",
"free6":"",
"define16":"",
"define7":"",
"free9":"",
"define8":"",
"cinvcode":"A010-B000",
"free8":"",
"free10":"",
"define9":"",
"version":"10",
"cinvname":"计算组件",
"createuser":"demo9",
"parentscrap":"0.000",
"versiondesc":"主",
"bomtype":"1",
"versioneffdate":"2000-01-0100:00:00.0",
"cinvcname":"自制半成品",
"bomid":"1000000004",
"status":"3",
"cinvstd":"",
"closedate":"",
"cinvccode":"11",
"define15":"",
"define14":"",
"define13":"",
"identcode":"",
"define12":"",
"define11":"",
"define10":"",
"entry":[
{
"recursiveflag":"0",
"remark":"",
"whcode":"30",
"cinvcode":"01019002063",
"cinvname":"主板",
"optionalflag":"0",
"cwhname":"PC原材料仓",
"opcomponentid":"1000000009",
"producttype":"1",
"drawdeptcode":"0501",
"cdepname":"一车间",
"bomid":"1000000003",
"effenddate":"2099-12-3100:00:00.0",
"fvflag":"1",
"componentid":"81",
"define29":"",
"define27":"",
"define28":"",
"baseqtyd":"1.000000",
"auxbaseqtyn":"",
"define33":"",
"define32":"",
"define31":"",
"define30":"",
"define37":"",
"define36":"",
"define35":"",
"define34":"",
"sortseq":"20",
"wiptype":"3",
"costwiprel":"0",
"changerate":"",
"free1":"",
"free3":"",
"free2":"",
"free5":"",
"accucostflag":"1",
"free4":"",
"free7":"",
"dsubflag":"0",
"free6":"",
"free9":"",
"free8":"",
"free10":"",
"define24":"",
"define23":"",
"compscrap":"0.000",
"define26":"",
"define25":"",
"define22":"",
"offset":"0",
"baseqtyn":"1.000000",
"cinvcname":"PC原辅材料",
"cinvstd":"超微X8DTL-3f-B",
"byproductflag":"0",
"opseq":"0000",
"cinvccode":"0101",
"mutexrule":"2",
"auxunitcode":"",
"planfactor":"100.000",
"effbegdate":"2000-01-0100:00:00.0"
},
{
"recursiveflag":"0",
"remark":"",
"whcode":"30",
"cinvcode":"01019002063",
"cinvname":"主板",
"optionalflag":"0",
"cwhname":"PC原材料仓",
"opcomponentid":"1000000086",
"producttype":"1",
"drawdeptcode":"0501",
"cdepname":"一车间",
"bomid":"1000000014",
"effenddate":"2099-12-3100:00:00.0",
"fvflag":"1",
"componentid":"81",
"define29":"",
"define27":"",
"define28":"",
"baseqtyd":"1.000000",
"auxbaseqtyn":"",
"define33":"",
"define32":"",
"define31":"",
"define30":"",
"define37":"",
"define36":"",
"define35":"",
"define34":"",
"sortseq":"20",
"wiptype":"3",
"costwiprel":"0",
"changerate":"",
"free1":"",
"free3":"",
"free2":"",
"free5":"",
"accucostflag":"1",
"free4":"",
"free7":"",
"dsubflag":"0",
"free6":"",
"free9":"",
"free8":"",
"free10":"",
"define24":"",
"define23":"",
"compscrap":"0.000",
"define26":"",
"define25":"",
"define22":"",
"offset":"0",
"baseqtyn":"1.000000",
"cinvcname":"PC原辅材料",
"cinvstd":"超微X8DTL-3f-B",
"byproductflag":"0",
"opseq":"0000",
"cinvccode":"0101",
"mutexrule":"2",
"auxunitcode":"",
"planfactor":"100.000",
"effbegdate":"2000-01-0100:00:00.0"
}
],
"identdesc":"",
"closeuser":""
}
],
"page_index":"1",
"rows_per_page":"20",
"row_count":"225",
"errmsg":"",
"page_count":"12",
"errcode":"0"
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode":"30021",
"errmsg":"此应用未上线"
}