U9V2.1产业链API使用手册-完工报告

1、U9V2.1产业链PI使用手册-完工报告U9产业链PI使用手册第PGE22页共NUMPGES22页产业链PI：完工报告服务1 、版本记录版本修改与参加人修改时间修改缘由修改内容V2.0sp1魏永生20XX-12-24V2.0sp1魏永生20XX-1-7增加更新服务接口DTO中CUDInt类型与平XX的sysSttes的objectstte类型值一致V2.0sp1魏永生20XX-1-11对修改服务和更新增加状态操纵修改服务和两个更新服务2 、基于U9标准产品的最低版本最低版本号。比方：V2.0sp1非空3、服务清单在此处列举文档中包含的服务，并简要介绍功能，及使用留意事项服务说明创建完工报告单服

2、务CreteCompRptSrv删除完工报告单服务DeleteCompRptSrv修改完工报告单服务ModifyCompRptSrv查询完工报告单服务QueryCompRptSrv更新质检数量服务依据质检信息更新完工报告质检行数量UpdteCompRptCheckSrv更新入库数量服务依据入库信息更新完工报告入库行数量UpdteCompRptRcvSrv4、创建完工报告单服务4.1 使用说明可以批量创建完工报告,指定完工的单据和数量.指定完工时间,单据类型和入库还是出库.4.2 所属DLL说明服务所在的dll程序集UFID.U9.ISV.MO.MOSV.gent.dllUFID.U9.ISV.

3、MO.MOSV.Deploy.dll4.3 服务全名称说明服务含命名空间的全称非代理的全称UFID.U9.ISV.MO.CreteCompRptSrv4.4 接口说明4.4.1 参数DTO类图类图关系：4.4.2 参数DTO描述入口参数说明服务的传入、返回参数接口名称英文接口名称中文类型英文类型中文描述入/返说明可空COMPRPTDTOs完工报告单DTO集合ListUFID.U9.ISV.MOPRPTDTO完工报告单DTO集合入N完工报告单表头DTO业务主键：如：组织+单号属性英文名属性中文名类型必赋值字段其他说明Org完工报告组织IDCodeNmeDTO是录入DocNo单号String录入D

4、esc完工报告描述stringSourceDoc来源单据MOSourceDoc生产订单来源单据属性类型,后面有具体内容CompleteDte完工时间DteTime是CompleteDocType单据类型IDCodeNmeDTO是CompleteOp完工工序String假如单据类型=撤线必录入Direction收发类型CompleteRptDirectionEnum收发类别是0HndleDept经手部门IDCodeNmeDTOHndlePerson经手人IDCodeNmeDTO在经手部门中DescFlexField实体扩展字段DescFlexSegments实体扩展字段集合录入MO生产订单IDC

5、odeNmeDTOMo/pls二者必有一PLS生产线日打算IDCodeNmeDTOMo/pls二者必有一WhshipmentReson退库理由WhShipmentResonEnum退库理由假如收发类型=退库必录入ProductBseUOM生产副单位UOM计量单位假如为空,则=料品.生产单位（复合中）ProductUOM生产单位IDCodeNmeDTO假如为空,则=料品.生产单位（复合中）PUToPBURte生产主-生产副Deciml假如为空,则=料品.生产单位（复合中）CostBseUOM本钱副单位UOM计量单位假如为空,料品.本钱单位（复合中）CostUOM本钱单位UOM计量单位假如为空,料

6、品.本钱单位（复合中）CUTOCBURte本钱主-本钱副Deciml假如为空,料品.本钱单位（复合中）CompleteQty完工数量Deciml是必录入EligibleQty合格数量DecimlIf（料品是免检）录入ReworkingQty待返工数量DecimlIf（料品是免检）录入ScrpQty报废数量DecimlIf（料品是免检）录入CompleteQtyCoUOM完工数量本钱单位Deciml可录入,假如为空,则由转换率计算CompleteQtyWhUOM完工数量库存单位Deciml可录入,假如为空,则由转换率计算EligibleQtyCoUOM合格数量本钱单位Deciml可录入,假如为空

