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

一、业务背景

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

二、保存接口

1. 注意事项

   。构建多行明细时，需要将IsEntryBatchFill设置为false

   。车间录不上时，在bos设计器上检查过滤条件，在部门检查车间是否勾上

   。更新库存失败，即时库存表唯一索引冲突，则即时库存表不能同时存在辅单位录入和未录入数据，需要检查辅单位     和辅单位数量

   。api不重算库存数量，在单据选项，业务参数控制

   。传入的领料单审核后，不更新库存，FStockFlag字段设置为0则表示库存未更新，1则表示库存已更新

   。传入领料单，数据包正确，提示需要先录入发料组织，在bos设计器取消生产组织默认取当前组织

   。传入领料单，数据包正确，提示没有分录，在单据选项参数->业务参数，取消勾选清除实发为零分录，另外实发会     根据应发数量来算，应发也不能为零，否则算出来实发仍为零，分录仍被清掉

   
   

2. 字段介绍

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

   
   

3. 关联关系表的构建

   可参考【https://vip.kingdee.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

   
   

4. 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": ""
         }
       ]
     }
   }