本文将介绍与HD Supply进行EDI对接，通过调用知行之桥的Admin API及JSON格式来集成业务系统。

准备下载和运行

HD Supply EDI 到 JSON

使用 JSON 生成一系列 EDI 文档与 HD Supply 通信。

下载工作流  下载示例文件 

HD Supply EDI到JSON示例流具有预配置的端口，用于从HD Supply的EDI集成规范转换以下交易集：

1. 850 采购订单
2. 855 采购订单确认
3. 856 发货通知
4. 810 发票
5. 846 库存查询

以下端口构成了流程的核心元素：

1. SFTP 端口：配置HD Supply分配的SFTP Server连接信息，进行数据上传和下载。
2. X12端口：从 XML 生成 EDI 文件或将 EDI 文件转换为 XML 以便进一步处理。
3. XML Map端口：将数据从标准XML 格式转换为JSON结构的XML文件或将数据从JSON结构的XML文件转换为标准XML格式。
4. JSON 端口：从 XML 生成 JSON 文件或将 JSON文件转换为 XML 以便进一步处理。

经过配置，这些端口可以自动将文件从一个端口移动到下一个端口，直到传入的 EDI 文件被转换为JSON文件， 最终被业务系统调用知行之桥的API接口进行读取；或者将业务系统调用知行之桥API接口推送的JSON文件转换为可发出的 EDI 文件。 可以在其“自动化”选项卡中修改每个端口的自动化设置，或者可以使用端口“输入”选项卡中的“发送”按钮手动处理工作流中的每个步骤。

如果你想在你的工作区中使用此示例流程，请按照以下说明操作：

如何在知行之桥 EDI 系统中部署上述工作流？

创建工作区

首先，运行知行之桥EDI系统，导航到工作流选项卡并单击右上角的齿轮图标。 选择创建工作区选项为此示例流创建一个新的工作区HDSupply。

导入工作区

然后，从同一个齿轮下拉菜单中，单击导入工作区。 在出现的对话框中，选择下载的示例流 HDSupply.arcflow 以导入相关的端口和设置。

导入后便可在HD Supply查看示例工作流：

成功导入示例流后，你可以开始配置端口以最适合你的特定用例。

SFTP端口

导航到 HDS_SFTP 端口的设置选项卡。 根据HD Supply提供的SFTP Server信息进行配置，你必须输入配置HD Supply的远程主机地址、端口、用户、密码、上传远程目录、下载远程目录。 配置完成后点击“连接测试”按钮，连接测试成功就可以进行数据的上传和下载了。

X12端口

导航到HDS_XMLToX12端口的设置选项卡。 检查交换设置并确保以下部分包含正确的信息：
发送方 ID 限定符（ISA05）
发送方 ID（ISA06）
接收方 ID 限定符（ISA07）
接收方 ID（ISA08）

导航到HDS_XMLToX12端口的高级设置选项卡检查传出文档的功能组设置
确保以下段包含正确的信息：
发送方 ID（GS02）
接收方 ID（GS03）

由于输出的文档是从供应商发送到HD Supply的，因此值YOUREDIID被预先配置为发送方ID，HDSEDIID被预先配置为接收方ID。

检查传入文档的交换和功能组设置
导航到HDS_X12ToXML端口的设置选项卡。 遵循与处理传出文档相同的过程，不同之处在于此端口转换从HD Supply发送到供应商的文档，值HDSEDIID被预先配置为发送方ID， YOUREDIID被预先配置为接收方ID。

知行之桥API接口

从知行之桥获取数据

接口信息

EDI API接口格式：
http://IP或域名:端口/api.rsc/files/
user：user
authtoken:token

一、获取文件名

(1) 请求方式： GET
(2) 请求URL： http://IP或域名:端口/api.rsc/files/
(3) 请求格式：
{
“WorkspaceId”: “HDSupply”,
“ConnectorId”: “HDS_850ToJSON”,
“Folder”: “Receive”
}

