部件出入库计划申请&执行&核销
| Frequency |
|---|
| Real time |
请求地址
- API
请求参数
| 字段 | 类型 | 必填 | 长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| source_system | String | Y | 20 | LCFC | 数据来源系统 |
| deduction_plan_directive | String | Y | 32 | XXX-20180613202531469-0801054668 | 库存反馈指令（若⼚家主动反馈，⽣成规则CODE+编码；CODE:英⽂品牌的⼤写前三个字⺟；编码为时间格式（yyyyMMddHHmmssSSS)+⼗位随机数字字符串） |
| version_seq_no | String | Y | 1532406177296 | 版本号(⼚商数据核算时间戳) | |
| tran_seq_no | String | Y | 30 | 如:00-20180727004737523-0075714357 | 请求时产⽣的交易号(防重复)格式:00-请求时间戳-随机数 |
| deduction_items | List<DeductionItemDTO> | Y | 20 | 扣料列表 | |
| remark | String | N | 备注 | 100 | |
| factory_code | String | Y | 32 | ⼯⼚编码North-001 | ⼯⼚编码 |
| inventory_part_belonging | String | N | 20 | ODM/S54/AQ7/Z97 | 物料⼦库的归属(特定⼚商必传)-20221128 |
| deduction_plan_scene | String | N | normal/outBook | 库存场景 不传或normal为常规场景，outBook为账外库存场景 |
DeductionItemDTO 结构
| 字段 | 类型 | 必填 | 长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| deduction_item_line_number | String | Y | 10 | 1 | ⾏，从1开始递增 |
| plan_id | String | Y | 20 | INSODMT0000000000001、INVODMT0000000000001、FOXODMT0000000000001 | 计划id(格式:CODE+编码；CODE:英⽂品牌的⼤写前三个字⺟+ODMT;编码为13位，总共20位字符串) |
| mpn | String | Y | 64 | HUH721008ALE600 | mpn号 |
| plan_consume_date | String | Y | 20 | 2018-05-20 | 预计消耗(发⽣)⽇期(格式:yyyy-MM-dd) |
| consume_type | Integer | Y | 3 | 1 | 消耗类别(0:整机询价1：专有云；2:研发领⽤；3:备件；4：其他；5：RMA-不良品出库;6:ODM内库存转移出;7:机房改配领料;8:质量问题冻结;9:缺货还料;10:ODM间库存转移出;11:⽣产备件领料;12:ODM内库存转移⼊;13:线下PO⼊库;14:机房改配还料;15:质量问题解冻;16:ODM间库存转移⼊;17:扫货买⼊;18:缺货借料;19:部件转良;20:⽣产备件还料;21:研发还料;22:备件还料);23:其他还料;24:特别管理⼊库;25:特别管理出库;26:⼚商借料;27:阿⾥借料;28:专有云⽆指令领料;29:⽣态⽆指令领料;30:固件版本刷新;31:⽣产⼯装领⽤;32:⽣产维修领料;33:样品⼊库;34:线下PO拆解⼊库;35:不良品报废;36:不良品转良;37:不良品RMA返件;38:不良品RMA返款;39:不良品转维修;40:质量问题RMA返件;41:质量问题RMA返款;42:质量问题报废;43:质量问题转维修;44:研发领料归还;45:研发领料费⽤化;46:研发领料RMA返件;47:研发领料RMA返款;48:研发领料转维修;49:版本刷新完⼯;50:版本刷新费⽤化;51:版本刷新RMA返件;52:版本刷新RMA返款;53:版本刷新转维修;54:⼯装领⽤归还;55:⼯装领⽤费⽤化;56:⼯装领⽤RMA返件;57:⼯装领⽤RMA返款;58:⼯装领⽤转维修;59:维修转良;60:维修报废;61:维修RMA返件;62:维修RMA退款;63:⽣产维修领料转良;64:⽣产维修领料报废;65:⽣产维修RMA返件;66:⽣产维修RMA返款;67:⽣产维修领料转维修；68:转维修69:⼚商借料归还;70:阿⾥借料归还71:研发借物72:研发借物归还73:研发借物费⽤化74:研发借物RMA返件75:研发借物RMA返款76:研发借物转维修77：账外库存责任内差异出库78：账外库存责任内差异⼊库79：账外库存物料同⽐置换⼊80：账外库存物料同⽐置换出81：账外物料OPO申请82：Consign部件完⼯⼊库83：Consign部件换货⼊库84：Consign部件⽣产领料;85：consign部件不良品库出库86:consign部件不良品库转良;87：consign部件不良品库RMA返款88：consign部件不良品库RMA返件89:consign部件不良品库报废90:consign部件⽣产退料91:consign部件其它领料92:consign部件其它退料93:板载芯⽚板卡成品⼊库94:芯⽚—次性⼯单退料95:芯⽚—次性⼯单领料96:YMT-研发领料97:YMT-固件版本刷新98:YMT-⽣产⼯装领⽤99:YMT-研发借物100:YMT-consign部件不良品库出库;101:YMT-部件不良品库出库102:YMT-阿⾥借料103:YMT-⼚商借料;104:YMT-consign部件其它领料105:YMT-赠品⼊库106:YMT-线下PO拆解⼊库107:YMT-ODM改配领料再⼊108:YMT-ODM维保领料再⼊109:YMT-线下PO⼊库110:YMT-板载芯⽚板卡成品⼊库111:YMT-芯⽚—次性⼯单退料112:YMT-consign芯⽚板卡成品⼊库113:YMT-consign部件⽣产退料114:YMT-⽆指令领料115:YMT-ODM维保领料116:YMT-ODM改配领料;117:YMT-ODM维保领料(紧急)118:YMT-ODM改配领料(紧急);119:YMT-线下PO出库120:YMT-芯⽚—次性⼯单领料121:YMT-consign部件⽣产领料122:YMT-研发领料费⽤化123:YMT-研发领料归还124:YMT-研发领料RMA返件125:YMT-研发领料RMA返款126:YMT-版本刷新费⽤化127:YMT-版本刷新完⼯128:YMT-版本刷新RMA返件129:YMT-版本刷新RMA返款130:YMT-⼯装领⽤费⽤化131:YMT-⼯装领⽤归还132:YMT-⼯装领⽤RMA返件;133:YMT-⼯装领⽤RMA返款;134:YMT-研发借物费⽤化135:YMT-研发借物归还136:YMT-研发借物RMA返件137:YMT-研发借物RMA返款138:YMT-consign部件不良品库转良139:YMT-consign部件不良品库RMA返件140:YMT-consign部件不良品库RMA返款141:YMT-consign部件不良品库报废142:YMT-部件不良品库转良143:YMT-部件不良品库返不良144:YMT-部件不良品库RMA返件145:YMT-部件不良品库RMA返款;146:YMT-部件不良品库报废;147:YMT-阿⾥借料归还148:YMT-⼚商借料归还149:YMT-consign部件其它退料150:YMT-不良品库消耗出库 |
| plan_consume_quantity | Integer | Y | 11 | 1 | 计划消耗(发⽣)量 |
| executed_quantity | Integer | Y | 11 | 1 | 已执⾏量 |
| remark | String | N | Q43机型100台，For。。。项⽬ | 描述 | |
| approve_type | Integer | Y | 3 | 1 | 审批类型(0:免审;1:审批),此类型需要从审批配置查询接⼝13.3中获取,阿⾥侧会对此字段进⾏强校验,保证两边是⽤的—套规则来限制流程 |
| po_no | String | Y | 32 | 1 | po号[调拨出库和调拨⼊库两种类型必传] |
| po_line | String | Y | 10 | 1 | po⾏号[调拨出库和调拨⼊库两种类型必传] |
| po_brand_name | String | Y | 10 | InventecFoxconnInspur、Quanta | po单交易⼚商名称[调拨出库和调拨⼊库两种类型必传] |
| config_model | String | 服务器、整机柜必传 | 64 | H42S1.22.C0V1P0U2 | 机型 |
| item_type | Byte | Y | 0:服务器部件；1:服务器整机；2:⽹络整机；3:⽹络部件；4:整机柜 | 类型 | |
| origin_plan_id | String | by单据核销需要传 | 50 | FOXODMT0000000000001-001 | 核销原计划id(含⾏号，需把⾏号拼在⼀起)V9.0新增 |
| sub_factory_type | String | 需要指定特定⼦库存操作时传⼊ | 10 | 0:部件;1:整机;2:备件;3:在途;4:在制 | ⼦库存类型，传⼊示例值如：0 |
| deduction_detail_items | List<DeductionDetailDTO> | Y | 20 | 扣料明细列表 | |
| sub_factory_code | String | 需要指定特定⼦库存操作时传⼊ | 40 | 同阿⾥天基库存⼦组织编码 | ⼦库存编码，传⼊示例值如：LENOVO_CO01 |
| operate_type | Byte | Y | 10 | 0:新增1:更新 | 操作类型 |
DeductionDetailDTO 结构
| 字段 | 类型 | 必填 | 长度 | 示例 | 描述 |
|---|---|---|---|---|---|
| inventory_space | String | 需要指定特定库区操作时传⼊ | 10 | 0: defult, 1: 原箱区, 2: 混箱区 | 库区 |
| carton_id | String | 需要指定特定箱包操作时传⼊ | 40 | XXX | 箱包ID |
| quantity | Integer | 传⼊箱包ID时需同步传⼊ | 10 | 箱包交易数量 | |
| sn_list | List<String> | 需要指定特定SN操作时传⼊ | sn001, sn002 | 交易SN列表 | |
| origin_sn_list | List<String> | 指定sn列表核销时需传⼊ | sn001, sn002 | 指定核销SN列表 |
响应参数
| 参数 | 必填 | 类型 | 定义 | 描述 |
|---|---|---|---|---|
| code | Y | String | 状态码 | "0"代表成功,其他失败可参考返回码 |
| msg | N | String | 提示消息 | 非"0"时,会提示错误消息 |
| result | N | object/array | 数据体 |
请求示例
json
{
"batch_id": "90397",
"batch_size": 1,
"seq_id": "1",
"seq_size": 1,
"data": [
{
"source_system": "LCFC",
"deduction_plan_directive": "XXX-20180613202531469-0801054668",
"versionSeqNo": "1532406177296",
"tranSeqNo": "00-201807270",
"deduction_items": [
{
"deduction_item_line_number": "1",
"plan_id": "INSODMT0000000000001",
"mpn": "HUH721008ALE600",
"plan_consume_date": "2018-05-20",
"consume_type": 1,
"plan_consume_quantity": 1,
"executed_quantity": 1,
"remark": "Q43机型100台，For。。。项⽬",
"approve_type": 1,
"po_no": "1",
"po_line": "1",
"po_brand_name": "InventecFoxconnInspur",
"config_model": "H42S1.22.C0V1P0U2",
"item_type": 0,
"origin_plan_id": "FOXODMT0000000000001-001",
"sub_factory_type": "0",
"deduction_detail_items": [{
"inventory_space": "0",
"carton_id": "XXX",
"quantity": 10,
"sn_list": ["sn001", "sn002"],
"origin_sn_list": ["sn001", "sn002"]
}],
"sub_factory_code": "LENOVO_CO01",
"operate_type": 0
}
],
"remark": "备注",
"factory_code": "North-001",
"inventory_part_belonging": "ODM",
"deduction_plan_scene": "normal"
}
]
}成功响应示例
json
{
"code":"0",
"msg":"request success"
}异常响应示例
json
{
"code": "-1",
"msg": "system error!"
}