OFTP Connector


通过简单的界面配置,用户就可以使用OFTP Connector和交易伙伴建立OFTP连接,实现安全可靠的数据传输。详细配置,请您参考以下三个步骤:

  1. 明确您和交易伙伴的OFTP配置信息
  2. 配置您的OFTP信息
  3. 配置交易伙伴的OFTP信息
  4. 测试发送&接收文件

明确您和交易伙伴的OFTP配置信息

在您与交易伙伴建立EDI连接之前,您需要先确认双方的OFTP配置信息完备且正确。通常我们需要具备的OFTP配置信息包含:SSID Code、Password等。如图是一个OFTP配置信息表,其中包含”您”和”交易伙伴”OFTP配置信息。


配置您的OFTP信息

在页面顶端选择“PROFILE”菜单项,进入“OFTP Profile”页签。在这里,配置您的OFTP信息,作为您在OFTP传输过程中的唯一身份标识,用以区别OFTP传输过程中不同的传输个体(通常指代企业或是其下工厂、部门)。

应对于不同的OFTP应用场景需求,OFTP Connector提供了诸多可选择配置的项。常见的应用场景中,但您通常只需配置以下五项,就可以完成OFTP配置,和交易伙伴进行数据交换。

  1. SSID Code(您的SSID身份标识符)
  2. Password(您的SSID密码)
  3. Port(您的数据接收端口)
  4. Private Certificate(您的私钥证书)
  5. Certificate Password(您的私钥证书密码)

1) SSID Code(您的SSID身份标识符):SSID Code作为OFTP数据传输中您的身份标识符,类似于电子邮件通讯中的发件人姓名。更多

  • 此测试示例中SSID Code设置为”My_OFTP_ID”,在实际业务应用中,请赋予SSID Code具有实际意义的标识名,如公司名称、工厂名称、部门名称等。
  • 在传输要求较高的情境下,通信双方还可以去ODETTE组织有偿的获取SSID Code授权。SSID Code可能会包含国家代码、组织代码等,交易伙伴使用SSID Code能加载您的其他相关信息,并处理OFTP请求。
  • 在与交易伙伴进行OFTP连接配置时,需要通信双方将自己的SSID Code提供给对方。

2) Password(您的SSID密码):用来验证您SSID Code身份的密码。更多

  • 在与交易伙伴交换配置信息时,需要双方将各自的Password信息提供给对方。

3) Port(您的数据接收端口):交易伙伴通过Port与您的OFTP Connector,默认使用SSL,端口为6619(注:需要做端口映射)。

4) Private Certificate(您的私钥证书):私钥证书能保障数据传输过程安全可靠。在您发送数据给交易伙伴时,系统会用您的私钥证书签名发出的文件,相反的,在您收到交易伙伴发送的文件时,系统会用您的私钥证书解密接收到的文件。OFTP Connector支持PKCS#12标准的私钥证书文件,后缀名为.pfx或.p12。更多

  • 系统默认安装时有一对匹配的证书,分别是名为”test.cer”的公钥证书和名为”test.pfx”的私钥证书。本地测试中,您可以将他们作为自己的公钥和私钥证书使用。在实际业务应用中,请导入您从商用的凭证管理中心(Certificate Authority)授权的私钥证书,或是点击界面中”Create Certificate”选项创建一个自签名证书,以确保数传输的安全性。
  • 通过EDI系统”Create Certificate”选项创建个人证书,系统会在.pfx私钥证书文件的目录中同时生成一个后缀名为.cer的证书文件(您的公钥证书),请将这个后缀为.cer的公钥证书文件提供给您的交易伙伴。

5) Certificate Password(您的私钥证书密码):您的私钥证书密码,在证书创建过程中设置,注意保存和保密。


配置交易伙伴的OFTP信息

选择“FLOWS”菜单项,查看或配置用于连接交易伙伴EDI系统的OFTP Connector。左侧”Connectors”页签列出了系统默认安装的不同类型的Connector,左键单击名称为”OFTP″的Connector并向右侧空白区域拖动,弹出”Add Port”窗口,以交易伙伴英文名称或是中文拼音命名”Port Id”,如”PartnerName_OFTP″,点击”Create Port”完成创建。

右侧出现Connector的配置界面,选择”Settings”页签,完善交易伙伴的OFTP配置信息。其中多数配置项都是可选的,通常只需配置以下五项。

  1. Port Id(连接交易伙伴的OFTP Connector名称)
  2. SSID Code(交易伙伴的SSID身份标识符)
  3. Password(交易伙伴的SSID密码)
  4. Version(OFTP协议版本)
  5. Remote Host(交易伙伴的主机地址)
  6. Port(交易伙伴的数据接收端口)