7、,则由转换率计算ReworkingQtyCoUOM待返工数量本钱单位Deciml可录入,假如为空,则由转换率计算ScrpQtyCoUOM报废数量本钱单位Deciml可录入,假如为空,则由转换率计算ReworkReson返工缘由ResonForReworkEnum返工缘由0，必需录入ScrpReson报废缘由ResTimeRptScrpResonEnum报废缘由当报废数量0，必需录入属性类型DTO字段英文名字段中文名类型英中文MOSrcDocType来源单据类别MOSrcDocTypeEnum生产订单来源单据类型SrcDoc来源单据ExternlDTOSrcDocLine来源单据行Externl

8、DTOSrcDocLineNo来源单据行号StringSrcDocNo来源单据号StringSrcDocOrg来源单据组织ExternlDTOSrcDocSubLine来源单据子行ExternlDTOSrcDocSubLineNo来源单据子行号StringSrcDocVer版本号String返回值接口名称英文接口名称中文类型英文类型中文描述入/返说明可空ReturnPrDTO返回DTO完工报告Key集合返完工报告单查询DTO(CompRptKeyDTO)编码名称类型说明唯一标志IDlongid可唯肯定位,其他可为空Org完工报告组织IDCodeNmeDTO组织+单号可唯肯定位,其他可为空Doc

9、No单号String4.5 处理规律1 较验参数DTO2 依DTO给完工报告赋值,完工报告类型,单号,完工日期,完工方向,弹性域,来源单据,完工工序,生产单位,退库理由,合格数量,返工数量,报废数量,报废理由返工理由4.6 代码示例4.6.1 范例场景内部开发创建完工报告使用；4.6.2 范例代码详见产业链PI代码调用范例集锦5、修改完工报告单服务5.1 使用说明按指定的完工报告的业务主键,定位单据,修改指定完工报告的各项属性值,完工数量等5.2 所属DLL说明服务所在的dll程序集UFID.U9.ISV.MO.MOSV.gent.dllUFID.U9.ISV.MO.MOSV.Deploy.d

10、ll5.3 服务全名称说明服务含命名空间的全称非代理的全称UFID.U9.ISV.MO.ModifyCompRptSrv5.4 接口说明5.4.1 参数DTO类图完工报告单DTO-类图假如单据有多层组合关系，请用类图描述关系编码中文名称类型(CompRptModifyDTO)完工报告修改DTO集合完工报告修改DTOCompRptKeyDTO完工报告查询DTO要求唯肯定位CompRptKeyDTOCOMPRPTDTO完工报告单DTO集合COMPRPTDTO5.4.2 参数DTO描述入口参数说明服务的传入、返回参数接口名称英文接口名称中文类型英文类型中文描述入/返说明可空CompRptModify

11、DTOs完工报告修改DTO集合ListUFID.U9.ISV.MOpRptModifyDTO完工报告修改DTO集合入完工报告单修改DTO集合CompRptModifyDTOs完工报告单查询DTO(CompRptKeyDTO)编码名称类型说明唯一标志IDlongid可唯肯定位,其他可为空Org完工报告组织IDCodeNmeDTO组织+单号可唯肯定位,其他可为空DocNo单号String完工报告单DTO集合(CompRptModifyDTO)参见创建服务中的定义返回值接口名称英文接口名称中文类型英文类型中文描述入/返说明可空BOOL返5.5 处理规律按领料单单号或唯一键定位,用修改值,将指定属性值

12、,转换后赋值,同创建时规律相像.5.6 代码示例5.6.1 范例场景内部系统修改完工报告使用；5.6.2 范例代码详见产业链PI代码调用范例集锦6、删除完工报告单服务6.1 使用说明可将指定的完工报告删除可实现批量删除6.2 所属DLL说明服务所在的dll程序集UFID.U9.ISV.MO.MOSV.gent.dllUFID.U9.ISV.MO.MOSV.Deploy.dll6.3 服务全名称说明服务含命名空间的全称非代理的全称UFID.U9.ISV.MO.DeleteCompRptSrv6.4 接口说明说明服务的传入、返回参数接口名称英文接口名称中文类型英文类型中文描述入/返说明可空Comp

