STIHL是一家全球知名的德国公司，成立于1926年，总部位于瓦伊布林根。STIHL以生产高质量的电动工具和园林设备而闻名，尤其是链锯和草坪修剪机。STIHL在创新和技术开发方面有着悠久的历史，并且专注于制造性能卓越且耐用的工具，广泛应用于农业、林业、园艺和家庭园艺。
梳理需求文档
近期我们成功帮助L公司对接STIHL，主要需求为通过SFTP传输通道，接收来自STIHL的DELFOR物料需求预测，发送DESADV发货通知。L公司将会收到STIHL发来的DELFOR EDI规范文档以及 DESADV发货通知的EDI规范文档，版本号均为D99B。企业需要基于此规范文档进行EDI报文与企业内部可处理格式的转换。
SFTP连接测试
在知行之桥EDI系统中，搭建与STIHL的SFTP连接通道，无需代码，只需要在可视化界面中进行简单配置即可，在 SFTP 端口的设置选项卡下配置STIHL的SFTP连接信息：
企业需要配置的SFTP连接信息，包括：用户名、密码、服务器地址、端口号，确认下载路径和上传路径等。
实施方案
本次对接STIHL的EDI项目中，由于供应商L公司内部已有业务系统，因此选择通过数据库中间表的方式实现知行之桥EDI系统与其内部业务系统（Orcale系统）的集成。即EDI系统将STIHL发来的DELFOR交付计划数据解析并插入数据库中间表中，L公司的Orcale系统从中间表中获取数据并呈现给业务人员。
L公司需要根据收到的DELFOR交付计划向STIHL回复DESADV发货通知，同样的需要将数据存放至数据库中间表中，EDI系统将会从中间表中获取数据，并按照STIHL提供的EDI规范文档，将发货通知数据转换为符合STIHL要求的DESADV发货通知报文。再通过SFTP发送给STIHL。
DELFOR物料需求计划
L公司需要接收并验证来自STIHL的DELFOR物料需求计划主要会涉及到在一条交付计划中的一个物料包含多个交期的情况，此外我们的实施顾问根据以往的项目经验，在进行报文映射的过程中也将多物料的情况考虑在内。完成DELFOR物料需计划的实施与测试需要注意以下问题：
1.收货地址
在其他EDI项目中，物料需求计划中的收货地址通常会与发货地址、托运人等信息一起放在报文头部位置，并不会出现多个。但在本次对接STIHL的项目中，收货地址位于物料信息中，这中位置的变化意味着收货地址会和物料信息一起出现多次，并且不同的物料会有不同的收货地。
2.累计数量不一定按照自然年
通常情况下，DELFOR中的累计数量会以自然年为单位，但在STIHL EDI项目中，会出现重置日期的情况，因此还需要填写上次重置日期后累计数量。
3.报文循环的节点
DELFOR报文中交付计划承诺级别代码存放在SCC字段，分别有三种代码：
2 = Production release
3 = Material procurement release
4 = Preview without go-ahead
根据STIHL提供的规范文档，在SCC循环下的节点QTY会出现多次，也需要做循环。因此在处理映射关系时需要注意以最小单位循环，否则输出结果将会缺失数据。
在上述示例中可以看到，交付计划基本不同，物料需求预测的交期也会有所不同，可能是一个具体日期，也可能会给出一个时间范围，包含起始日期和结束日期。
DESADV 发货通知
1.包装方式
根据STIHL提供的EDI规范资料，发货采取单层包装，DESADV发货通知报文中只出现了散箱的情况，可能会出现箱子中只有一种物料以及多种物料的情况。
2.STIHL通过EDI收到DESADV发货通知后，需要将其解析进自己的业务系统，在此沟通过程中遇到了一些EDI规范中没有提及的注意事项：
- L公司在填写预计到达日期时，需要在计划的预计到达日期的基础上再加7天。
- Bill of Lading 也就是提单号需要为空。
- 运输工具名称需要根据STIHL业务人员的要求进行填写。即TDT字段中，交通运输类型如果为海运（sea freight）则运输工具名称需要填写08；交通运输类型如果为空运（air freight）则运输工具名称需要填写06。
- RFF字段中的交货单号需要填写为L公司的发票号。
3.在填写测试数据时需要注意尽可能按照真实情况填写，所有发送给STIHL的数据都会被仔细核对。在测试过程中，如果企业填写的预计发货时间与STIHL期望的发货日期相差太大，将会被提示错误，超过了STIHL内部设置的Frozen Zone。
EDI项目培训
知行始终鼓励用户进行自主实施，L公司出于对项目成本以及业务发展的考虑，提出希望知行基于本次对接STIHL的项目对其内部相关人员进行培训，期待在后续合作项目中，能够由企业自己的团队来完成EDI项目实施部分。
EDI项目的培训主要针对两个主题展开：根据EDI规范整理Mapping以及在知行之桥EDI系统中完成XMLMap数据映射。
根据EDI规范整理Mapping
由于本次项目中，STIHL提供的EDI规范文档描述的EDI字段信息十分简短，对于初次接触EDI项目的用户而言，想要看懂这样的EDI规范文档难度较大，因此需要借助EDI规范查询平台的帮助，参考国际标准报文规范作为支持和补充（注意，需要选择匹配的版本号，如本次项目中，STIHL使用的规范版本号为D99B）。企业可在知行EDI规范查询平台中查看EDI报文各个字段的详细介绍。
结合STIHL提供的EDI规范文档以及知行EDI规范查询平台，整理Mapping表格，即本次项目中DELFOR交付预测以及DESADV发货通知这两种报文中各个字段的含义与注意事项，作为下一步进行数据映射的参考。
XMLMap 数据映射
XMLMap部分主要实现源XML到目标XML的格式转换，需要基于上一步的Mapping表格来完成。在知行之桥EDI系统中，每种报文都需要一个专门的XMLMap端口来处理数据映射。这里需要注意报文的层级结构，对于需要在报文中出现多次的节点而言，需要进行循环处理。
项目成果
根据上述需求，在知行之桥EDI系统中搭建如下所示的工作流：
上图中的每一个方块即为一个端口，知行之桥EDI系统将不同的功能封装至一个个成熟的功能端口中，实现低代码操作。通过蓝色连接线连接各个功能端口，箭头所指方向即为数据流向，方便用户快速定位问题。
业务流程
业务测试阶段，首先由STIHL发来DELFOR，供应商需要验证是否可以成功解析，然后根据收到的DELFOR回复DESADV，STIHL内部同样实现了EDI系统与业务系统的集成，因此在测试DESADV时，STIHL的业务人员将会根据其业务系统是否能成功处理数据为标准进行验证。因此用户在测试过程中，填写数据需要尽量与生成数据看齐，否则STIHL将会提出报错。通过邮件与STIHL沟通EDI报文中存在问题的内容。
本次对接STIHL的EDI项目进行了两次测试，L公司的业务系统尚未完成字段开发之前，L公司的业务人员手动填写数据进行了DESADV的测试。业务系统完成开发后，实现EDI系统与SAP系统的集成，然后通过SAP系统填写数据，向STIHL发送了一笔测试的发货通知。验证无误后即可沟通上线事宜。
上线流程
- 完成业务测试后，需要准备上线事宜。L公司的业务人员可以通过邮件与STIHL的业务人员沟通上线时间。
- 确认项目可以上线后，需要打开EDI系统中各个端口的自动接收，确保文件能够自动化收发，无需人工手动操作。
- 知行的EDI实施顾问会协助核对检查上线后传输的第一笔DESADV发货通知，确保无误。
如果您希望了解有关EDI对接的相关信息，欢迎交流。
阅读原文