1) Port Id(连接交易伙伴的OFTP Connector名称):交易伙伴SSID Code通常是由字母及数字组成的字符串,对于您来讲,难以直观地区分不同的交易伙伴OFTP Connector。在这个配置项下您可以自定义交易伙伴的Port Id,以便于您区别不同的交易伙伴。更多

  • 连接交易伙伴的OFTP Connector的名称设置为”PartnerName_OFTP″,系统中唯一存在,不能重复。

2) SSID Code(交易伙伴的SSID身份标识符):作为OFTP数据传输过程中交易伙伴的身份标识,交易伙伴需将他的SSID Code提供给您。

3) Password(交易伙伴的SSID密码):交易伙伴的SSID密码。

4) Version(OFTP协议版本):您与交易伙伴进行OFTP数据传输过程中使用的OFTP协议版本。更多

  • 对于SSL或是其他的连接安全选项,如加密和签名,需要OFTP2.0或更高版本。

5) Remote Host(交易伙伴的主机地址):在进行OFTP数据传输时,每位交易伙伴必须拥有唯一且固定的远程主机地址。更多

  • 您可以通过公网访问到交易伙伴的这台远程主机地址,进行数据传输。

6) Port(交易伙伴的数据接收端口):您通过公网可以访问到交易伙伴的该端口,交易伙伴通过此端口接收您发送的数据。


测试发送&接收文件

在您的EDI系统配置完您和交易伙伴的OFTP信息后,同时,交易伙伴在他的EDI系统也进行了同样的OFTP配置操作后。您和交易伙伴开始尝试向对方发送测试文件,检查OFTP连接是否成功建立。

测试发送文件给交易伙伴

交易伙伴OFTP Connector的”Input”页签显示待发送或是已发送(成功&失败)给交易伙伴的文件传输记录,同时,您也可以在”Input”页签下创建或是上传需要发出的文件。点击”Input”->”More”->”Create Test Files”,系统会生成几个默认的测试文件。

OFTP Connector默认情况下是自动执行的,您可以根据测试需要在”Automation”页签进行设置,开启或是暂停自动模式。系统自动发送当前所有未发送的文件或是您手动选择需要发送的部分(或所有未发送的)文件并点击”Send”按钮,测试OFTP是否能成功发送数据给交易伙伴。更多

  • 文件发送成功,文件处理状态会从”Unsent”变为”Sent”。
  • 文件未成功发送,根据错误原因不同,文件状态通常会显示为”Send Error”, “Send Error”, “Send Warning”, “MDN Error”等。

测试接收交易伙伴发出的文件

OFTP数据传输是双向的,在以上步骤中,成功发出文件给交易伙伴后,您也需要让交易伙伴发送文件给您,同时,在您的EDI系统”Output”查看是否成功收到交易伙伴发出的文件。

文件传输日志
每次数据传输完成后,您可以在”Input”和”OutPut”页签查看文件的传输状态。如果文件传输成功,可以看到界面弹出绿色的”成功状态消息”,反之,会看到红色的”错误状态消息”。同时,最新的传输日志内容会被更新在文件列表中。更多

  • 点击“+”加号图标,展开传输日志详情。
  • 发送和接收文件是独立运行的,您需要分别确认发送和接收文件都可以成功运行。
  • 点击日志文件链接,可以从浏览器直接下载文件。


关于Automation设置
默认情况下是自动执行的,您可以根据需要在”Automation”页签进行设置,开启或是暂停自动模式。为了应对数据自动发送过程中出现的错误,您可以在交易伙伴OFTP Connector中”Automation”页签设置发送重试设置,使EDI系统在无用户干预的情况下应对传输过程中暂时性的错误。

  • 勾选”Send”,系统会自动将OFTP Connector中目录下的文件发送至交易伙伴。
  • Retry Interval (minutes): 文件发送失败,重新发送间隔时长(分钟),系统默认为60分钟。
  • Retry Maximum Attempts: 文件重新发送最大尝试次数,系统默认为5次。更多
    • 在一次数据发送过程中,交易伙伴发送的response中缺少200 OK,则表示交易伙伴接收文件失败。
    • 文件接收失败可能是由于交易伙伴Server的暂时性错误造成的。
    • 系统默认间隔时长为60分钟,最大尝试次数为5次。

  • Resend Interval (minutes): 接收交易伙伴异步MDN回执超时间隔时长(分钟),系统默认为10分钟。一旦异步MDN Pending Timeout,该文件会被立即重发。
  • Resend Maximum Attempts: 接收交易伙伴MDN回执超时,重新发送文件最大尝试次数,系统默认为5次。更多
    • 在一次数据发送过程中,接收交易伙伴异步MDN回执超时,系统会自动重发文件。
    • 系统默认间隔时长为10分钟,最大尝试次数为5次。

了解更多,请您电话 150-0298-3180 / 177-8250-8152 或邮件 edi@kasoftware.cn 联系我们。