13、RptKeyDTOs完工报告查询DTOListUFID.U9.ISV.MOpRptKeyDTO完工报告查询DTO集合入NULL返6.4.1 参数DTO类图6.4.2 参数DTO描述入口参数参数完工报告单查询DTO集合完工报告单查询DTO(CompRptKeyDTO)接口名称英文接口名称中文类型英文CompRptKeyDTOs完工报告查询DTOListCompRptKeyDTO完工报告CompRptKeyDTO具体参见创建完工报告服务单DTO集合返回值接口名称英文接口名称中文类型英文类型中文描述入/返说明可空BOOL返6.5 处理规律删除服务按条件参数找到完工报告删除找到的完工报告要求删除有失败

14、则全部回退6.6 代码示例删除失败则全部回退6.6.1 范例场景应用场景介绍，如调入单，因单据类型中的业务类型会有不同场景。假如没有多个场景的应用可略过6.6.2 范例代码详见产业链PI代码调用范例集锦7、查询完工报告单服务7.1 使用说明按指定条件查询完工报告,并返回整个完工报告的各个属性值可实现批量查询7.2 所属DLL说明服务所在的dll程序集UFID.U9.ISV.MO.MOSV.gent.dllUFID.U9.ISV.MO.MOSV.Deploy.dll7.3 服务全名称说明服务含命名空间的全称非代理的全称UFID.U9.ISV.MO.QueryCompRptSrv7.4 接口说明7

15、.4.1 参数DTO类图完工报告单DTO-类图假如单据有多层组合关系，请用类图描述关系编码中文名称类型(CompRptDTDTO)完工报告数据DTO集合完工报告数据DTOCOMPRPTCheckLineDTOs完工报告质检数量DTOListUFID.U9.ISV.MOPRPTCheckLineDTOCOMPRPTRcvLineDTOs完工报告入库数量DTOListUFID.U9.ISV.MOPRPTRcvLineDTOCOMPRPTWorkHourDTOs完工报告工时明细DTOListUFID.U9.ISV.MOPRPTWorkHourDTO7.4.2 参数DTO描述入口参数说明服务的传入、返

16、回参数接口名称英文接口名称中文类型英文类型中文描述入/返说明可空CompRptKeyDTOs完工报告查询DTOListUFID.U9.ISV.MOpRptKeyDTO完工报告查询DTO集合入完工报告单查询DTO(CompRptKeyDTO)接口名称英文接口名称中文类型英文CompRptKeyDTOs完工报告查询DTOListCompRptKeyDTO具体参见修改完工报告服务完工报告单查询DTO集合返回值说明服务的传入、返回参数接口名称英文接口名称中文类型英文类型中文描述入/返说明可空CompRptDTDTOs完工报告数据DTO集合ListUFID.U9.ISV.MOpRptDTDTO完工报告数

17、据DTO集合返完工报告单数据DTO(CompRptDTDTO)分组编码名称类型MiscISttus分录状态ISttusEnumI状态枚举CompleteRptCheckLines生产订单完工报告检验子表ListCOMPRPTCheckLineDTOCompleteRptRcvLines生产订单完工报告入库子表ListCOMPRPTRcvLineDTOCompleteRptWorkHours完工报告工时明细ListCOMPRPTWorkHourDTOCostField本钱域IDCodeNmeDTOIsCheckedWholeSet齐套检查是否通过BoolenIsCreteTrnsferDoc是否

18、创建调拨单BoolenIsNeedGenI生成转总账交易分录BoolenMRB不合格处理报告IDCodeNmeDTOMRBDocNo不合格处理报告单号StringSourceDoc来源单据MOSourceDoc生产订单来源单据Org完工报告组织IDCodeNmeDTOCompRptType单据类型IDCodeNmeDTOBusinessDte日期DteDocNo单号String挂起解除IsHoldRelese是否挂起Boolen基本信息属性Bin库位IDCodeNmeDTOCompleteDte完工时间DteTimeCompleteDocType单据类型IDCodeNmeDTOComplete

