二开案例-【WebAPI】如何通过WebAPI生成委外补料单

栏目：云星空知识作者：金蝶来源：金蝶云社区发布：2024-09-16浏览：2

一、业务背景

随着越来越多的外部系统通过WebAPI的方式对接金蝶云星空中的委外补料单，下面就关于构建委外补料单的Json数据说明几个需要注意的点，以构建委外补料单关联委外用料清单的数据包作为案例，进行简单的介绍

1、保存接口

1）为了保证委外补料单的业务正常运转，除去一些必录字段，以下字段也需要必录

字段标识	字段名称	字段说明
FSUBReqId	委外订单ID	委外订单内码
FSUBReqBillNo	委外订单	委外订单编号
FSubReqEntryId	委外订单分录ID	委外订单分录内码
FSUBReqEntrySeq	委外订单行号	委外订单行号
FSrcBillType	源单类型	关联业务单据标识，如：委外用料清单【SUB_PPBOM】
FSrcBillNo	源单编号	关联业务单据编号，如：委外用料清单编号
FSrcBillId	源单内码	关联业务单据内码，如：委外用料清单内码
FSrcEntrySeq	源单行号	关联业务单据行号，如：委外用料清单行号
FSrcEnteryId	源单分录内码	关联业务单据分录内码，如：委外用料清单分录内码
FPPBomBillNo	委外用料清单编号	委外用料清单编号
FPPBOMEntryId	委外用料清单分录内码	委外用料清单分录内码
FBFLowId	业务流程	委外领退补料流程【0b064121-4926-4808-8632-a195b6a202e8】，可查询表T_BF_DEFVERSION

2）涉及多行分录参数IsEntryBatchFill设置为false

3）关联关系表FEntity_Link（决定委外补料单是否正确关联委外用料清单以及反写）

关于关联关系的构建说明可参考【https://wenku.my7c.com/article/171055?productLineId=1 】

字段标识	字段名称	字段说明
FEntity_Link_FFlowId	业务流程图	与业务流程一致，如：委外领退补料流程【0b064121-4926-4808-8632-a195b6a202e8】
FEntity_Link_FFlowLineId	推进路线	如：委外用料清单到委外补料单默认8
FEntity_Link_FRuleId	转换规则	单据转换规则标识，如：委外用料清单到委外补料单单据转换标识【SUB_PPBOM_FEED】
FEntity_Link_FSTableName	源单表	如：委外用料清单分录表【T_SUB_PPBOMENTRY】
FEntity_Link_FSBillId	源单内码	如：委外用料清单内码
FEntity_Link_FSId	源单分录内码	如：委外用料清单分录内码
FEntity_Link_FBaseQtyOld	原始携带量	如：委外补料单基本单位实发数量
FEntity_Link_FBaseQty	修改携带量	如：委外补料单基本单位实发数量

4）json示例（注意字段顺序）

{
	"NeedUpDateFields": [],
	"NeedReturnFields": [],
	"IsDeleteEntry": "true",
	"SubSystemId": "",
	"IsVerifyBaseDataField": "false",
	"IsEntryBatchFill": "false",
	"ValidateFlag": "true",
	"NumberSearch": "true",
	"IsAutoAdjustField": "false",
	"InterationFlags": "",
	"IgnoreInterationFlag": "",
	"IsControlPrecision": "false",
	"ValidateRepeatJson": "false",
	"Model": {
		"FID": 0,
		"FBillType": {
			"FNUMBER": "WWBLD01_SYS"
		},
		"FDate": "2024-05-24 00:00:00",
		"FStockOrgId": {
			"FNumber": "100"
		},
		"FSubOrgId": {
			"FNumber": "100"
		},
		"FSubSupplierId": {
			"FNumber": "VEN00001"
		},
		"FOwnerTypeId0": "BD_OwnerOrg",
		"FSTOCKERID": {
			"FNAME": "LZM"
		},
		"FCurrId": {
			"FNumber": "PRE001"
		},
		"FIsCrossTrade": false,
		"FVmiBusiness": false,
		"FIsOwnerTInclOrg": false,
		"FEntity": [
			{
				"FMaterialId": {
					"FNumber": "ZZY002"
				},
				"FUnitID": {
					"FNumber": "Pcs"
				},
				"FAPPQty": 10.0,
				"FActualQty": 10.0,
				"FScrapQty": 0.0,
				"FStockId": {
					"FNumber": "014"
				},
				"FSUBReqEntrySeq": 1,
				"FSUBReqBillNo": "SUB00000245",
				"FSUBReqId": 100266,
				"FStockAppQty": 10.0,
				"FOwnerTypeId": "BD_OwnerOrg",
				"FSubReqEntryId": 100369,
				"FOwnerId": {
					"FNumber": "100"
				},
				"FStockScrapQty": 0.0,
				"FStockSelReturnQty": 0.0,
				"FSrcBillType": "SUB_PPBOM",
				"FSrcBillNo": "SUBBOM00000333",
				"FSecScrapQty": 0.0,
				"FSrcEntrySeq": 1,
				"FSecSelReturnQty": 0.0,
				"FBaseUnitId": {
					"FNumber": "Pcs"
				},
				"FBaseAppQty": 10.0,
				"FBaseActualQty": 10.0,
				"FBaseScrapQty": 0.0,
				"FBaseSelReturnQty": 0.0,
				"FPrice": 0.0,
				"FPPBOMBillNo": "SUBBOM00000333",
				"FAmount": 0.0,
				"FSrcEntryId": 100736,
				"FSrcBillId": 100351,
				"FConsome": "0",
				"FStockUnitId": {
					"FNumber": "Pcs"
				},
				"FParentMaterialId": {
					"FNumber": "ZZY001"
				},
				"FStockActualQty": 10.0,
				"FReserveType": "1",
				"FSettleOrgId": {
					"FNumber": "100"
				},
				"FBaseStockActualQty": 10.0,
				"FSecActualQty": 0.0,
				"FStockStatusId": {
					"FNumber": "KCZT01_SYS"
				},
				"FKeeperTypeId": "BD_KeeperOrg",
				"FKeeperId": {
					"FNumber": "100"
				},
				"FOperId": 10,
				"FEntryVmiBusiness": false,
				"FPOOrderBillNo": "CGDD000224",
				"FPOOrderSeq": 1,
				"FSupplierId": {
					"FNUMBER": "VEN00001"
				},
				"FPPBOMEntryId": 100736,
				"FSRCBIZENTRYSEQ": 0,
				"FSRCBIZINTERID": 0,
				"FSRCBIZENTRYID": 0,
				"FTransRetId": 0,
				"FTransRetEntryId": 0,
				"FTransRetEntrySeq": 0,
				"FIsOverLegalOrg": false,
				"FCheckSubRtnMtrl": false,
				"FParentOwnerTypeId": "BD_OwnerOrg",
				"FParentOwnerId": {
					"FNumber": "100"
				},
				"FEntity_Link": [{
					"FEntity_Link_FRuleId": "SUB_PPBOM_FEED",
					"FEntity_Link_FSTableName": "T_SUB_PPBOMENTRY",
					"FEntity_Link_FSBillId": "100351",
					"FEntity_Link_FSId": "100736",
					"FEntity_Link_FFlowId": "0b064121-4926-4808-8632-a195b6a202e8",
					"FEntity_Link_FFlowLineId": "8",
					"FEntity_Link_FBasePrdRealQtyOld": "10",
					"FEntity_Link_FBasePrdRealQty": "10"
				}],
				"FBFLowId": {
					"FID": "0b064121-4926-4808-8632-a195b6a202e8"
				}
			}
		]
	}
}