一、 概述
此文档用于说明企业通过单一窗口平台自动导入的对接及使用，目前支持的业务有：

二、 系统环境
支持的操作系统
Windows 7, Windows 7 Service Pack 1, Windows Server 2003 Service Pack 2, Windows Server 2008, Windows Server 2008 R2, Windows Server 2008 R2 SP1, Windows Vista Service Pack 1
• Windows Server 2003 SP2
• Windows Vista SP1 或更高版本
• Windows Server 2008（在服务器核心角色上不受支持）
• Windows 7
• Windows Server 2008 R2（在服务器核心角色上不受支持）
• Windows 7 SP1
• Windows Server 2008 R2 SP1
• 支持的体系结构：
• x86
• x64

必备组件：
• Windows Installer 3.1 或更高版本
• Internet Explorer 5.01 或更高版本
• Microsoft .NET Framework 4
https://www.microsoft.com/zh-cn/download/details.aspx?id=17718
• 卡控件——EportIkeySetup_VXXX.exe
下载地址：https://app.singlewindow.cn/cas/login 页面右下角“卡控件下载”，如图所示

三、 文件导入说明
1) 数据交换目录规范

o OutBox: 待发送文件目录
o SentBox:发送完毕的文件
o InBox：
 回执文件
 发送处理结果的说明文件
 校验失败说明文件
o FailBox: 服务端校验失败的文件

说明：
根目录可配置，BizID为业务别名，如货物申报为DEC、舱单为MFT等；
FailBox目录为报文错误、业务逻辑错误而发送失败的文件；因网络、服务或程序引起的失败会留在OutBox目录下进行自动重试。

2) 文件命名规范
目前可以接收.zip文件或.xml文件，其中：当一票报文不包含无纸化随附单据，可直接传输结构化报文（格式为XML文件）；当一票报文中包含无纸化随附单据时，需以ZIP包方式导入，ZIP包中必须包含结构化报文XML文档和对应的所有随附单据（格式为PDF文件）。
企业导入文件时应保证文件名称的唯一性，否则将被覆盖。
• 文件写入过程
a) 先建立.Temp 扩展名的文件进行数据写入；
b) 在数据全部写入完毕后，修改文件名为 .zip或.xml
c) 发送监控程序只处理 .zip或.xml 扩展名的文件
3) 清理规则
• OutBox：文件发送成功移动到SentBox，失败移动到FailBox
• SentBox ：每次客户端启动时清理过期文件，或按照用户设置
• InBox：由企业系统处理
• FailBox：由企业系统处理

四、 接口说明
报文格式:
采用XML格式

字符编码:

报文标准如下：
企业导入客户端使用XML格式作为数据交换文件，分为Head和Data两部分，Head部分用于客户端处理使用的信息，Data部分实际业务导入报文。
报文结构暂定如下，试点期间有可能按需要进行调整。

（一）导入发送报文说明
1) 报文结构
单一窗口客户端导入接口说明
（草稿）
一、 概述
此文档用于说明企业通过单一窗口平台自动导入的对接及使用，目前支持的业务有：

二、 系统环境
支持的操作系统
Windows 7, Windows 7 Service Pack 1, Windows Server 2003 Service Pack 2, Windows Server 2008, Windows Server 2008 R2, Windows Server 2008 R2 SP1, Windows Vista Service Pack 1
• Windows Server 2003 SP2
• Windows Vista SP1 或更高版本
• Windows Server 2008（在服务器核心角色上不受支持）
• Windows 7
• Windows Server 2008 R2（在服务器核心角色上不受支持）
• Windows 7 SP1
• Windows Server 2008 R2 SP1
• 支持的体系结构：
• x86
• x64

必备组件：
• Windows Installer 3.1 或更高版本
• Internet Explorer 5.01 或更高版本
• Microsoft .NET Framework 4
https://www.microsoft.com/zh-cn/download/details.aspx?id=17718
• 卡控件——EportIkeySetup_VXXX.exe
下载地址：https://app.singlewindow.cn/cas/login 页面右下角“卡控件下载”，如图所示

三、 文件导入说明
1) 数据交换目录规范

o OutBox: 待发送文件目录
o SentBox:发送完毕的文件
o InBox：
 回执文件
 发送处理结果的说明文件
 校验失败说明文件
o FailBox: 服务端校验失败的文件

说明：
根目录可配置，BizID为业务别名，如货物申报为DEC、舱单为MFT等；
FailBox目录为报文错误、业务逻辑错误而发送失败的文件；因网络、服务或程序引起的失败会留在OutBox目录下进行自动重试。

2) 文件命名规范
目前可以接收.zip文件或.xml文件，其中：当一票报文不包含无纸化随附单据，可直接传输结构化报文（格式为XML文件）；当一票报文中包含无纸化随附单据时，需以ZIP包方式导入，ZIP包中必须包含结构化报文XML文档和对应的所有随附单据（格式为PDF文件）。
企业导入文件时应保证文件名称的唯一性，否则将被覆盖。
• 文件写入过程
a) 先建立.Temp 扩展名的文件进行数据写入；
b) 在数据全部写入完毕后，修改文件名为 .zip或.xml
c) 发送监控程序只处理 .zip或.xml 扩展名的文件
3) 清理规则
• OutBox：文件发送成功移动到SentBox，失败移动到FailBox
• SentBox ：每次客户端启动时清理过期文件，或按照用户设置
• InBox：由企业系统处理
• FailBox：由企业系统处理

四、 接口说明
报文格式:
采用XML格式

字符编码:

报文标准如下：
企业导入客户端使用XML格式作为数据交换文件，分为Head和Data两部分，Head部分用于客户端处理使用的信息，Data部分实际业务导入报文。
报文结构暂定如下，试点期间有可能按需要进行调整。

（一）导入发送报文说明
报文结构