# 工程变更单WebAPI知识整理
## 变更业务适用范围
工程变更单一共有三种变更类型：立即变更，按日期变更以及用完旧料。三种变更类型支持的变更种类如下表格所示（-为该业务模式下不支持此类变更业务）：
|变更业务\变更类型|立即变更|按日期变更|用完旧料|
|:---|:---:|:---:|:---:|
|新增子项|||-|
|修改子项||按日期生效[^1]|生成新旧料替代件[^2]|
|删除子项||-|-|
|失效子项|||-|
|替代选择|||-|
|替代设置|||-|
|新增联副产品||-|-|
|修改联副产品||-|-|
|失效联副产品||-|-|
|删除联副产品||-|-|
[^1]:按日期生效模式的修改子项生效效果：变更BOM版本新插入【变更后】的子项，生效日期由变更单的表头生效日期算起;同时处理【变更前】的子项，标记失效日期为变更单表头的生效日期。
[^2]:用完旧料类型的修改子项生效效果：变更BOM版本新插入【变更后】的子项，生效日期由变更单的表头生效日期算起;同时处理【变更前】的子项，将其更改成新子项的替代件。
## 重要字段说明
### 单据头
|字段标识|功能说明|
|:---|:---|
|FChangeType|变更类型：1.立即变更 2.按日期变更 3.用完旧料。该字段为状态字段，webapi无法对接，须使用二开字段+值更新联动填充|
|FIsUpdateVersion|版本升级，勾选此选项将会将所选的物料清单作升版处理。升版有两种模式：1.生成新的高版本BOM。2.在原先的BOM版本基础上更新版本号，并拷贝生成一个历史副本。不勾选次参数的情况下，变更单生效后修改将直接写回原BOM。|
|FIsForbidSrcBom|是否禁用原BOM版本，版本升级的配套参数。同时勾选次参数，在升版完成时同步禁用老版本|
|FIsUpdatePPBom|更新用料清单：勾选此参数将会允许使用同步用料清单。在同时勾选版本升级和该参数时，升级的新版本为模式2|
### 子项明细
|字段标识|功能说明|
|:---|:---|
|FECNRowId|ECN行标识。36位长度字符串，工程变更单的子项明细内唯一。|
|FECNGroup|ECN行组别。用于给每一个变更子项作分组依据。其中修改子项存在【变更前】【变更后】两个子项，它们公用一个行组别。|
|FBomEntryId|BOM子项内码。用于追溯加载所选BOM的子项明细分录内码。修改子项，失效子项，删除子项必填此字段，否则功能不正常。新增行无需使用该字段|
|FRowType|ECN行类型。用于生效时按照ECN行组别分组后确认该组属于什么类型的变更。1.新增子项。2.修改子项。3.删除子项。4.失效子项。传错该字段，生效时将会无法识别变更类型。|
|FChangeLabel|变更标识。用于界面识别所选子项属于什么类型的变更业务。0.变更前。1.变更后。2.新增。3.删除。4.失效|
## WebAPI格式
### 新增子项
```json
{
"NeedUpDateFields": [],
"NeedReturnFields": [],
"IsDeleteEntry": "true",
"SubSystemId": "",
"IsVerifyBaseDataField": "false",
"IsEntryBatchFill": "true",
"ValidateFlag": "true",
"NumberSearch": "true",
"IsAutoAdjustField": "false",
"InterationFlags": "",
"IgnoreInterationFlag": "",
"IsControlPrecision": "false",
"ValidateRepeatJson": "false",
"Model": {
"FID": 0,
"FBillTypeID": {
"FNUMBER": "GCBG01_SYS"
},
"FChangeReason": {
"FNumber": "GCBGYY01_SYS"
},
"FChangeOrgId": {
"FNumber": "100"
},
"FIsUpdateVersion": false,
"FIsUpdatePPBom": false,
"FEffectDate0": "2023-04-07 00:00:00",
"FApplyDate": "2023-04-07 00:00:00",
"FIsDebugMode": true,
"FRepItemAlterPolicy": "1",
"FIsForbidSrcBom": false,
"FTreeEntity": [
{
"FReplaceGroup": 0,
"FRowType": "1",
"FChangeLabel": "2",
"FBOMVERSION": {
"FNUMBER": "KPECN_V1.0"
},
"FBOMCATEGORY": "1",
"FParentMaterialId": {
"FNUMBER": "KPECN"
},
"FInsertRow": 1,
"FMATERIALIDCHILD": {
"FNumber": "KPECNS"
},
"FMATERIALTYPE": "1",
"FCHILDUNITID": {
"FNumber": "Pcs"
},
"FDOSAGETYPE": "2",
"FNUMERATOR": 1.0,
"FDENOMINATOR": 1.0,
"FFIXSCRAPQTY": 0.0,
"FSCRAPRATE": 0.0,
"FOverControlMode": "1",
"FIsCanChoose": false,
"FIsCanEdit": false,
"FIsCanReplace": false,
"FReplacePriority": 0,
"FMRPPriority": 0,
"FIskeyItem": false,
"FALLOWOVER": false,
"FISSkip": false,
"FISMinIssueQty": false,
"FTreeEntryIdBak": 0,
"FCfgFeatureEntryId": 0,
"FEFFECTDATE": "2023-04-07 00:00:00",
"FEXPIREDATE": "9999-12-31 00:00:00",
"FISSUETYPE": "1",
"FISGETSCRAP": true,
"FOFFSETTIME": 0,
"FTIMEUNIT": "1",
"FISKEYCOMPONENT": false,
"FOPERID": 10,
"FOWNERTYPEID": "BD_OwnerOrg",
"FDISASSMBLERATE": 0.0,
"FECNRowId": "00505691-8ddc-9ac9-11ed-d5075dcebc0e",
"FECNGroup": "00505691-8ddc-9ac9-11ed-d5075dcebc0f",
"FParentUnitID": {
"FNumber": "Pcs"
},
"FParentBaseUnitId": {
"FNumber": "Pcs"
},
"FBomEntryId": 0,
"FECNRowExpandType": 16,
"FIsChangeMtrl": false,
"FIsNeedSync": false,
"FIsMrpRun": true,
"FNETDEMANDRATE": 0.0,
"FIsEcnClearOldMtrl": false,
"FSTEntryId": 0
}
]
}
}
```
### 修改子项
```json
{
"NeedUpDateFields": [],
"NeedReturnFields": [],
"IsDeleteEntry": "true",
"SubSystemId": "",
"IsVerifyBaseDataField": "false",
"IsEntryBatchFill": "true",
"ValidateFlag": "true",
"NumberSearch": "true",
"IsAutoAdjustField": "false",
"InterationFlags": "",
"IgnoreInterationFlag": "",
"IsControlPrecision": "false",
"ValidateRepeatJson": "false",
"Model": {
"FID": 0,
"FBillTypeID": {
"FNUMBER": "GCBG01_SYS"
},
"FChangeReason": {
"FNumber": "GCBGYY01_SYS"
},
"FChangeOrgId": {
"FNumber": "100"
},
"FIsUpdateVersion": false,
"FIsUpdatePPBom": false,
"FEffectDate0": "2023-04-07 00:00:00",
"FApplyDate": "2023-04-07 00:00:00",
"FIsDebugMode": true,
"FRepItemAlterPolicy": "1",
"FIsForbidSrcBom": false,
"FTreeEntity": [
{
"FReplaceGroup": 2,
"FRowType": "2",
"FChangeLabel": "0",
"FBOMVERSION": {
"FNUMBER": "ECN_V1.0"
},
"FBOMCATEGORY": "1",
"FInsertRow": 0,
"FMATERIALIDCHILD": {
"FNumber": "00007"
},
"FMATERIALTYPE": "1",
"FCHILDUNITID": {
"FNumber": "Pcs"
},
"FDOSAGETYPE": "2",
"FNUMERATOR": 1.0,
"FDENOMINATOR": 1.0,
"FFIXSCRAPQTY": 0.0,
"FSCRAPRATE": 0.0,
"FOverControlMode": "1",
"FIsCanChoose": false,
"FIsCanEdit": false,
"FIsCanReplace": false,
"FReplacePriority": 0,
"FMRPPriority": 0,
"FIskeyItem": false,
"FALLOWOVER": false,
"FISSkip": false,
"FISMinIssueQty": false,
"FTreeEntryIdBak": 111088,
"FCfgFeatureEntryId": 0,
"FEFFECTDATE": "2022-07-05 00:00:00",
"FEXPIREDATE": "9999-12-31 00:00:00",
"FISSUETYPE": "1",
"FISGETSCRAP": true,
"FOFFSETTIME": 0,
"FTIMEUNIT": "1",
"FISKEYCOMPONENT": false,
"FOPERID": 10,
"FOWNERTYPEID": "BD_OwnerOrg",
"FDISASSMBLERATE": 0.0,
"FECNRowId": "00505691-8ddc-9ac9-11ed-d51e31045d34",
"FECNGroup": "00505691-8ddc-9ac9-11ed-d51e31045d36",
"FParentUnitID": {
"FNumber": "Pcs"
},
"FParentBaseUnitId": {
"FNumber": "Pcs"
},
"FBomEntryId": 111088,
"FECNRowExpandType": 0,
"FIsChangeMtrl": false,
"FIsNeedSync": false,
"FIsMrpRun": true,
"FNETDEMANDRATE": 0.0,
"FIsEcnClearOldMtrl": false,
"FSTEntryId": 0
},
{
"FReplaceGroup": 2,
"FRowType": "2",
"FChangeLabel": "1",
"FBOMVERSION": {
"FNUMBER": "ECN_V1.0"
},
"FBOMCATEGORY": "1",
"FInsertRow": 0,
"FMATERIALIDCHILD": {
"FNumber": "00007"
},
"FMATERIALTYPE": "1",
"FCHILDUNITID": {
"FNumber": "Pcs"
},
"FDOSAGETYPE": "2",
"FNUMERATOR": 1.0,
"FDENOMINATOR": 1.0,
"FFIXSCRAPQTY": 0.0,
"FSCRAPRATE": 0.0,
"FOverControlMode": "1",
"FIsCanChoose": false,
"FIsCanEdit": false,
"FIsCanReplace": false,
"FReplacePriority": 0,
"FMRPPriority": 0,
"FIskeyItem": false,
"FALLOWOVER": false,
"FISSkip": false,
"FISMinIssueQty": false,
"FTreeEntryIdBak": 111088,
"FCfgFeatureEntryId": 0,
"FEFFECTDATE": "2022-07-05 00:00:00",
"FEXPIREDATE": "9999-12-31 00:00:00",
"FISSUETYPE": "1",
"FISGETSCRAP": true,
"FOFFSETTIME": 0,
"FTIMEUNIT": "1",
"FISKEYCOMPONENT": false,
"FOPERID": 10,
"FOWNERTYPEID": "BD_OwnerOrg",
"FDISASSMBLERATE": 0.0,
"FECNRowId": "00505691-8ddc-9ac9-11ed-d51e31045d35",
"FECNGroup": "00505691-8ddc-9ac9-11ed-d51e31045d36",
"FParentUnitID": {
"FNumber": "Pcs"
},
"FParentBaseUnitId": {
"FNumber": "Pcs"
},
"FBomEntryId": 111088,
"FECNRowExpandType": 0,
"FIsChangeMtrl": false,
"FIsNeedSync": false,
"FIsMrpRun": true,
"FNETDEMANDRATE": 0.0,
"FIsEcnClearOldMtrl": false,
"FSTEntryId": 0
}
]
}
}
```
### 失效子项
```json
{
"NeedUpDateFields": [],
"NeedReturnFields": [],
"IsDeleteEntry": "true",
"SubSystemId": "",
"IsVerifyBaseDataField": "false",
"IsEntryBatchFill": "true",
"ValidateFlag": "true",
"NumberSearch": "true",
"IsAutoAdjustField": "false",
"InterationFlags": "",
"IgnoreInterationFlag": "",
"IsControlPrecision": "false",
"ValidateRepeatJson": "false",
"Model": {
"FID": 0,
"FBillTypeID": {
"FNUMBER": "GCBG01_SYS"
},
"FChangeReason": {
"FNumber": "GCBGYY01_SYS"
},
"FChangeOrgId": {
"FNumber": "100"
},
"FIsUpdateVersion": false,
"FIsUpdatePPBom": false,
"FEffectDate0": "2023-04-12 00:00:00",
"FApplyDate": "2023-04-12 00:00:00",
"FIsDebugMode": true,
"FRepItemAlterPolicy": "1",
"FIsForbidSrcBom": false,
"FTreeEntity": [
{
"FReplaceGroup": 1,
"FRowType": "4",
"FChangeLabel": "4",
"FBOMVERSION": {
"FNUMBER": "ECN_V1.0"
},
"FBOMCATEGORY": "1",
"FInsertRow": 0,
"FMATERIALIDCHILD": {
"FNumber": "1.01.001.0003"
},
"FMATERIALTYPE": "1",
"FCHILDUNITID": {
"FNumber": "Pcs"
},
"FDOSAGETYPE": "2",
"FNUMERATOR": 1.0,
"FDENOMINATOR": 1.0,
"FFIXSCRAPQTY": 0.0,
"FSCRAPRATE": 0.0,
"FOverControlMode": "1",
"FIsCanChoose": false,
"FIsCanEdit": false,
"FIsCanReplace": false,
"FReplacePriority": 0,
"FMRPPriority": 0,
"FIskeyItem": false,
"FALLOWOVER": false,
"FISSkip": false,
"FISMinIssueQty": false,
"FTreeEntryIdBak": 100806,
"FCfgFeatureEntryId": 0,
"FEFFECTDATE": "2022-05-01 00:00:00",
"FEXPIREDATE": "2023-04-12 00:00:00",
"FISSUETYPE": "1",
"FISGETSCRAP": true,
"FOFFSETTIME": 0,
"FTIMEUNIT": "1",
"FISKEYCOMPONENT": false,
"FOPERID": 10,
"FOWNERTYPEID": "BD_OwnerOrg",
"FDISASSMBLERATE": 0.0,
"FECNRowId": "00505691-8ddc-a48a-11ed-d92e1688e4c3",
"FECNGroup": "00505691-8ddc-a48a-11ed-d92e1688e4c4",
"FParentUnitID": {
"FNumber": "Pcs"
},
"FParentBaseUnitId": {
"FNumber": "Pcs"
},
"FBomEntryId": 100806,
"FECNRowExpandType": 0,
"FIsChangeMtrl": false,
"FIsNeedSync": false,
"FIsMrpRun": true,
"FNETDEMANDRATE": 0.0,
"FIsEcnClearOldMtrl": false,
"FSTEntryId": 0
}
]
}
}
```
### 删除子项
```json
{
"NeedUpDateFields": [],
"NeedReturnFields": [],
"IsDeleteEntry": "true",
"SubSystemId": "",
"IsVerifyBaseDataField": "false",
"IsEntryBatchFill": "true",
"ValidateFlag": "true",
"NumberSearch": "true",
"IsAutoAdjustField": "false",
"InterationFlags": "",
"IgnoreInterationFlag": "",
"IsControlPrecision": "false",
"ValidateRepeatJson": "false",
"Model": {
"FID": 0,
"FBillTypeID": {
"FNUMBER": "GCBG01_SYS"
},
"FChangeReason": {
"FNumber": "GCBGYY01_SYS"
},
"FChangeOrgId": {
"FNumber": "100"
},
"FIsUpdateVersion": false,
"FIsUpdatePPBom": false,
"FEffectDate0": "2023-04-12 00:00:00",
"FApplyDate": "2023-04-12 00:00:00",
"FIsDebugMode": true,
"FRepItemAlterPolicy": "1",
"FIsForbidSrcBom": false,
"FTreeEntity": [
{
"FReplaceGroup": 1,
"FRowType": "3",
"FChangeLabel": "3",
"FBOMVERSION": {
"FNUMBER": "ECN_V1.0"
},
"FBOMCATEGORY": "1",
"FInsertRow": 0,
"FMATERIALIDCHILD": {
"FNumber": "1.01.001.0003"
},
"FMATERIALTYPE": "1",
"FCHILDUNITID": {
"FNumber": "Pcs"
},
"FDOSAGETYPE": "2",
"FNUMERATOR": 1.0,
"FDENOMINATOR": 1.0,
"FFIXSCRAPQTY": 0.0,
"FSCRAPRATE": 0.0,
"FOverControlMode": "1",
"FIsCanChoose": false,
"FIsCanEdit": false,
"FIsCanReplace": false,
"FReplacePriority": 0,
"FMRPPriority": 0,
"FIskeyItem": false,
"FALLOWOVER": false,
"FISSkip": false,
"FISMinIssueQty": false,
"FTreeEntryIdBak": 100806,
"FCfgFeatureEntryId": 0,
"FEFFECTDATE": "2022-05-01 00:00:00",
"FEXPIREDATE": "9999-12-31 00:00:00",
"FISSUETYPE": "1",
"FISGETSCRAP": true,
"FOFFSETTIME": 0,
"FTIMEUNIT": "1",
"FISKEYCOMPONENT": false,
"FOPERID": 10,
"FOWNERTYPEID": "BD_OwnerOrg",
"FDISASSMBLERATE": 0.0,
"FECNRowId": "00505691-8ddc-a48a-11ed-d92dd7b6cb3d",
"FECNGroup": "00505691-8ddc-a48a-11ed-d92dd7b6cb3e",
"FParentUnitID": {
"FNumber": "Pcs"
},
"FParentBaseUnitId": {
"FNumber": "Pcs"
},
"FBomEntryId": 100806,
"FECNRowExpandType": 0,
"FIsChangeMtrl": false,
"FIsNeedSync": false,
"FIsMrpRun": true,
"FNETDEMANDRATE": 0.0,
"FIsEcnClearOldMtrl": false,
"FSTEntryId": 0
}
]
}
}
```
