《PO-开发功能说明书-E3S与SAP创建销售订单.doc》由会员分享，可在线阅读，更多相关《PO-开发功能说明书-E3S与SAP创建销售订单.doc（9页珍藏版）》请在三一办公上搜索。
1、版本作者修改描述日期V1.0XXX创建XXXX-XX-XX基本信息需求文档名称E3S与SAP R/3创建销售订单接口版 本1.0所属模块XSD 接口编号FS_SD04接口类型X文件批处理 实时方向X输入到SAP 从SAP输出源系统E3S目标系统SAP R/3需求者信息姓名提出日期所属部门电话功能说明书编写者信息姓名完成日期所属部门电话功能说明书审批信息姓名审批日期所属部门电话E-Mail技术小组成员信息姓名接手日期所属部门电话注:由功能说明书作者负责向开发小组解释此功能说明书遗留问题序号描述级别责任者计划/已解决日期 123功能详细信息目录描述1程序说明2权限设置3涉及业务流程和事务代码（及相
2、关的流程、相关文档、相关系统）4输入文件/输出文件、长度、名称、路径，及网络传输要求5列出数据字段或记录格式6文件格式（包括对应的SAP字段说明，以作数据格式和含义对照）7程序逻辑8程序运行环境9选择规则10排序规则11汇总规则12接口目的与作用，业务相关流程说明（包括SAP和外部系统），及前后有无互相依赖的接口等集成性的说明。13Log的处理说明、重处理说明14主要TABLE及字段表、自建字段与表15测试要求16其它特殊说明事项1 程序说明1.1 流程背景1. 目前ZNA的销售订单是手工创建，即，由经销商把订车信息给到销售部门之后，由销售部门把订单所需的信息手工录入到SAP系统来创建销售订单
3、，此种方式耗用了销售人员大量的精力，效率偏低。E3S系统上线之后，由经销商直接在E3S系统中录入订车信息，通过接口将订车信息传送到SAP，自动在SAP中创建销售订单，开发此接口将销售人员从繁重的手工录入工作中解脱出来，有更多的精力进行销售的管理和分析。2. 从E3S系统取得订单的所有相关信息，包括订单类型、客户、车型等信息通过接口传输到SAP R/3，在SAP中自动生成销售订单。1.2 功能前提前提内容是针对E3S提出的要求l E3S系统能够提供在R/3中生成销售订单所需要的数据源。l 在这里,E3S能够根据不同的订单类型提供不同的订单原始信息。l 对于一些在SAP系统中默认的字段数据信息，E
4、3S不需传输，由SAP系统创建订单时自动抓取系统默认的字段信息。l SAP有关销售订单的主数据以及各种条件已经维护完整。1.3 程序名：ZNASDI04TCODE：ZNASDI04 1.4 触发事项当有经销商或其他客户订车时，由销售部销售人员审核后将创建销售订单的信息形成文件传到SAP。1.5 处理频率按实际需求，预计每天发生的数据量由销售人员审核后E3S系统自动发送，一般情况下要求10分钟发送一次。1.6 功能简介l 从E3S系统取得销售订单的所有相关信息，包括:抬头部分行项部分 对于抬头和行项部分信息需要区分不同的订单类型，不同的订单类型需要的信息不同，根据订单类型从E3S与SAP R/3
5、接口数据中选取信息，自动生成销售订单。1.7 语言环境描述程序在中文语言环境下可以正常执行2 权限设置在此说明该程序只对应相关销售岗位的人员开放3 涉及业务流程和事务代码此接口在R/3中生成销售订单后，可以通过VA03显示销售订单，生成销售订单的事务是VA01。4 输入文件/输出文件、名称、路径、长度，及网络传输要求。/* 此部分由开发人员定义即可要求说明注释文件名ZNASD04_YYYYMMDDHHMMSS.txtYYYYMMDDHHMMSS（输入/输出文件的产生时间）文件内容字段与字段之间没有任何分隔符分开, 每一行的以回车符号结束.文件长度502在此描述该程序的输入/输出文件的路径和文件
6、名 说明目录名称绝对路径（开发系统）输入工作目录Inbound/usr/sap/ZND/Socket/inbound输出工作目录Outbound/usr/sap/ZND/Socket/outbound已处理备份目录Backup/usr/sap/ZND/Socket/backup/znasd04处理出错目录Errorfile/usr/sap/ZND/Socket/errorfile/znasd04日志目录Logfile/usr/sap/ZND/Socket/logfile/znasd04如有网络传输的特殊要求，请注明。（例如，如需要二进制传输，或因为文件大小原因需要分段传输；或对于前后依赖的相关
7、接口的一些文件传输顺序要求等。） */5 列出包含在接口消息中关键/重要的数据字段或记录格式罗列出程序中主要的字段的出处（除贴屏幕标识外，请列出直接的表字段），通过“字段描述”建立两者之间的对照。例屏幕标示:例直接的表字段:（并通过主键说明表之间的关系）：6 文件格式SAP R3中输入文件和格式#字段名是否关键字类型位置长度描述对应的E3S字段，SAP中取值说明，常数，计算公式，转换规则等1AUARTYCHAR4订单类型对应E3S中的订单类型，在E3S中必须事先维护好ZNA中用到的订单类型，并保持与SAP中一致2VKORGCHAR4销售机构对应中销售机构3VTWEGCHAR分销渠道对应中分销渠
8、道4KUNNRYCHAR1110售达方E3S中的客户号，即经销商5KUNNRCHAR2110送达方（有可能售达方与送达方不一致）对应E3S中的收货点，此字段如果是多个行目，多个行项目分别对应到合作伙伴中的送达方,只能一个行项对应一个送达方6BSTNKYCHAR3120客户采购订单编号对应E3S中的采购申请号7BSTDKDATS518采购订单日期对应E3S中下订单日期8ZTERMCHAR594付款条款对应中的付款方式9MATNRCHAR6318物料号对应E3S中的整车物料号10KWMENGQUAN8115数量（如果中传输过来同一个物料号在一个行项目中数量超过时，要折分成个为一行项目）中订单行项目
9、中的订单数量11VKAUSCHAR963发票类型（对应SAP中“行项目”销售A中“用途”，不输入时默认为“增值税发票”。）对应中发票类型12VSARTCHAR992装运类型（如果不填默认为卡车）对应E3S中的送货方式13KBETRCURR10114（其中包含两位小数点和分开符）合同价金额（对应sap中订单行项目中条件KSCHL的一种类型ZPR1的金额）中的合同价金额,E3S中直接传金额。其它关于文件内容或某些字段的特殊说明： 对于创建销售订单时的生产线字段SPART，不需要传，目前系统中全部默认为00,在创建订单时自动取00. 对于销售订单中的行项目号，由在创建订单时自动生成。字段名是否关键字
10、类型位置长度描述对应的E3S字段，SAP中取值说明，常数，计算公式，转换规则等POSNRNUMC6SAP销售订单中行项目号，一个行项目只能对应一个车型，在此接口中行项目号自动生成，不需要传 由于不同的订单类型输入的字段不同，例如：水桶车和按单车的订单，在创建销售订单时需要的数据信息和字段会有所不同，但传送的是包含所有订单类型的信息，针对不同订单类型，对于不需要的信息就不写入到销售订单中，做删除处理。 对于借项销售订单，贷项销售订单的拒绝原因是必填项。对于按单车和水桶车可以为空。 对于”付款条款”和”发票类型”由E3S传输过来一个默认值,在生成销售订单号需要业务人员检查,对需要修改的”付款条款”
11、和”发票类型”. 由于E3S不能区分币别,针对海外客户的订单传输过来的金额,需要海外事业部对应业务人员重点手工检查金额是否正确.7 程序逻辑1. 数据定义，定义相应的内表以满足上载数据文件，数据转换和BAPI函数调用的需求. 2. 上载数据文件。由E3S传输一个文件即可.3. 在数据生成订单之前，调用函数进行检查，发现数据字段不完整，字段长度不符，或字段格式错误等，如果数据有错误提交至日志管理（详见下面LOG及重处理），返回要求修改接口数据，重新发送。数据正确后，提交下一步创建销售订单。4. 销售订单创建，取接口文件中的数据，写至销售订单中对应的字段，在写入销售订单之前，需要对以下数据进行判断
12、。l 根据业务需要，创建销售订单时分为必输字段和非必输字段，对于部分必输字段，在创建订单时必须进行判断。输入项目举例说明订单类型ZSOR必输销售机构8920必输分销渠道30必输生产线0必输售达方必输送达方必输采购订单编号必输采购订单日期2008.08.19不输入时认当天日期付款条件ZCD0不输入时认客户主数据上的付款条件“行项目”物料Z534AN02N000必输“行项目”订单数量2必输“行项目”销售A中“用途”G 工业小票必输，不输入时默认为“增值税发票”“行项目”条件中“ZPR1”合同价90,000.00必输“行项目”条件中“ZK01”贴息1200业务说，已取消“行项目”条件中“ZK02”配
13、置400根据需要输入“行项目”条件中“ZK03”促销0根据需要输入“行项目”条件中“ZK04”返利0根据需要输入“行项目”条件中“ZK05”行业补贴0根据需要输入“行项目”条件中“ZK06”非资源车0根据需要输入“行项目”条件中“ZK07”其他0根据需要输入“行项目”文本中“物料销售文字”根据需要输入“行项目”采购订单数据“售达方-采购订单项目”B根据需要输入“行项目”合作伙伴“WE-“送达方”根据需要输入“抬头”文本中“表抬头”根据需要输入“抬头”文本中“行业流向文本”根据需要输入“抬头”文本中“海外事业订单文本维护”根据需要输入l 在接口文件中读取订单类型数据，销售机构数据，分销渠道数据.
14、在销售凭证抬头表VBAK中检查是否存在以上数据，不存在将错误信息提交日志管理（详见下面LOG及重处理）。.如果数据存在，判断是否有删除标记，有删除标记的不能生成销售订单，将错误信息提交日志管理（详见下面LOG及重处理）。l 在接口文件中读取售达方，送达方数据，.在客户主数据表里检查是否存在售达方送达方客户，不存在将错误信息提交日志管理（详见下面LOG及重处理）。. 如果售达方，送达方数据存在，判断是否有删除标记，有删除标记的不能生成销售订单，将错误信息提交日志管理（详见下面LOG及重处理）。l 行项目数据判断，.在物料主数据表里检查是否存在行项目中的整车物料，不存在将错误信息提交日志管理（详见
15、下面LOG及重处理）。. 如果整车物料数据存在，判断是否有删除标记，有删除标记的不能生成销售订单，将错误信息提交日志管理（详见下面LOG及重处理）。l 对于销售订单物料销售的数量，中传输过来同一个物料号在一个行项目中数量有可能会超过，如果中传输过来同一个物料号在一个行项目中数量超过时，要折分成个为一行项目，如果不超过，不需要拆分。l 数据校验通过后，将接口数据写入销售订单对应字段，对于不同的订单类型，不需要的数据则为空。在系统初期，由于开发以及设计或SAP系统内的数据等缺陷导致的销售订单生成错误：接口程序是无法判断该错误，业务人员发现该错误后，检查系统，修补错误，手工在E3S中更改错误。l 对
16、于部分非必输字段，如果接口传过来的数据没有信息，在订单中可以为空。例如：在销售订单条件中，如果条件“行业补贴”实际上没有数，没有数据上传，那么在中生成销售订单时，此项数据可以为空。5. 数据检查无误，顺利生成销售订单后，将生成的“销售订单号码”，销售订单中的“采购订单号码”写入至自定义表，初次创建订单在此“订单状态表”中，状态为，此时表示订单状态为“发运”，之后通过接口将订单创建信息反馈给系统。销售订单号(VBELN)采购订单号(BSTKD)销售订单状态(total status)XXXXXXXXXXF1XXXXXXXXXXF2XXXXXXXXXXF3关于订单状态的说明：依据业务的需求，订单状
17、态定义逻辑如下：1、F1表示“发运”-当销售订单创建之后，没有全部发运之前都属于发运状态2、F2表示“开票”-当销售订单全部发运，但是还没有全部开票之前为开票状态3、F3表示“在途”-当销售订单全部开票之后为在途状态；注：一个销售订单在此状态表中，只能有一种状态，为了节约系统空间，当一个销售订单所有的业务完成之后，此状态表不再保存其状态数据。8 程序运行环境X SAP前台运行X SAP后台运行9 选择规则无10 排序规则无11 汇总规则无.12 接口设计目的，及相关业务流程（业务情况比较复杂，请使用文字和流程图附件方式详尽说明），及前后有无互相依赖的接口等集成性的说明。无13 Log及重处理业
18、务出错的情况及处理方式1）对于调用BAPI函数的错误和成功信息，应写到日志文件中2）对于调用BAPI函数的错误和成功信息，应写到日志文件中。消息号.消息说明S230S230单据&#,成功生成销售订单E231E231:订单类型& 不存在E232E232:销售机构& 不存在E233E233: 售达方& 不存在E234E234: 送达方& 不存在E235E235:分销渠道&不存在E236E236: 物料号&不存在14 自定义表及字段（重要且业务相关、标准功能不支持的）1) 销售订单状态定义表：销售状态定义表NAMEDescriptionTYPELenDec Place.DYPT relevantMANDTClientCLNT30TATOL STATUS销售订单状态CHAR102) 业务类型定义文本表：业务类型定义文本表NAMEDescriptionTYPELenDec Place.DYPT relevantMANDTClientCLNT30SPRAS语言LANG1TATOL STATUS销售订单状态CHAR10描述CHAR2015 其它特殊说明事项.16 双方签署确认签署确认Sign-off 郑州日产方签字Signature For the ZNA:联友瑞勒森方签字Signature For Lanyou-Renaissance:日期Date: 日期Date:
