OFTP 端口操作手册
通过简单的界面配置用户即可使用 OFTP 端口与交易伙伴建立连接实现安全、可靠的数据传输。具体配置可按照以下四个步骤完成明确双方的 OFTP 配置信息配置你的 OFTP 信息配置交易伙伴的 OFTP 信息测试文件发送与接收明确你和交易伙伴的 OFTP 配置信息在与交易伙伴建立 EDI 连接之前需要先确认双方的 OFTP 配置信息完整且准确。常见的配置信息包括 SSID Code、Password、连接地址、端口、OFTP 版本及证书等。如下图所示OFTP 配置信息表分别列出了你和交易伙伴的配置内容便于双方核对并完成后续连接配置。注以下操作基于知行之桥EDI系统V2026版配置你的 OFTP 信息针对不同的 OFTP 应用场景OFTP 端口提供了多种可选配置。在常见的数据传输场景中通常只需完成以下五项配置即可建立 OFTP 连接并与交易伙伴交换数据ODETTE IDSSID你的 SSID 身份标识符密码与你的 SSID 对应的密码端口用于接收 OFTP 数据的通信端口私钥证书用于身份认证、签名或加密的私钥证书私钥证书密码用于访问私钥证书的密码在知行之桥 EDI 系统左侧菜单栏中选择个人设置进入服务/OFTP板块然后点击配置按钮填写你的 OFTP 信息。其中ODETTE IDSSID是企业在 OFTP 数据传输过程中的身份标识用于区分不同的传输主体。该标识通常对应一家企业也可以根据实际业务需要对应企业下属的工厂或部门。添加 OFTP 个人设置1) ODETTE IDSSID你的 SSID 身份标识符ODETTE IDSSID用于标识你在 OFTP 数据传输过程中的身份类似于电子邮件中的发件人名称。在本测试示例中ODETTE IDSSID设置为 My_OFTP_ID。在实际业务中标准化做法是申请 OdetteID通常也是可以自定义的对数据传输规范要求较高的企业也可以向 ODETTE 组织付费申请正式的 ODETTE ID。该标识通常包含国家代码、组织代码等信息交易伙伴可通过该标识识别你身份并处理 OFTP 连接请求。配置 OFTP 连接前通信双方需要将各自的 ODETTE IDSSID提供给对方。2) 密码你的 SSID 密码该密码用于验证你的 SSID 身份。交易伙伴连接你的 OFTP 服务时需要通过 SSID 和对应密码完成身份验证。在与交易伙伴交换配置信息时需要双方将各自的密码信息提供给对方。3) 端口你的数据接收端口在服务器配置中设置用于监听交易伙伴 OFTP 连接请求的端口。系统默认启用 SSL如不需要使用 SSL可在配置页面中取消勾选。本示例使用端口 6619。如果知行之桥部署在企业内网中还需要根据网络环境完成端口映射确保交易伙伴能够访问该端口。4) 私钥证书你的私钥证书私钥证书用于保障 OFTP 数据传输过程的安全性和可靠性。发送文件时系统可以使用你私钥证书对文件进行签名接收交易伙伴发送的加密文件时系统可以使用你私钥证书进行解密。OFTP 端口支持 PKCS#12 标准的私钥证书文件文件后缀通常为 .pfx 或 .p12。在实际业务中建议导入由商业证书颁发机构Certificate AuthorityCA签发的私钥证书。在测试或特定应用场景中也可以点击界面中的 创建证书生成自签名证书以满足身份认证、签名及加密等安全传输需求。在EDI系统“个人证书”选项卡下点击私钥证书下方的空白栏位即可看到创建证书的选项点击即可进入创建私钥证书的页面根据页面提示填写信息即可创建私钥证书。系统会在.pfx私钥证书文件的目录中同时生成一个后缀名为.cer的证书文件你的公钥证书请将这个后缀为.cer的公钥证书文件提供给你的交易伙伴。5) 私钥证书密码你的私钥证书密码你的私钥证书密码在证书创建过程中设置注意保存和保密。以上配置完成后将会跳转至以下页面配置交易伙伴的 OFTP 信息选择工作流菜单进入 Default 工作区创建并配置用于连接交易伙伴 EDI 系统的 OFTP 端口。在工作流页面中央的搜索栏中输入 OFTP找到 OFTP 端口后点击 添加。在弹出的窗口中设置 端口 ID建议使用交易伙伴的英文名称或中文名称拼音进行命名例如 PartnerName_OFTP便于后续识别和管理。完成命名后点击弹窗底部的 创建端口即可完成 OFTP 端口的创建。点击已创建的 OFTP 端口右侧将显示端口配置界面。选择 设置 页签填写交易伙伴的 OFTP 配置信息。OFTP 端口提供了多项配置其中大多数为可选项。在常见应用场景中通常只需完成以下五项配置ODETTE ID(SSID)交易伙伴的SSID身份标识符密码交易伙伴的SSID密码版本双方约定使用的 OFTP 协议版本远程主机地址交易伙伴提供的 OFTP 服务器地址端口交易伙伴用于接收 OFTP 数据的通信端口1) ODETTE ID交易伙伴的 SSID 身份标识符ODETTE IDSSID用于标识交易伙伴在 OFTP 数据传输过程中的身份。配置连接前需要由交易伙伴提供其 ODETTE IDSSID并将其填写到对应配置项中。2) 密码交易伙伴的 SSID 密码填写交易伙伴提供的 SSID 密码。系统将通过 ODETTE IDSSID和对应密码验证交易伙伴的身份。3) 版本OFTP协议版本选择你与交易伙伴进行数据传输时使用的 OFTP 协议版本。双方配置的协议版本需要保持一致。如需使用 SSL、数据加密、数字签名等安全功能通常需要选择 OFTP 2.0 或更高版本。4) 远程主机地址交易伙伴的主机地址填写交易伙伴提供的 OFTP 服务器地址。在进行数据传输时系统将通过该地址连接交易伙伴的 OFTP 服务。远程主机地址通常应保持固定并且能够通过公网或双方约定的网络环境正常访问。5) 端口交易伙伴的数据接收端口填写交易伙伴用于接收 OFTP 数据的通信端口。你的系统将通过远程主机地址和该端口与交易伙伴建立连接并发送数据。配置前需要确认该端口可通过公网或双方约定的网络环境正常访问。6) 交易伙伴证书导入交易伙伴提供的公钥证书。该证书可用于验证交易伙伴的身份、校验其数字签名或对发送给交易伙伴的数据进行加密。测试发送接收文件完成你与交易伙伴的 OFTP 信息配置后还需要确认交易伙伴已在其 EDI 系统中完成对应的 OFTP 配置。双方配置完成后可以互相发送测试文件验证 OFTP 连接是否成功建立。测试发送文件给交易伙伴交易伙伴 OFTP 端口的 事务 页签会显示发送给交易伙伴的文件记录包括待发送、发送成功及发送失败的文件。你也可以在该页签中创建或上传需要发送的文件。点击 添加文件 → 添加测试文件系统会自动生成多个默认测试文件。OFTP 端口默认启用自动执行模式。你可以根据测试需要在 自动化 页签中开启或暂停自动模式。启用自动模式后系统会自动发送当前所有未发送的文件暂停自动模式后你也可以手动选择部分或全部未发送文件点击 发送 按钮测试是否能够通过 OFTP 成功向交易伙伴传输数据。文件发送成功后状态会从”未发送”变为”成功”。如果文件发送失败系统会根据具体原因将状态显示为 错误、警告 等可根据提示进一步排查连接或配置问题。测试接收交易伙伴发出的文件OFTP 支持双向数据传输。完成向交易伙伴发送测试文件并确认发送成功后还需要请交易伙伴向你发送测试文件。随后在你的 EDI 系统中查看文件接收记录确认是否能够成功接收并处理交易伙伴发送的数据。只有双方均能正常发送和接收文件才能说明 OFTP 连接已成功建立。文件传输日志每次文件传输完成后都可以在 事务 页签中查看对应的传输状态文件传输成功时界面会显示绿色的 成功 状态消息。文件传输失败时界面会显示红色的 错误 状态消息。最新的传输日志会同步更新到文件列表中便于查看本次传输的处理结果。你还可以通过以下方式查看更详细的信息点击文件左侧的 “” 图标展开该文件的传输日志详情。文件发送和接收是两个独立运行的流程需要分别确认发送测试和接收测试均能成功完成。将鼠标悬停在需要查看的文件记录上点击右侧的 省略号然后选择 查看消息详情。系统会自动跳转到该消息的日志页面。在这里可以查看当前消息的 文档内容、详细信息和处理日志用于进一步确认传输结果或排查错误原因。关于自动化设置OFTP 端口默认启用自动执行模式你可以根据实际需要在 自动化 页签中开启或暂停该模式。为应对文件自动发送过程中可能出现的临时性错误还可以在交易伙伴 OFTP 端口的 自动化 页签中配置 发送重试。启用后当文件因网络波动、连接超时等临时问题发送失败时EDI 系统会按照设定的重试规则自动重新发送无需用户手动干预从而提高文件传输的稳定性和成功率。勾选 发送 后系统会自动将 OFTP 端口目录中的待发送文件传输给交易伙伴。重试间隔分钟当文件发送失败时系统再次尝试发送前的等待时间默认为 60 分钟。最大次数单个文件发送失败后系统允许自动重试的最大次数默认为 5 次。当文件因网络波动、交易伙伴服务器暂时不可用或连接超时等原因发送失败时系统会按照设置的重试间隔和最大次数自动重新发送无需用户手动操作。扩展阅读1OFTP 常见隐性难题解析扩展阅读2OFTP 虚拟文件名设置