二、获取文件内容

(1) 请求方式： GET
(2) 请求URL： http://IP或域名:端口/api.rsc/files/
(3) 请求格式：
http://IP或域名:端口/api.rsc/files(WorkspaceId=’HDSupply’,ConnectorId=’HDS_850ToJSON’,Folder=’Receive’,Filename=’850_TEST.json’)

调用测试

可以借用Postman或者其他工具进行测试

获取文件名

获取文件内容
 

注：获取的Content内容是base64 加密后的数据，需要进行解密

推送数据到知行之桥

接口信息

EDI API接口格式：
http://IP或域名:端口/api.rsc/files/
user：user
authtoken:token

(1) 请求方式： POST
(2) 请求URL： http://IP或域名:端口/api.rsc/files/
(3) 请求格式：
{
“Filename”: “报文代码_[ timestamp].json”,
“Folder”: “Send”,
“WorkspaceId”: “HDSupply”,
“PortId”: “端口ID”,
“MessageId”: “”,
“Content”: “”
}
(4) Content
注：Content内容必须是按照规定格式，base64 加密后的数据。

调用测试

收到200 OK 表示接口调用成功，数据上传成功，可以在知行之桥对应端口查看

跟踪每份文件

850 采购订单

要测试这部分工作流的功能，你可以使用示例文件TEST_850.x12。导航到 HDS_X12ToXML端口的输入选项卡，选择示例文件并单击发送以触发工作流。 然后处理该文件并将其发送到 HDS_850_IN端口、HDS_850ToJSON端口，您可以导航到HDS_850ToJSON端口的输出选项卡查看生成的850 JSON文件。

### 855 采购订单确认

要测试这部分工作流的功能，你可以调用知行之桥API接口，将JSON数据推送到HDS_JSONTo855端口的Send目录下，或者直接使用示例文件TEST_855.json，导航到 HDS_855_OUT端口的输入选项卡，选择示例文件并单击发送以触发工作流，文件将经过HDS_XMLToX12端口，最后传递到HDS_SFTP端口发送给HD Supply，您可以导航到HDS_SFTP端口的输入选项卡查看生成的855 EDI文件。

856 发货通知

要测试这部分工作流的功能，你可以调用知行之桥API接口，将JSON数据推送到HDS_JSONTo856端口的Send目录下，或者直接使用示例文件TEST_856.json，导航到 HDS_856_OUT端口的输入选项卡，选择示例文件并单击发送以触发工作流，文件将经过HDS_XMLToX12端口，最后传递到HDS_SFTP端口发送给HD Supply，您可以导航到HDS_SFTP端口的输入选项卡查看生成的856 EDI文件。

810 发票

要测试这部分工作流的功能，你可以调用知行之桥API接口，将JSON数据推送到HDS_JSONTo810端口的Send目录下，或者直接使用示例文件TEST_810.json，导航到 HDS_810_OUT端口的输入选项卡，选择示例文件并单击发送以触发工作流，文件将经过HDS_XMLToX12端口，最后传递到HDS_SFTP端口发送给HD Supply，您可以导航到HDS_SFTP端口的输入选项卡查看生成的810 EDI文件。

846 库存报告

要测试这部分工作流的功能，你可以调用知行之桥API接口，将JSON数据推送到HDS_JSONTo846端口的Send目录下，或者直接使用示例文件TEST_846.json，导航到 HDS_846_OUT端口的输入选项卡，选择示例文件并单击发送以触发工作流，文件将经过HDS_XMLToX12端口，最后传递到HDS_SFTP端口发送给HD Supply，您可以导航到HDS_SFTP端口的输入选项卡查看生成的846 EDI文件。

_*你启动并运行了吗？*_

如果答案是肯定的，那么恭喜你成功地配置了 HD Supply EDI 到 JSON 方案示例工作流！

阅读原文