接 OpenText Trading Grid：EDI 报文进来、出去

最后更新 2026-11-01

在 Integration 的 EDI 连接里建连接，把传输方式、主机、用户名和密码或私钥按 OpenText 开户接入包原样填入，检查凭证形态，逐个配交易伙伴映射，再激活。

OpenText Trading Grid 是一个 EDI 平台：您经它与交易伙伴交换 EDI 报文——伙伴的订单报文进来，发货与发票报文再出去。这个连接不在渠道向导里建，而是在 Integration 的 EDI 连接里建；它要填的一切细节——主机、用户名等等——都来自 OpenText 在您开户时给的接入包，没有别的地方可以查这些细节。

OpenText 接入步骤：先备好开户接入包，再建 EDI 连接，再查凭证形态，再配伙伴映射，最后激活。

前置条件#

一个 OpenText Trading Grid 账号，已开户或正在与 OpenText 办理开户。连接细节是开户时一并发放的——不是您自己创建或自己去查的东西。
OpenText 给您账号的开户接入包。主机、用户名，以及本指南要您填的每一个连接细节都在里面。整个配置过程都把它放在手边——某个细节不在包里，就是缺失，办法是问您的 OpenText 开户对接人，而不是自己猜。
一种传输方式，按开户接入包所写：用密码的 SFTP、用私钥的 SFTP，或文件投放（file drop）。用哪种由接入包决定——三种方式后面要填的字段不同，开始填之前先确认自己是哪种。
至少一个您将经 OpenText 交换 EDI 报文的交易伙伴——零售商或其他伙伴。每个伙伴在本指南后面单独配映射，用的是为该伙伴约定的伙伴标识与零售商标识。

拿凭证#

与 OpenText 走开户流程。您的凭证不是在某个自助门户里创建的，也没有别的地方可以查——它们是在开户对接时发放给您的。
收到您账号的开户接入包，在里面找到 SFTP 主机和 SFTP 用户名。两个都按原文原样复制——这些值只来自 OpenText，别处来的主机或用户名不属于您的账号。
找到与您的传输方式对应的密钥材料。接入包写的是用密码的 SFTP，它给的就是 SFTP 密码；写的是用私钥的 SFTP，它给的就是 SFTP 私钥；写的是文件投放（file drop），这个连接就没有密码或私钥要收。
把接入包和密钥材料放在一起保管，并从拿到起就把密码或私钥当秘密对待：存放在安全的地方，不要在普通消息里明文传递，并准备好在下一节里粘贴一次。接入包里本该有的东西缺了，就请 OpenText 开户对接人补齐——不要拿另一个账号或另一个系统的值来凑。

填进 Integration#

打开 Integration → EDI 连接 → 新建连接，选择 OpenText Trading Grid。OpenText 没有渠道向导，所以如果您在渠道或市场列表里找它，那是找错了地方——这个连接和其他 EDI 连接在一起。
传输方式（transport_method）：按开户接入包所写选——用密码的 SFTP 选 sftp_password，用私钥的 SFTP 选 sftp_key，文件投放选 file_drop。这个选择决定下面哪些字段要填，所以必须与接入包一致，而不是挑看起来最省事的那种。
SFTP 主机（sftp_host）：把开户接入包里的主机原样粘贴过来。没有可以凭记忆敲的标准主机——这个值的唯一来源就是接入包，所以请复制不要手敲；包里没有写主机，就停下来问 OpenText 开户对接人，不要自己猜一个。
SFTP 用户名（sftp_username）：粘贴同一份开户接入包里的用户名。它与上面的主机是一套——另一个账号或另一个系统的用户名和它配不上。
SFTP 密码（sftp_password）：仅当传输方式是 sftp_password 时才填。粘贴开户接入包里的密码。它加密存储，保存后永不回显——以后要改，只能用新值替换，不能查看旧值。另外两种方式，这个字段留空。
SFTP 私钥（sftp_private_key）：仅当传输方式是 sftp_key 时才填。把开户接入包里的私钥全文粘贴，完整且不要改动——截短或改过格式的私钥就是另一把钥匙了。它加密存储，保存后永不回显。另外两种方式，这个字段留空。如果您的方式是 file_drop，两个密钥字段都不适用：重要的是传输方式本身与接入包一致。
保存连接，但不要把保存当作终点。下一步先测试，再配交易伙伴映射——凭证齐全但没配伙伴映射的连接，照样放不下任何伙伴的报文。

测试连接#

