【WebAPI】如何通过WebAPI构建生产领料单

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

一、业务背景

随着越来越多的外部系统通过WebAPI的方式对接金蝶云星空中单据，但是由于某些单据业务复杂，构建保存的数据包过程出现不同的错误，下面就关于构建生产领料单的Json数据几个需要注意的点，下面以构建生产领料单的数据包作为案例，进行简单的介绍。

二、保存接口

注意事项
。构建多行明细时，需要将IsEntryBatchFill设置为false
。车间录不上时，在bos设计器上检查过滤条件，在部门检查车间是否勾上
。更新库存失败，即时库存表唯一索引冲突，则即时库存表不能同时存在辅单位录入和未录入数据，需要检查辅单位和辅单位数量
。api不重算库存数量，在单据选项，业务参数控制
。传入的领料单审核后，不更新库存，FStockFlag字段设置为0则表示库存未更新，1则表示库存已更新
。传入领料单，数据包正确，提示需要先录入发料组织，在bos设计器取消生产组织默认取当前组织
。传入领料单，数据包正确，提示没有分录，在单据选项参数->业务参数，取消勾选清除实发为零分录，另外实发会根据应发数量来算，应发也不能为零，否则算出来实发仍为零，分录仍被清掉

字段介绍

序号	字段标识	字段名称	字段说明
01	FMoBillNo	生产订单编号	生产订单编号
02	FMoId	生产订单内码	生产订单内码
03	FMoEntryId	生产订单分录内码	生产订单分录内码
04	FMoEntrySeq	生产订单分录行号	生产订单分录行号
05	FSrcBillType	源单类型	关联业务单据标识；如：PRD_PPBOM
06	FSrcBillNo	源单编号	关联业务单据编号；如：生产用料清单编号
07	FEntrySrcInterId	系统源单内码	关联业务单据内码；如：生产用料清单内码
08	FEntrySrcEnteryId	系统源单分录内码	关联业务单据分录内码；如：生产用料清单分录内码
09	FEntrySrcEntrySeq	系统源单行号	关联业务单据行号；如：生产用料清单行号
10	FPPBomBillNo	用料清单编号	用料清单编号
11	FPPBomEntryId	用料清单分录内码	用料清单分录内码

关联关系表的构建

可参考【https://wenku.my7c.com/article/171055?productLineId=1】

序号	字段标识	字段名称	字段说明
01	FEntity_Link_FFlowLineId	推进路线	生产用料清单到领料单，默认5
02	FEntity_Link_FBaseActualQty	修改携带量	生产领料单基本单位实领数量
03	FEntity_Link_FSId	生产用料清单分录内码	生产用料清单分录内码
04	FEntity_Link_FBaseActualQtyOld	原始携带量	生产用料清单基本数量
05	FEntity_Link_FRuleId	单据转换标识	如：PRD_PPBOM2PICKMTRL_NORMAL
07	FEntity_Link_FFlowId	业务流程	如：生产领退补流程【81119477-4778-4d0b-94b9-1c43a1c1f768】
08	FEntity_Link_FSBillId	生产用料清单内码	生产用料清单内码
09	FEntity_Link_FSTableName	生产用料清单表体表名	如：T_PRD_PPBOMENTRY

json实例
{

  "IsDeleteEntry": true,
  "SubSystemId": "",
  "IsEntryBatchFill": true,
  "IsAutoAdjustField": false,
  "Model": {
    "FDate": "1900-01-01",
    "FStockOrgId": {
      "FNumber": ""
    },
    "FBillType": {
      "FNumber": ""
    },
    "FPrdOrgId": {
      "FNumber": ""
    },
    "FEntity": [
      {
        "FSrcBillType": "",
        "FMoBillNo": "",
        "FSrcBillNo": "",
        "FActualQty": 0,
        "FMoId": 0,
        "FPPBomEntryId": 0,
        "FStockUnitId": {
          "FNumber": ""
        },
        "FOwnerTypeId": "BD_OwnerOrg",
        "FParentMaterialId": {
          "FNumber": ""
        },
        "FParentOwnerTypeId": "",
        "FParentOwnerId": {
          "FNumber": ""
        },
        "FMaterialId": {
          "FNumber": ""
        },
        "FBaseActualQty": "",
        "FStockAppQty": 0,
        "FBaseAppQty": "",
        "FUnitID": {
          "FNumber": ""
        },
        "FStockStatusId": {
          "FNumber": ""
        },
        "FKeeperTypeId": "BD_KeeperOrg",
        "FSecUnitId": {
          "FNumber": ""
        },
        "FOwnerId": {
          "FNumber": ""
        },
        "FEntrySrcEnteryId": 0,
        "FEntrySrcInterId": 0,
        "FAppQty": 0,
        "FSecActualQty": 0,
        "FStockFlag": "",
        "FBaseStockActualQty": "",
        "FStockActualQty": 0,
        "FEntrySrcEntrySeq": 0,
        "FKeeperId": {
          "FNumber": ""
        },
        "FStockId": {
          "FNumber": ""
        },
        "FPPBomBillNo": "",
        "FEntryWorkShopId": {
          "FNumber": ""
        },
        "FMoEntryId": 0,
        "FMoEntrySeq": 0,
        "FBaseUnitId": {
          "FNumber": ""
        }
      }
    ],
    "FEntity_Link": [
      {
        "FEntity_Link_FFlowLineId": 0,
        "FEntity_Link_FBaseActualQty": "",
        "FEntity_Link_FSId": "",
        "FEntity_Link_FBaseActualQtyOld": "",
        "FEntity_Link_FRuleId": "",
        "FEntity_Link_FSTableId": 0,
        "FEntity_Link_FFlowId": "",
        "FEntity_Link_FSBillId": "",
        "FEntity_Link_FSTableName": ""
      }
    ]
  }
}

大佬我想请问一下，通过WEBAPI生成领料单的时候，明细中一个批号编码在数据库中有两条数据，数据状态分别为库存和非库存，webapi会默认取非库存那条，导致审核时会出现负库存的错误。这个应该怎么处理呢？

学习到了

666