19、Op完工工序StringDirection收发类型CompleteRptDirectionEnum收发类别DocStte状态CompleteRptStteEnum完工报告状态HndleDept经手部门IDCodeNmeDTOHndlePerson经手人IDCodeNmeDTOItem料品IDCodeNmeDTOItemVersion版本ItemMsterVersion料品版本MO生产订单IDCodeNmeDTOPLS生产线日打算IDCodeNmeDTOProductDte生产日期DteProductLine生产线ProductionLine生产线Project项目IDCodeNmeDTOSei

20、bnSeibnIDCodeNmeDTOSeibnCodeSeibnCodeStringTsk任务IDCodeNmeDTOWhshipmentReson退库理由WhShipmentResonEnum退库理由计量单位CostBseUOM本钱副单位IDCodeNmeDTOCoUOM本钱单位IDCodeNmeDTOCUTOCBURte本钱-基准DecimlPBUToCBURte生产-本钱DecimlPBUToSBURte生产-库存DecimlProductBseUOM生产副单位IDCodeNmeDTOProductUOM生产单位IDCodeNmeDTOPUToPBURte生产主-生产副DecimlSt

21、oreBseUOM库存副单位IDCodeNmeDTOSUTOSBURte库存主-库存副DecimlUOMRteCoToMFG本钱-生产DecimlUOMRteMFGToWh生产-库存DecimlWhUOM库存主单位IDCodeNmeDTO批号信息ProductLotMster生产批号Int64ProductLotNo生产批号String凭证信息IsTrnsferedToGL已转总账BoolenTrnsferToGL是否转总账BoolenVoucherDispNum凭证显示号StringVoucherID凭证Int64VoucherTypeID凭证类型Int64入库信息属性ctulRcvTime

22、实际入库时间DteTimeOwnerOrg货主组织IDCodeNmeDTORcvOrg入库组织IDCodeNmeDTORcvQtyByCoUOM实际入库量本钱单位DecimlRcvQtyByProductUOM实际入库量生产单位DecimlRcvQtyByWhUOM实际入库量库存单位DecimlRcvWh存储地点IDCodeNmeDTO审核pproveBy审核人StringpproveOn审核时间DteTimeCncelpproveBy弃审人StringCncelpproveOn弃审时间DteTime完工数量信息CompleteQty完工数量DecimlCompleteQtyCoUOM完工数量

23、DecimlCompleteQtyWhUOM完工数量DecimlEligibleQtyCoUOM合格数量DecimlReworkingQtyCoUOM待返工数量DecimlScrpQtyCoUOM报废数量Deciml质检信息EligibleQty合格数量DecimlIsQC检验BoolenQCDoc质检单MOSourceDoc生产订单来源单据ReworkingQty待返工数量DecimlReworkReson返工缘由ResonForReworkEnum返工缘由ScrpQty报废数量DecimlScrpReson报废缘由ResTimeRptScrpResonEnum报废缘由完工报告单质检数量DT

24、O(COMPRPTCheckLineDTO)编码名称类型说明CUD增删改Int与平XX的objectSttes保存一致CompleteRpt完工报告IDCodeNmeDTO非空LineNum行号Int32非空增加/删除/修改Grde等级GrdeEnum料品等级可空假如该物料需要进行等级操纵，的等级，以及该等级的数量；Element成分ElementEnum料品成分可空假如该物料需要进行成分操纵，的成分，以及该成分的数量；QCResult检验结果QulityCheckResultEnum(1、合格2、不合格)RejectProcessType不合格处理方式RejectProcessTypeEnu

25、m(1返工质检结果不合格处理方式则在完工时，需要输入完工则在完工时，需要输入完工2报废)假如质检结果不合格，则非空，否则可空缺省=报废；Qty数量Deciml非空，单位为完工报告.生产单位该等级或者该成分的合格数量；全部检验子表的数量之和等于完工报告的完工数量完工报告单入库数量DTO(COMPRPTRcvLineDTO)编码名称类型说明CUD增删改Int与平XX的objectSttes保存一致CompleteRpt完工报告IDCodeNmeDTO非空，系统维护LineNum行号Int32非空，系统维护SourceCompleteRptRcv来源完工报告IDCodeNmeDTO只有在退库时使用，

