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

一、业务背景

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

1、保存接口

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

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

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

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

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": "WWTLD01_SYS"
        },
        "FDate": "2024-05-24 17:23:06",
        "FStockOrgId": {
            "FNumber": "100"
        },
        "FSubOrgId": {
            "FNumber": "100"
        },
        "FSubSupplierId": {
            "FNumber": "VEN00001"
        },
        "FOwnerTypeId0": "BD_OwnerOrg",
        "FSTOCKERID": {
            "FNAME": ""
        },
        "FOwnerId0": {
            "FNumber": "100"
        },
        "FIsCrossTrade": false,
        "FVmiBusiness": false,
        "FIsOwnerTInclOrg": false,
        "FEntity": [
            {
                "FMaterialId": {
                    "FNumber": "testtld1"
                },
                "FUnitID": {
                    "FNumber": "Pcs"
                },
                "FAPPQty": 1,
                "FQty": 1,
                "FReturnType": "1",
                "FStockId": {
                    "FNumber": "014"
                },
                "FSUBReqBillNo": "SUB00000247",
                "FSrcEntrySeq": 1,
                "FParentMaterialId": {
                    "FNumber": "testtld"
                },
                "FSUBReqId": 100268,
                "FSUBReqEntrySeq": 1,
                "FPPBOMEntryId": 100745,
                "FSubReqEntryId": 100372,
                "FOwnerTypeId": "BD_OwnerOrg",
                "FOwnerId": {
                    "FNumber": "100"
                },
                "FSrcBillNo": "SUBBOM00000335",
                "FSrcBillType": "SUB_PPBOM",
                "FSrcBillId": 100353,
                "FSrcEntryId": 100745,
                "FBaseUnitId": {
                    "FNumber": "Pcs"
                },
                "FReserveType": "1",
                "FSettleOrgId": {
                    "FNumber": "100"
                },
                "FBaseStockQty": 1,
                "FBaseAppQty": 1,
                "FBaseQty": 1,
                "FStockUnitId": {
                    "FNumber": "Pcs"
                },
                "FStockAppQty": 1,
                "FStockQty": 1,
                "FStockStatusId": {
                    "FNumber": "KCZT01_SYS"
                },
                "FKeeperTypeId": "BD_KeeperOrg",
                "FKeeperId": {
                    "FNumber": "100"
                },
                "FOperId": 10,
                "FEntryVmiBusiness": false,
                "FIsUpdateQty": false,
                "FPOOrderBillNo": "CGDD000227",
                "FPOOrderSeq": 1,
                "FIsOverLegalOrg": false,
                "FCheckSubRtnMtrl": false,
                "FSupplierId": {
                    "FNUMBER": "VEN00001"
                },
                "FParentOwnerTypeId": "BD_OwnerOrg",
                "FParentOwnerId": {
                    "FNumber": "100"
                },