超市化采购典型设计手册.doc

附件3超市化采购典型设计手册2012年1月为贯彻落实国家电网公司进一步扩大物资集中采购范围、提高物资管理效益和效率的战略目标，通过构建集中统一、精益高效的集团采购平台实现物资信息化全业务、全流程覆盖，国家电网公司物资部开展了基于电子商务平台的超市化采购研究与应用，制订了超市化采购的管理规范与业务流程，实现了基于信息系统的执行方案与管控手段。为统一国网公司系统内办公用品超市化采购的系统实施方案，促进各单位推广应用，公司编制了超市化采购典型设计手册。手册中明确了超市化采购ERP系统相关配置与开发调整方案，以及与电子商务平台接口规范等内容。编制单位： 天津市电力公司审核单位： 国家电网公司目 录1. 接口4 1.1 ECP同步请购单信息至ERP4 1.2 ERP同步采购申请审批信息至ECP8 1.3 ERP同步采购订单信息至ECP9 1.4 ERP回传采购订单收货信息至ECP11 1.5 ERP回传采购订单付款信息至ECP122. 开发14 2.1 生成采购申请14 2.2 修改、删除采购申请17 2.3 采购申请审批状态回传21 2.4 生成采购订单22 2.5 收货信息回传24 2.6 付款信息回传25 2.7 未自动创建采购订单特殊情况处理功能26 2.8 电子商务平台超市化采购日志查询26超市化采购系统实现方案，是由电子商务平台（简称：ECP）和网省ERP各个部分的系统功能开发组成。系统典型设计方案从接口和ERP开发两个方面，详细说明超市化采购应用系统建设方案在网省ERP的典型设计。11. 接口根据超市化采购详细业务流程以及系统功能划分，网省公司ERP系统需要与总部统一部署的电子商务平台进行接口，清单如下：业务环节序号接口发送方接收方需求提报1ECP同步请购单信息至ERPECP网省ERP2ERP同步采购申请审批信息至ECP网省ERPECP订购管理3ERP同步采购订单信息至ECP网省ERPECP合同履约4ERP回传采购订单收货信息至ECP网省ERPECP5ERP回传采购订单付款信息至ECP网省ERPECP1.1 ECP同步请购单信息至ERP需求人在电子商务平台超市化采购图形化目录中选择所需物料，提交请购单。请购单生成后通过本接口下发至网省ERP，同步生成ERP采购申请。接口传输主要信息包括：请购单号、请购单行项目、凭证类型、物料、数量、评价价格（不含税单价）、工厂等。 接口描述（1） 电子商务平台调用ERP注册在企业服务总线上的服务，用来同步请购单信息； （2） ERP根据消息的接收情况，返回相应标识给电子商务平台。 数据提供方传递数据字段内容： 接口名称ECP同步请购单信息至ERP数据流向双向，主数据流向为：电子商务平台ERP发生频度按需技术路线ESB服务提供方ERP字段名字段描述类型长度数据项说明ZQGDH请购单号（ECP）CHAR25新建字段ZGGDHXM请购单行项目（ECP）CHAR5新建字段BSART凭证类型CHAR4BANFN采购申请CHAR10BNFPO请求项目NUMC5MATNR物料CHAR18WERKS工厂CHAR4LGORT库存地点CHAR4MENGE数量QUAN13PREIS评价价格CURR11/2不含税单价KNTTP项目类别CHAR1SHDZ交货地点及交货方式CHAR40TXZ01物料详细描述CHAR2000此字段通过接口传输ERP，显示在ME53N采购申请“文本”标签下的“项目文本”中LFDAT交货日期DATS8BADAT创建日期DATS8AFNAM实际申请人CHAR12LIFNR供应商CHAR10ECP发送国网供应商编号GWVEN，保存到ERP中值取网省供应商编号，根据ZMM_VENDOR_MAP-LIFNR获得SAKTO总帐科目CHAR10KOSTL成本中心CHAR10ANLN1资产CHAR12PS_PSP_PNRWBS元素NUMC8CSID标识CHAR3新建字段，值为ECP CZLX操作类型CHAR1新建字段1 - 创建2 - 更新 3 - 删除CSDW超市物料单位UNIT3新建字段，ECP发送供应商物料单位编码，保存到ERP中值取国网物料单位名称，根据ZMMDW-MEINS获得CSSL超市物料数量QUAN13新建字段ERNAM创建者CHAR12BANPR审批状态CHAR2值为05是审批完成，08是审批拒绝EKGRP采购组CHAR3AUFNR订单号CHAR12EKORG采购组织CHAR4BUKRS公司代码CHAR4ZSHRID收货人IDCHAR12新建字段 接口参数具体格式如下： 请购单号请购单行项目凭证类型采购申请请求项目物料工厂库存地点数量评价价格项目类别交货地点及交货方式物料详细描述交货日期创建日期实际申请人国网供应商编号总帐科目成本中心资产 WBS元素标识操作类型超市物料单位超市物料数量创建者审批状态采购组订单号采购组织公司代码收货人ID 返回值参数格式如下：采购申请 请求项目请购单号请购单行项目 返回结果标识(0成功或者1失败) 字符长度1失败原因或者成功信息 字符长度100 1.2 ERP同步采购申请审批信息至ECP超市化采购的请购单在ECP中产生，请购单传输至ERP，在ERP中完成请购单的审批。接口传输主要信息包括：请购单号、请购单行项目、采购申请、请求项目、审批状态等。 接口描述（1） ERP调用电子商务平台注册在企业服务总线上的服务，用来同步采购申请审批信息； （2） 电子商务平台根据消息的接收情况，返回相应标识给ERP。 数据提供方传递数据字段内容： 接口名称ERP同步采购申请审批信息至ECP数据流向双向，主数据流向为：ERP电子商务平台发生频度按需技术路线ESB服务提供方电子商务平台字段名字段描述类型长度数据项说明ZQGDH请购单号（ECP）CHAR25ZGGDHXM请购单行项目（ECP）CHAR5BANFN采购申请CHAR10BNFPO请求项目NUMC5BANPR审批状态CHAR205是审批完成，08是审批拒绝ERDAT审批日期DATS8APDIX拒绝原因备注CHAR100 接口参数具体格式如下： 请购单号请购单行项目采购申请请求项目审批状态审批日期拒绝原因备注 返回值参数格式如下：返回结果标识(0成功或者1失败) 字符长度1 失败原因或者成功信息 字符长度200 1.3 ERP同步采购订单信息至ECP采购申请在ERP中审批完成后，立即触发采购订单自动创建程序，并通过接口将采购订单信息同步至ECP。接口传输主要信息包括：请购单号、请购单行项目、采购申请、请求项目、含税价格、税码描述、付款条件描述等。 接口描述（1） ERP调用电子商务平台注册在企业服务总线上的服务，同来同步采购订单信息； （2） 电子商务平台根据消息的接收情况，返回相应标识给ERP。 数据提供方传递数据字段内容： 接口名称ERP同步采购订单信息至ECP数据流向双向，主数据流向为：ERP 电子商务平台发生频度按需技术路线ESB服务提供方电子商务平台字段名字段描述类型长度数据项说明ZQGDH请购单号（ECP）CHAR25ZGGDHXM请购单行项目（ECP）CHAR5BANFN采购申请CHAR10BNFPO请求项目NUMC5ZCGDD采购订单CHAR15值取“网省编号- EBELN”，天津编号为03，福建为13，青海为28例：03-4500012345EBELP项目NUMC5采购订单行项目信息ZHSJG含税价格CURR15/2值取NETWR*MENGE*（1+税率%）ZSMTEST税码描述CHAR50值取字段 MWSKZ的描述TEXT1（默认值取J1-17%进项税，中国）BEDAT凭证日期DATS8ZFKTJ付款条件描述 CHAR50值取字段ZTERM的描述TEXT1（默认值取U000-天津电力即付(自定基准日)）CZIX操作类型CHAR11 - 创建PO 接口参数具体格式如下： 请购单号请购单行项目采购申请请求项目采购订单项目含税价格税码描述凭证日期付款条件描述操作类型 返回值参数格式如下：返回结果标识(0成功或者1失败) 字符长度1 失败原因或者成功信息 字符长度200 1.4 ERP回传采购订单收货信息至ECP用户在ERP系统中进行收货操作，并将收货信息通过接口同步传输给电子商务平台。接口传输的主要信息包括：采购订单、项目、凭证日期、数量、收货单凭证项目编号等。 接口描述（1） ERP调用电子商务平台注册在企业服务总线上的服务，同步传输收货信息； （2） 电子商务平台根据消息的接收情况，返回相应标识给ERP。 数据提供方传递数据字段内容： 接口名称ERP回传采购订单收货信息至ECP数据流向双向，主数据流向为： ERP电子商务平台发生频度按需技术路线ESB服务提供方电子商务平台字段名字段描述类型长度数据项说明ZCGDD采购订单CHAR15值取“网省编号- EBELN”，天津编号为03，福建为13，青海为28例：03-4500012345EBELP项目NUMC5采购订单行项目信息BUDAT凭证日期DATS8值取表“EKBE”ERNAM用户名称CHAR12收货人用户名称，值取表“EKBE”MENGE数量QUAN13/3ELIKZ交货已完成CHAR1已完成为x，未完成为空BELNR收货单凭证项目编号CHAR10值取表“EKBE”BUZEI收货单凭证行项目编号NUMC4值取表“EKBE” 接口参数具体格式如下： 网省编号-采购订单号项目凭证日期用户名称数量交货已完成收货单凭证项目编号收货单凭证行项目编号 返回值参数格式如下：返回结果标识(0成功或者1失败) 字符长度1 失败原因或者成功信息 字符长度200 1.5 ERP回传采购订单付款信息至ECP通过本接口同步付款信息至电子商务平台。接口传输的主要信息包括：采购订单、供应商、付款金额、付款状态等。 接口描述（1） ERP调用电子商务平台注册在企业服务总线上的服务，用来同步传输付款信息； （2） 电子商务平台根据消息的接收情况，返回相应标识给ERP。 数据提供方传递数据字段内容： 接口名称ERP回传采购订单付款信息至ECP数据流向双向，主数据流向为： ERP电子商务平台发生频度按需技术路线ESB服务提供方电子商务平台字段名字段描述类型长度数据项说明ZCGDD采购订单CHAR15值取“网省编号- EBELN”，天津编号为03，福建为13，青海为28例：03-4500012345LIFNR供应商CHAR10ERP发送国网供应商编号GWVEN至ECP值根据表ZMM_VENDOR_MAP获得WRBTR付款金额CURR13PAYSTATUS付款状态CHAR1值为，4：进度款BUDAT付款日期DATS8 接口参数具体格式如下： 网省编号-采购订单号 国网供应商编号 付款金额 付款状态 付款日期 返回值参数格式如下：返回结果标识(0成功或者1失败) 字符长度1 失败原因或者成功信息 字符长度200 2. 开发基于超市化采购流程以及系统功能划分，在网省ERP系统端需进行以下功能的客制化开发或在原开发及系统标准功能上进行调整。2.1 生成采购申请用户在ECP中选择目录商品生成请购单，ERP接收ECP请购单信息后，同步创建采购申请。开发逻辑：ECP中创建一张请购单，提交后，通过接口在ERP中同步创建一张采购申请。先判断凭证类型（BSART）如果为ZPA（项目物资采购申请），则调用CJ20N的bapi，（判断项目是否下达PROJ.OBJNR=JEST.OBJNR AND JEST.INACT IS NOT X AND JEST.STAT =I0002，满足即为下达，如果不满足则返回错误消息），创建一个物料组件，调用bapi，创建采购申请。如果凭证类型（BSART）不为ZPA，则直接创建采购申请。关键字段：首先EBAN里面加如下字段字段名字段描述字段类型字段长度ZQGDH请购单号（ECP）CHAR25ZGGDHXM请购单行项目（ECP）CHAR5CSID标识（ECP）CHAR3同时在ERP系统中创建一张新表，将ECP中请购单的数据存在此表中，然后调用bapi创建采购申请。新建表内容如下：字段名是否主键字段描述字段类型字段长度ZQGDHKEY请购单号（ECP）CHAR25ZGGDHXMKEY请购单行项目（ECP）CHAR5BSART凭证类型CHAR4BANFN采购申请CHAR10BNFPO请求项目NUMC5MATNR物料CHAR18WERKS工厂CHAR4LGORT库存地点CHAR4MENGE数量QUAN13PREIS评价价格CURR11/2KNTTP项目类别CHAR1SHDZ交货地点及交货方式CHAR40TXZ01 物料详细描述CHAR2000LFDAT交货日期DATS8BADAT创建日期DATS8AFNAM实际申请人CHAR12LIFNR供应商（ECP发送国网供应商编号GWVEN，保存到ERP中值取网省供应商编号，根据ZMM_VENDOR_MAP-LIFNR获得）CHAR10SAKTO总帐科目CHAR10KOSTL成本中心CHAR10ANLN1资产CHAR12PS_PSP_PNRWBS元素NUMC8CSID标识（值为ECP）CHAR3CZLX操作类型CHAR1CSDW超市物料单位（ECP发送供应商物料单位编码，保存到ERP中值取国网物料单位名称，根据ZMMDW-MEINS获得）UNIT3CSSL超市物料数量QUAN13ERNAM创建者CHAR12BANPR审批状态(值为05是审批完成，08是审批拒绝)CHAR2EKGRP采购组CHAR3AUFNR订单号CHAR12EKORG采购组织CHAR4BUKRS公司代码CHAR4ZSHRID收货人IDCHAR12功能界面：请购人在电子商务平台中创建请购单，提交之后，自动生成一个ERP端的采购申请号通过采购申请号进入ERP可以进行查看，执行事务代码ME53N，输入申请号，如下图：关于ECP中物料单位换算系数应用：目前ERP系统中单位的定义规则为国网物料的单位，而ECP中单位的定义规则为超市物料供应商配送的最小单位。例，彩色票夹ECP中超市物料的单位是“盒”，单位换算系数是“12”，ERP中国网物料的单位是“个”，当ERP数量选择“1”时，ERP中的数量为“12”。同时，ERP中的评价价格也随之相应变化。（如下图）对应到ERP中的数量（如下图）2.2 修改、删除采购申请ECP创建请购单提交，ERP通过接口创建相应的采购申请后，不允许用户在ERP中进行修改或删除采购申请的操作。如需要对采购申请进行修改或删除操作，则需要在ERP中对采购申请进行审批拒绝，传输拒绝标识到ECP，用户在ECP中进行对请购单的修改或删除，提交后，通过接口将请购单变更信息回传至ERP，重新进入审批流程。开发逻辑：（1）采购申请修改ERP采购申请行项目审批后，传输审批状态BANPR值为08（审批拒绝）到ECP，ECP中请购单行项目的审批状态为已拒绝，允许在ECP中修改相应行项目信息。ECP传输修改采购申请行项目信息至ERP逻辑如下：ECP调用ECP同步请购单信息至ERP接口程序，传输请购单全部行项目信息，ERP判断行项目字段CZLX值为2（更新已有PR），进一步判断字段BANPR值，是否为08，如果是，则更新PR行项目的所有字段。如果否，则返回信息：“采购申请审批通过，不允许修改。”（2）采购申请行项目删除ERP采购申请行项目审批后，传输审批状态BANPR值为08（审批拒绝）到ECP，ECP中请购单行项目的审批状态为已拒绝，允许在ECP中删除相应行项目信息。ECP传输删除采购申请行项目信息至ERP逻辑如下：ECP中行项目删除后，被删除行项目彻底删除，未删除行项目重新排序，但ERP中删除行项目后，被删除行项目信息仍保留，以删除标记形式体现。因此，行项目删除逻辑如下：ECP中删除某一行项目提交后，调用ECP同步请购单信息至ERP接口程序，传输请购单其他未删除全部行项目信息至ERP，ERP识别出没有传输的行项目，如果在ECP传输的整张采购申请中找不到匹配的采购申请行项目，（BANFN、BNFPO），则该条采购申请标记删除。进一步判断字段BANPR值，是否为08，如果是，则对PR行项目标记删除。如果否，则返回信息：“采购申请审批通过，不允许修改。”ECP更新未删除采购申请行项目信息至ERP逻辑如下：接口传输行项目字段BANPR值如果为05，则检查ERP中此字段是否为05，如果是，则更新字段ZQGDH（请购单号）、ZGGDHXM（请购单行项目）。如果否，则返回信息：“采购申请审批拒绝，请修改。”如果请购单除了删除的行项目之外的所有行项目都已经完成审批（审批状态为05），则自动创建采购订单。（3）采购申请整单删除若ERP对整个采购申请的所有行项目审批拒绝，请购人可在电子商务平台对被整单拒绝的采购申请进行整单删除操作。结合ECP同步请购单信息至ECP的接口数据，采购申请整单删除的逻辑如下：接口名称ECP同步请购单信息至ECP数据流向双向，主数据流向为：电子商务平台ERP发生频度按需技术路线ESB服务提供方ERP字段名字段描述类型长度数据项说明ZQGDH请购单号（ECP）CHAR25BANFN采购申请CHAR10CZLX操作类型CHAR13 - 删除当接口接收以上数据时，ERP对采购申请BANFN所有行项目标记删除。关键字段：字段名字段描述字段类型字段长度BANPR审批状态(05是审批完成，08是审批拒绝)CHAR2功能界面：对通过接口在ERP生成的采购申请进行审批操作（ME54N），在ERP中拒绝行项目，保存，状态更新为08（如下图），此时可进入ECP进行相应的修改。网省可根据自身情况，开发拒绝原因输入功能。对于拒绝的采购申请行项目进行删除操作，ECP选中此行项目删除并提交，通过接口功能ERP为对应的行项目增加删除标记。（如下图）ERP标记删除（如下图）注：采购申请号、行项目号是采购申请协同的主键，针对于采购申请的修改和删除操作都是需要在ERP中拒绝之后，进入到电子商务平台中进行修改和删除的。如果使用ME52N进行修改操作则会在ERP中弹出报错信息。（如下图）2.3 采购申请审批状态回传用户在ERP中审批超市化采购申请，审批结果回传至ECP中。开发逻辑：判断逻辑：EBAN-ZQGDH 的值为PR*，例如PR11，则采购申请审批完成后回传审批结果。如果不为超市化采购申请即EBAN-ZQGDH 的值为空，则不传采购申请审批结果给ECP。关键字段：字段名是否主键字段描述字段类型字段长度ZQGDH请购单号（ECP）CHAR25ZGGDHXM请购单行项目（ECP）CHAR5BANFNKEY采购申请CHAR10BNFPOKEY请求项目NUMC5BANPR审批状态，05是审批完成，08是审批拒绝CHAR2ERDAT审批日期DATS8APDIX拒绝原因备注CHAR100功能界面：对超市化采购的采购申请在ERP中使用事务代码ME54N进行审批操作，全部审批层级都完成后，将结果（审批代码）传至ECP，非超市化采购的采购申请不传输。2.4 生成采购订单对于超市化采购的采购申请，在ERP中所有行项目（除删除行项目）审批通过，并收到ECP接收“ERP采购申请审批信息”所有“成功”返回值后，根据需要自动生成采购订单，并通过接口传输采购订单信息到ECP。开发逻辑：（1）如果采购申请所有行项目均审批完成（审批状态BANPR值为05），则发送审批结果至ECP，当收到ECP接收成功的返回信息后，调用bapi自动创建采购订单；（2）如果采购申请中任意一条行项目审批拒绝（审批状态BANPR值为08），则需等待用户在ECP中对审批拒绝的行项目进行修改或删除，直至所有行项目通过审批（审批状态BANPR值为05），并收到ECP接收审批结果成功的返回值后，才能创建订单。关键字段：字段名是否主键字段描述字段类型字段长度ZQGDH请购单号（ECP）CHAR25ZGGDHXM请购单行项目（ECP）CHAR5BANFNKEY采购申请CHAR10BNFPOKEY请求项目NUMC5ZCGDD采购订单，值取“网省编号- EBELN”，天津编号为03，福建为13，青海为28例：03-4500012345CHAR15EBELP项目NUMC5ZHSJG含税价格，值取NETWR*MENGE*（1+税率%）CURR15/2ZSMTEST税码描述，值取字段 MWSKZ的描述TEXT1（默认值取J1-17%进项税，中国）CHAR50BEDAT凭证日期DATS8ZFKTJ付款条件描述 ，值取字段ZTERM的描述TEXT1（默认值取U000-天津电力即付(自定基准日)）CHAR50CZIX操作类型，1 - 创建POCHAR1功能界面：行项目审批全部通过之后，自动生成采购订单。ERP自动生成的采购订单，根据逻辑设计计算出行项目含税金额、税码、付款条件并通过接口传输ECP，在ECP中，可以看到行项目含税金额、税码及付款条件等信息。注：本次超市化采购税码为17% 进项税，付款条件为立即付款。2.5 收货信息回传超市化采购订单