26、对应原完工报告SourceCompleteRptRcvLine来源完工报告入库子表IDCodeNmeDTO只有在退库时使用，对应原完工报告入库子表行Wh存储地点IDCodeNmeDTOBin库位IDCodeNmeDTO非空；录入；StorgeType存储类型StorgeTypeEnum存储类型不能选：冻结、在途缺省=可用；Grde等级GrdeEnum料品等级可空；录入；Element成分ElementEnum料品成分可空；录入；CostPercent本钱比例Deciml每个等级+成分所占全部完工本钱的比例；缺省=0全部子表的本钱比例之和必需等于1；假如存储类型=报废，本钱比例=0按当前行的本钱

27、单位入库数量/全部入库行的本钱单位入库数量之和后XX计算RcvLotMster入库批号主档Int64RcvLotNo入库批号StringRcvQtyByProductUOM入库数量(生产单位)Deciml非空录入RcvQtyByWhUOM入库数量库存单位Deciml可空,假如空则依据转换率自动计算；RcvQtyByCostUOM入库数量本钱单位Deciml可空假如空依据转换率自动计算；汇总自动计算完工报告实体上的本钱单位的实际入库数量，不行修改完工报告单工时明细DTO(COMPRPTWorkHourDTO)编码名称类型说明CompleteRpt完工报告IDCodeNmeDTO非空，系统维护Li

28、neNum行号Int32非空，系统维护MOOpertion生产订单工序IDCodeNmeDTO从生产订单工序中选择PLSOpertion重复打算工序IDCodeNmeDTO从PLS工序中选择OpertionNum工序号String从生产订单工序中带入PrepreHours预备工时Deciml非空假如该工序没有定义产能资源，则由用户输入；假如定义了产能资源，则不同意输入，而是等于ChrgeBsis=Lot的产能资源实际用量的合计；ProcessHours加工工时Deciml非空假如该工序没有定义产能资源，则由用户输入；假如定义了产能资源，则不同意输入，而是等于ChrgeBsis=Item的产能资

29、源实际用量的合计；SetupMchineHours机器预备工时Decieml在生产过程中，机器预备的时间。可空；RunMchineHours机器加工工时Decieml在生产过程中，机器加工的时间。可空；IdleHours空闲工时Deciml非空假如该工序没有定义空闲资源，则由用户输入；假如定义了空闲资源，则不同意输入，而是等于空闲资源的实际用量的合计；WorkHourUOM工时计量单位IDCodeNmeDTO从生产订单工序中带入，不行修改工时的计量单位7.5 处理规律7.6 代码示例7.6.1 范例场景内部系统查询完工报告使用；7.6.2 范例代码详见产业链PI代码调用范例集锦8、更新完工报告

30、质检行数量服务8.1 使用说明将指定的完工报告,按指定DTO中的数值赋值可实现批量更新8.2 所属DLL说明服务所在的dll程序集UFID.U9.ISV.MO.MOSV.gent.dllUFID.U9.ISV.MO.MOSV.Deploy.dll8.3 服务全名称说明服务含命名空间的全称非代理的全称UFID.U9.ISV.MO.UpdteCompRptCheckSrv8.4 接口说明8.4.1 参数DTO类图完工报告单DTO-类图假如单据有多层组合关系，请用类图描述关系编码中文名称类型(CompRptCheckDTO)完工报告修改DTO集合完工报告修改DTOCompRptKeyDTO完工报告查

31、询DTO要求唯肯定位UFID.U9.ISV.MOpRptKeyDTOCOMPRPTCheckLineDTOs完工报告质检行DTO集合UFID.U9.ISV.MOPRPTCheckLineDTO8.4.2 参数DTO描述入口参数说明服务的传入、返回参数接口名称英文接口名称中文类型英文类型中文描述入/返说明可空CompRptCheckDTOs完工报告更新质检行DTO集合ListUFID.U9.ISV.MOpRptCheckDTO完工报告更新质检行DTO集合入完工报告单查询DTO(CompRptKeyDTO)接口名称英文接口名称中文类型英文CompRptKeyDTO完工报告单查询DTOCompRptKeyDTO具体参见创建完工报告修改服务完工报告单查询DTO完工报告单质检行DTO(COMPRPTCheckLineDTO)接口名称英文接口名称中文类型英文COMPRPTCh