单一窗口数据xml导入接口说明

2017-10-30 21:29 

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

二、 系统环境
支持的操作系统
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部分实际业务导入报文。
报文结构暂定如下,试点期间有可能按需要进行调整。

(一)导入发送报文说明
报文结构

本文地址:https://huaxiangit.com/archives/128
关注我们:请关注一下我们的微信公众号:扫描二维码,公众号:HXSimpleEasy
版权声明:本文为原创文章,版权归 huaxiang 所有,欢迎分享本文,转载请保留出处!

评论已关闭!