点测试连接，并按它实际覆盖的范围来读结果。现阶段的检查只看您填的东西形态是否齐全：按您选的方式，它需要的东西是否都在——传输方式本身、主机和用户名、密码方式要的密码、或私钥方式要的私钥。所选方式需要的某样东西缺了，检查就会失败并指出缺的是哪样。如果您选的是 file_drop，检查会报端点待配置一类结果——这种方式没有可供检查到达的服务端端点，所以这个结果是预料之中的，不代表您填错了。无论得到哪种结果，都要清楚它的范围：凭证形态齐全，不等于文件已经能收发了。真正的文件收发，是在 OpenText 开户对接完成时一并开通的，所以这一步只当作表单完整性检查来看；结果出乎意料时，对照下面的常见问题。

配 Mapping / 选模板#

OpenText 的 Mapping 按交易伙伴配，不是整个连接一套设置。每个伙伴登记它为人所知的标识——开户与伙伴设置时为该伙伴约定的伙伴标识和零售商标识——并选该伙伴的模板，这样它进来的订单报文能被认成是这个伙伴的、映射成标准订单，您的发货与发票数据也能映射回该伙伴期望的报文。标识是关键：到来的报文带的标识对不上任何映射，就没法归到正确的伙伴名下，连接的凭证再齐全也没用。逐个伙伴配，用每个伙伴约定的标识原样填——不要把一个伙伴的标识挪给另一个用。

OpenText 报文往返（按交易伙伴）：订单报文进来，发货与发票报文出去。

激活#

表单填完整、打算先启用的每个交易伙伴都配好映射后，激活连接。激活是把这个连接连同它的传输方式和伙伴映射，在 Integration 这一侧投入使用。同样要清楚它的范围：经 OpenText 真正收发文件，是在 OpenText 开户对接完成时一并开通的，所以如果那一侧的开户对接还没完成，已激活的连接暂时还不会承载文件——那是开户对接在收尾，不是您填的东西有毛病。文件交换开通后，先在运行监控 / 日志里逐个伙伴盯头几份报文，确认无误再放手跑。

常见问题#

测试报端点待配置（file drop 方式）

这是文件投放（file drop）方式的预料结果，不代表您填错了什么。这种方式下，检查没有可到达的服务端端点，开户给的端点细节也不是配置成检查能探到的东西——所以检查就如实这么报，而不是放您通过。

不要为了让测试看起来变绿就改传输方式、或编一个主机出来。保持开户接入包所写的传输方式，把交易伙伴映射配完，并向 OpenText 开户对接人确认开户进展到哪一步了——文件收发是在开户对接完成时一并开通的，最初的真实报文到运行监控 / 日志里去核对。

测试失败：所选方式需要的东西缺了一样

表单上的字段还没有凑齐您所选传输方式需要的一整套。常见情况就是简单的缺项：没有主机、没有用户名、选了密码方式但密码字段空着、或选了私钥方式但私钥字段空着。错位也算——比如方式还停在密码方式，却把私钥粘了进来，检查要找的那样东西就不在。

拿表单与开户接入包逐字段对：先传输方式，再主机，再用户名，最后是您的方式用的那一样密钥——sftp_password 用密码、sftp_key 用私钥，都全文粘贴。只补缺的或错位的那一样，保存后重新测试。如果接入包本身就缺某个值，向 OpenText 开户对接人索取，不要从另一个账号借。

凭证形态看着齐全，但文件还不动

表单不一定有什么错。连接测试只检查您所选方式的凭证形态是否齐全——它本身并不建立文件传输。真正的文件收发是在 OpenText 开户对接完成时一并开通的，所以一份检查全过的表单，仍可能停在那个开关之前：连接在这边已经就绪，文件交换还没被打开。

向 OpenText 开户对接人确认您账号的开户对接是否已完成——正是这个完成动作打开文件交换。同时把交易伙伴映射配完，这样开通时这边不再缺任何东西。对接确认完成后，去运行监控 / 日志核对每个伙伴的头几份报文；如果对接已确认完成、文件仍不动，拿连接细节和伙伴标识再与开户接入包逐项对一遍。

某个伙伴的报文落不进来，或落到了错误的伙伴名下

连接可以是齐全的，而某个伙伴的映射没配好。Mapping 按伙伴配，报文按它带的标识归位——为该伙伴约定的伙伴标识和零售商标识。如果该伙伴映射里登记的标识，与它的报文实际带的标识对不上，报文就没有正确的落点：要么根本落不进来，要么被读成恰好对得上的另一个伙伴的。

打开该伙伴的映射，把里面登记的伙伴标识和零售商标识，与开户和伙伴设置时为该伙伴约定的标识逐字对一遍。改这个伙伴的映射——不要动其他伙伴的——保存后，去运行监控 / 日志看该伙伴的下一份报文。后来新增的伙伴，在它第一份报文之前也要同样处理：它自己的标识、它自己的模板，单独核对。