全国会计从业人员信息管理系统接口规范_第1页
全国会计从业人员信息管理系统接口规范_第2页
全国会计从业人员信息管理系统接口规范_第3页
全国会计从业人员信息管理系统接口规范_第4页
全国会计从业人员信息管理系统接口规范_第5页
已阅读5页,还剩69页未读, 继续免费阅读

付费下载

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

页概述规范概述根据财政部关于全国统一的、科学的会计人员数据信息管理平台的相关要求,制定本规范。本规范是会计信息平台系列规范中的一个,是描述地方会计人员信息系统上报人员数据至财政部会计从业人员统一数据平台及会计从业人员跨省调转数据交换的规范性文档.本规范主要供以下几类技术人员阅读使用:全国会计从业人员信息管理系统的设计及开发人员全国省级和中央有关部门会计人员系统涉及数据上报业务的设计及开发人员全国省级和中央有关部门会计人员系统涉及会计人员跨省调转业务的设计及开发人员术语解释全国会计从业人员信息管理系统由财政部主持建设,包含全国会计从业人员基本信息的科学高效的管理平台.地方会计从业人员信息系统各省、自治区、直辖市、计划单列市、中央会计从业资格管理部门自行建设的会计人员信息管理系统。地方会计人员数据上报根据财政部要求,地方会计人员信息系统管理人员需要定期将地方会计从业人员变动信息同步至全国会计从业人员信息管理系统.会计人员跨省调转根据财政部要求,地方会计从业人员跨省调转信息需要通过会计从业人员跨省调转平台调转到其他地方,跨省调转平台用来存储需要调转的会计从业人员的数据信息.XML文件用具有数据描述功能、调试结构性及可验证性的可扩展标记语言描述的数据文件。规范导读规范导读是对本规范内容的简要介绍,它对每部分的内容进行了概括性的说明,能够帮助读者更好的把握本规范的脉络与关键内容。第一章主要说明规范的背景和相关的术语介绍,为下文具体说明铺平道路。第二章介绍了使用本规范的业务流程,通过了解这些能够使读者更清楚规范的必要性.第三章从数据的角度介绍了本规范需要接口约束的数据内容。第四章介绍了接口规范的具体文件内容格式及相关细节.第五章从全局角度描述了本规范的一些基本约束,主要针对数据内容、文件结构、参数规则、数据校验等方面说明。第六章介绍了数据传输的完整性和安全性问题。第七章是远程调用接口支持,介绍了本接口规范对远程接口调用的支持情况.第八章是接口规范补充说明,对除基本接口规范以外的涉及到带格式的数据进行必要的补充说明。第九章是附录信息,其中包括一些数据字段的代码表等。接口规范相关业务简介地方会计人员数据上报业务流程业务流程图业务流程说明各地方会计人员系统通过各系统自身提供的自动(或人工)数据导出与上报功能,定期生成并导出符合本规范格式要求的会计人员从业数据文件,并放置到财政部为各部门(单位)事先分配好的FTP服务器指定临时上传目录下,等待财政部“数据上传服务”定时自动处理。各地方系统操作人员也可以登录财政部“全国会计人员信息管理系统”,对已经放置在FTP临时上传目录中,财政部“数据上传服务”尚未进行扫描处理的数据文件,进行手动处理。交互的数据内容地方会计人员管理系统和全国会计从业人员信息管理系统交互的是会计人员变更数据,这些变更数据来源于地方系统,根据同步频率的设定,地方系统自动(或人工)按某一时间间隔将会计人员的变更数据从本地导出,然后放置到FTP服务器中,接下来全国会计从业人员信息管理系统就会接管FTP服务器中文件的处理工作。会计人员跨省调转正常调转业务流程图业务流程说明调出会计人员应到调出地的财政部门办理调出手续时,调出地的财政部门(区县若无法连接财政内网进行调转,可由上级单位办理调转,上级代下级进行调转时对过程不做审批)使用本地的会计人员管理系统导出标准的调出人员数据。调出地的财政部门登录调转平台,将导出的调出会计人员数据上传,选择(或修改)会计人员调入地,后进行信息保存.确认信息无误后,发出调转要约。凡调入的会计人员应持相关资料到调入地的财政部门办理调入手续时,调入地的财政部门登录调转平台,查询并核对调入会计人员数据,确认无误后,在调转平台上对调入会计人员进行确认,并将数据导入本地会计人员管理系统。此后,本次人员调转工作正式完成。调转完成之后,调出的地方系统对该已调出人员的后续处理可以通过手工或自动方式进行。交互的数据内容正常调转交互的数据为调出会计人员的全部数据信息.这些数据来源于调出地,调出地系统生成的数据必须符合跨省调转接口规范,同时调入地也必须实现跨省调转接口规范来完成调入地会计从业人员数据的导入。调转超期业务流程图业务流程说明ﻩﻩ调转超期指的是在指定的时间(90天)调转流程没有正确完成。没有正确完成的调出记录系统会自动将这些会计人员设置为调转超期.当调出地业务人员再次登录调转平台发现调转超期的会计人员时,应该手工将本地系统的这些会计人员信息恢复为原始状态,或地方系统自动获取调转平台人员状态信息将本地人员信息恢复为未调转状态。交互的数据内容交互的数据和正常调转相同,是调出会计人员的全部数据信息.二次调转业务流程图业务流程说明二次调转指的是在合法的调转期限内,调转目的地发生了变更,这样的调转称为二次调转。只有处于待调转状态的会计人员才能进行撤销后重新选择调入地,其他状态的会计人员数据无法撤销。交互的数据内容交互的数据和正常调转相同,是调出会计人员的数据。接口数据字典以下接口的数据字典来源于发布的人员基础数据要求,但在技术层面增加了需要地方系统在数据上报或调转过程中重点关注的内容。地方会计人员数据上报基础信息序号英文名称字段含义字段长度相关解释关键字1ACNT_ID从业资格证书档案号码30ACNT_ID与ID_NUM共同组成人员关键字Y2NAME姓名30最多可容纳15个汉字3SEX性别1HYPERLINK\o"点击查看"代码类型4BIRTH出生日期8YYYYMMDD5NATION民族2HYPERLINK\l"民族代码”\o"点击查看"代码类型6COUNTRY所属国家或地区1HYPERLINK\l"国家或地区代码"代码类型7ID_TYPE有效身份证件类型1HYPERLINK\l"证件类型代码"代码类型8ID_NUM有效身份证件号码30Y9POLTC_STATUS政治面貌2HYPERLINK\l"政治面貌代码”代码类型10ACNT_WORK_DATE开始从事会计工作时间8YYYYMMDD11FT_EDUCATION全日制最高学历2HYPERLINK\l"学历"代码类型12FT_DEGREE全日制最高学位2HYPERLINK\l”学位”代码类型13FT_EDU_UNIVE全日制最高学历毕业院校100最多可容纳50个汉字14FT_EDU_GDATE全日制最高学历毕业时间8YYYYMMDD15FT_EDU_PRO全日制最高学历所学专业2HYPERLINK\l"所学专业”代码类型16PT_EDUCATION非全日制最高学历2HYPERLINK\l"学历"代码类型17PT_DEGREE非全日制最高学位2HYPERLINK\l"学位”代码类型18PT_DEGREE_DATE非全日制学历(学位)取得时间8YYYYMMDD19PT_DEGREE_UNIVE非全日制学历(学位)授予院校100最多可容纳50个汉字20PT_DEGREE_PRO非全日制学历(学位)所学专业2HYPERLINK\l"所学专业”代码类型21ADMIN_POST会计行政职务2HYPERLINK\l"会计行政职务代码"代码类型22PQ_TYPE专业技术资格类型2HYPERLINK\l”专业技术资格类型代码"代码类型23PQ_LEVEL专业技术资格级别2HYPERLINK\l”专业技术资格级别代码”代码类型24PQ_GET_TYPE专业技术资格取得方式1HYPERLINK\l"专业技术资格证书取得方式代码”代码类型25PQ_GET_DATE专业技术资格取得时间8YYYYMMDD26PQ_CARD_NUM专业技术资格证书号或批文号8027PQ_POST会计专业技术职务1HYPERLINK\l"会计专业技术职务代码"代码类型28PQ_POST_GDATE会计专业技术职务聘任时间8YYYYMMDD29JSC_AUTH_ORG首次从业资格证发证机关100最多可容纳50个汉字30JSC_AUTH_DATE从业资格证发证日期8YYYYMMDD31JSC_REG_DATE从业资格证注册时间8YYYYMMDD32ABACUS_LEVEL珠算等级1HYPERLINK\l"珠算等级代码"代码类型33ABACUS_NUM珠算证号5034MOBILE个人电话(手机)3035EMAIL电子邮箱6036IS_ATWORK是否在岗1HYPERLINK\l”是否在岗代码"代码类型37ORG_FULL_NAME工作单位全称100最多可容纳50个汉字38ORG_TEL工作单位电话2039ORG_ADDRESS工作单位地址200最多可容纳100个汉字40ORG_TYPE工作单位经济类型3HYPERLINK\l”工作单位经济类型代码"代码类型41ACNT_POSITION现从事会计工作岗位3HYPERLINK\l”从事会计工作岗位代码”代码类型42REGION_CODE会计从业资格归属管理机构行政区划将现所在地区改成会计从业资格归属管理机构行政区划(或代码)(或代码)将现所在地区改成会计从业资格归属管理机构行政区划(或代码)6HYPERLINK代码类型6COUNTRY所属国家或地区1HYPERLINK\l"国家或地区代码”代码类型7ID_TYPE有效身份证件类型1HYPERLINK\l”证件类型代码"代码类型8ID_NUM有效身份证件号码30Y9POLTC_STATUS政治面貌2HYPERLINK\l"政治面貌代码"代码类型10ACNT_WORK_DATE开始从事会计工作时间8YYYYMMDD11FT_EDUCATION全日制最高学历2HYPERLINK\l”学历”代码类型12FT_DEGREE全日制最高学位2HYPERLINK代码类型42REGION_CODE会计从业资格归属管理机构行政区划将现所在区划改成会计从业资格归属管理机构行政区划(或代码)(或代码)将现所在区划改成会计从业资格归属管理机构行政区划(或代码)6HYPERLINK\l"行政区划代码"代码类型43IS_CPA是否注册会计师10:否1:是44IS_CPV是否注册评估师10:否1:是45IS_CTA是否注册税务师10:否1:是46IS_HL_TALENT是否高端人才10:否1:是47TALENT_TYPE高端人才类型3HYPERLINK\l"高端人才类型代码”代码类型48TALENT_GET_DATE高端人才资格取得时间8YYYYMMDD49MIGRT_IN_REGION调入地行政区划(代码)6HYPERLINK代码类型5MIGRT_IN_DATE调入时间8YYYYMMDD6MIGRT_IN_REGION调入地行政区划(或代码)6HYPERLINK\l"行政区划代码”代码类型调转人员继续教育信息序号英文名称字段含义字段长度相关解释关键字1ACNT_ID从业资格证书档案号码30ACNT_ID与ID_NUM共同组成人员关键字Y2ID_NUM有效身份证件号码30必须与基础信息中“有效身份证件号码"一致Y3EDU_YEAR继续教育年度4YYYY4PASS_DATE培训/通过时间8YYYYMMDD5EDU_HOURS学时NUM(3,1)数字类型(3位整数,1位小数)6EDU_CREDIT学分NUM(3,1)数字类型(3位整数,1位小数)7PASS_TYPE继续教育通过方式31:继续教育培训,2:视同通过8PASS_REASON课程内容/通过原因255调转人员奖励信息序号英文名称字段含义字段长度相关解释关键字1ACNT_ID从业资格证书档案号码30ACNT_ID与ID_NUM共同组成人员关键字Y2ID_NUM有效身份证件号码30必须与基础信息中“有效身份证件号码”一致Y3REWARD_DATE奖励日期8YYYYMMDD4REWARD_LEVEL奖励级别3HYPERLINKencoding=”UTF-8”?><root>ﻩ<attachments> ﻩ〈!—附件信息,使用附件类型、来自地区、档案号和身份证号区分属主-—〉ﻩﻩ<attachmentid_num=“身份证件号码”acnt_id=“档案号”type=“01”>ﻩBase64编码</attachment><!—其他附件记录—-〉……ﻩ</attachments></root〉数据文件处理规则构造并写入文件根据3.1节的地方会计从业人员数据上报的数据描述及其约束构造文件,列头和列值必须一致,例如列头姓名在第5列,则列记录中的第5列必须存放实际的姓名,其他类推;列头命名要符合数据字典规范.为了控制单个文件的尺寸,写入文件的记录条数不要太大,需要符合5。1.2。3节文件尺寸约束要求。对于字段的数据即使是空值,其字段分隔符也也要加上,空值的表示请参考5.1.4。1节空值约束。将文件传入到FTP服务器将写入完成的文件根据5。1。3.1节的交换文件存储目录约束要求,将一个或者多个文件发送到FTP服务器指定的存储目录中。会计从业人员跨省调转数据规范适用范围本规范适用于各省、自治区、直辖市、计划单列市和中央会计从业资格管理部门本地系统和跨省调转平台之间的数据交换。各省、自治区、直辖市、计划单列市、中央会计从业资格管理部门的本地系统需要实现该接口规范来完成会计从业人员跨省调转数据的导入(会计从业人员调入)和导出(会计从业人员调出)。该规范需要根据业务发展的需要进行逐步调整和完善.数据交互机制会计从业人员跨省调转通过跨省调转平台来实现,其具体过程如下:调出地把需要调转的会计从业人员信息从本地导出为符合接口规范的XML文件;调出地将导出的XML文件上传到跨省调转平台上;调出地登录跨省调转平台,选择调入地并确认调转;调入地登录跨省调转平台,查询需要调入本地的会计从业人员;调入地将审核通过的待调转会计从业人员下载到本地;调入地将下载到本地的数据文件导入到本地系统;调出地根据会计从业人员的调出状态,对其在本地系统进行适当的操作。网络环境各地方使用财政内网,直接访问跨省调转平台,通过HTTP上传和下载调出和调入的会计从业人员数据。数据格式数据文件格式每个文件包含一个会计从业人员的全部信息,包括会计从业人员基础信息、继续教育信息、奖励信息、处罚信息、变更信息、备注信息、调转信息和附件信息(目前只有照片)。文件结构如下所示:其中head段是整个文件的描述信息,accountants是会计从业人员结点,该结点下包含列头描述信息colhead和会计人员数据信息accountant,列头信息和数据信息相对应和数据上报数据格式类似,会计从业人员结点下包含会计从业人员的各项信息,这些信息采用CDATA方式保存,其中是有结构的文本,详细描述见后文描述。文件命名可以参考5.2.2。2节.〈?xmlversion="1.0"encoding=”UTF—8”?>〈root>ﻩﻩ〈!-会计从业人员跨省调转数据文件描述信息—-〉ﻩ<head>ﻩﻩ<operator>形成文件的操作人员</operator>ﻩﻩ<date>文件生成的日期〈/date><count>文件中包含的会计从业人员的个数,目前预留</count〉<filename〉文件的名字</filename〉ﻩ</head>ﻩ<!—会计从业人员跨省调转数据文件会计信息-->ﻩ<accountants〉ﻩﻩ<!—会计从业人员数据对应的列头信息--〉<colhead>ﻩﻩ <accountant—base><![CDATA[基础信息列头]]>〈/accountant—base> ﻩ<accountant-edu><![CDATA[继续教育信息列头]]〉</accountant-edu>ﻩ ﻩ〈accountant-reward><![CDATA[奖励信息列头]]></accountant-reward> ﻩ <accountant—punish〉<![CDATA[奖励信息列头]]〉</accountant-punish〉ﻩ ﻩ<accountant-change〉<![CDATA[信息变更列头]]〉〈/accountant—change>ﻩ ﻩ<accountant—migrate〉〈![CDATA[调转信息列头]]></accountant-migrate〉ﻩﻩ <accountant-note〉<![CDATA[备注信息列头]]></accountant-note〉ﻩ 〈/colhead〉ﻩ <!--单个会计从业人员数据节点-->ﻩﻩ<accountant>ﻩﻩﻩ〈!—-会计人员基础信息--〉ﻩﻩﻩ<accountant-base〉<![CDATA[基础信息]]〉〈/accountant-base>ﻩﻩﻩ<!——会计人员继续教育信息—->〈accountant—edu>〈![CDATA[继续教育信息]]〉〈/accountant—edu>ﻩﻩﻩ〈!--会计人员奖惩信息——><accountant-reward><![CDATA[奖励信息]]〉</accountant-reward>〈!-—会计人员处罚信息--〉<accountant-punish>〈![CDATA[处罚信息]]〉〈/accountant—punish>ﻩﻩﻩ<!-—会计人员信息变更--〉<accountant—change>〈![CDATA[信息变更]]〉〈/accountant—change〉ﻩﻩ <!-—会计人员调转信息--><accountant-migrate><![CDATA[调转信息]]></accountant-migrate〉<!-—会计从业人员备注-->〈accountant-note><![CDATA[备注信息]]〉</accountant—note〉〈!—会计从业人员附件信息--〉<attachments〉ﻩ〈!—会计从业人员照片信息,采用Base64编码—-〉ﻩ〈attachmentid_num=“身份证件号码"acnt_id=“档案号”type=“01”〉照片数据(Base64编码)</attachment〉ﻩ……〈/attachments〉ﻩﻩ〈/accountant〉ﻩ</accountants></root〉下面分别介绍CDATA段中会计从业人员的各项信息数据格式.会计列头信息描述了会计信息中的数据是排列方式。数据内容是根据列头描述的具体数据,字段之间的分割符号为!#!,记录之间使用分隔符!@!,如果字段内容为空请参考5.2。4.1中的空值约束.会计从业人员数据上报操作标记请参考5。2。5节记录操作标记描述,下面的例子仅仅列举了有代表性的字段,其他字段为了表示方便没有列举,具体操作时请参考3.2节数据字典相关描述.跨省调转文件文件头描述<head/〉在文件头描述中,包括一些对文件相关的全局描述,主要包括创建文件的操作人员ID、文件的形成日期、文件中包括的会计人员的个数和文件的全名,基本格式如下:<head> ﻩ<operator〉管理员ID〈/operator> ﻩ〈date>2010—12—9</date>〈count>1〈/count><filename>U_110000_20101201_资格证号_DATA.XML〈/filename>ﻩ</head>会计信息列头描述〈colhead/>在列头的CDATA数据块中,第一个数据字段固定为操作标记,用ADPM_OPT表示。<colhead>〈accountant-base〉<![CDATA[ADPM_OPT!#!ACNT_ID!#!NAME!#!SEX!#!BIRTH!#!NATION!#!COUNTRY!#!ID_TYPE!#!ID_NUM!#!POLTC_STATUS!#!ACNT_WORK_DATE!#!FT_EDUCATION!#!FT_DEGREE!#!FT_EDU_UNIVE!#!FT_EDU_GDATE!#!FT_EDU_PRO!#!PT_EDUCATION!#!PT_DEGREE!#!PT_DEGREE_DATE!#!PT_DEGREE_UNIVE!#!PT_DEGREE_PRO!#!ADMIN_POST!#!PQ_TYPE!#!PQ_LEVEL!#!PQ_GET_TYPE!#!PQ_GET_DATE!#!PQ_CARD_NUM!#!PQ_POST!#!PQ_POST_GDATE!#!JSC_AUTH_ORG!#!JSC_AUTH_DATE!#!JSC_REG_DATE!#!ABACUS_LEVEL!#!ABACUS_NUM!#!MOBILE!#!EMAIL!#!IS_ATWORK!#!ORG_FULL_NAME!#!ORG_ADDRESS!#!ORG_TEL!#!ORG_TYPE!#!ACNT_POSITION!#!REGION_CODE!#!IS_CPA!#!IS_CPV!#!IS_CTA!#!IS_HL_TALENT!#!TALENT_TYPE!#!TALENT_GET_DATE]]></accountant-base〉ﻩﻩ<accountant—edu〉<![CDATA[ADPM_OPT!#!ACNT_ID!#!ID_NUM!#!EDU_YEAR!#!PASS_DATE!#!EDU_HOURS!#!EDU_CREDIT!#!PASS_TYPE!#!PASS_REASON]]〉</accountant-edu>〈accountant—reward〉<![CDATA[ADPM_OPT!#!ID_NUM!#!ACNT_ID!#!REWARD_DATE!#!REWARD_LEVEL!#!REWARD_ORG!#!REWARD_CONT]]>〈/accountant-reward>〈accountant-punish〉<![CDATA[ADPM_OPT!#!ID_NUM!#!ACNT_ID!#!PUNISH_DATE!#!START_DATE!#!PUNISH_ORG!#!PUNISH_TYPE!#!TIME_LIMIT!#!END_DATE!#!IS_RELIEVE!#!RELIEVE_ORG!#!REMARK]]〉</accountant—punish〉ﻩﻩ<accountant-change>〈![CDATA[ADPM_OPT!#!ACNT_ID!#!ID_NUM!#!CHANGE_DATE!#!CHANGE_TYPE!#!CHANGE_BEFORE!#!CHANGE_AFTER]]></accountant-change><accountant-migrate〉<![CDATA[ADPM_OPT!#!ACNT_ID!#!ID_NUM!#!MIGRT_OUT_DATE!#!MIGRT_OUT_REGION!#!MIGRT_IN_DATE!#!MIGRT_IN_REGION]]〉</accountant-migrate><accountant—note〉<![CDATA[ADPM_OPT!#!ACNT_ID!#!ID_NUM!#!REMARK_DATE!#!REMARK_CONT]]></accountant—note〉</colhead>会计从业人员基础信息<accountant-base/〉在数据的CDATA数据块中,第一个数据字段固定为操作标记,具体取值可参考5.1.5节。C!#!41142512456398!#!张三!#!1!#!19800824!#!01!#!1!#!1!#!220211198812297895!#!04!#!20050628!#!5!#!5!#!北京大学!#!20050625!#!03!#!6!#!6!#!20071212!#!北京大学!#!04!#!3!#!3!#!3!#!3!#!20081212!#!AP00011234!#!5!#!20081212!#!北京某财政局!#!20081212!#!20081212!#!5!#!2008ABA0001!##!lxj@sina。com!#!1!#!单位名称!#!单位地址!#!01025457852!#!31!#!05!#!100000!#!1!#!0!#!0!#!1!#!02!#!20091212……会计从业人员继续教育信息<accountant-edu/>在数据的CDATA数据块中,第一个数据字段固定为操作标记,具体取值可参考5.1.5节。C!#!41142512456398!#!220211198812297895!#!2007!#!20070825!#!24!#!1.5!#!1!#!完成所修课程!@!C!#!41142512456398!#!220211198812297895!#!2007!#!20070825!#!24!#!1。5!#!1!#!完成所修课程!@!C!#!41142512456398!#!220211198812297895!#!2007!#!20070825!#!24!#!1.5!#!1!#!完成所修课程……ﻩ会计从业人员奖励信息〈accountant-reward/>在数据的CDATA数据块中,第一个数据字段固定为操作标记,具体取值可参考5.1.5节。C!#!220211198812297895!#!22020033320001!#!20081212!#!03!#!会计机关!#!获得先进个人称号!@!C!#!220211198812297898!#!22020033320007!#!20081212!#!03!#!会计机关!#!获得先进……会计从业人员处罚信息<accountant-punish/>在数据的CDATA数据块中,第一个数据字段固定为操作标记,具体取值可参考5.1.5节。C!#!220211198812297895!#!22020033320001!#!20081212!#!20090101!#!会计机关!#!04!#!20090630!#!20090630!#!0!#!!#!备注内容!@!C!#!220211198812297896!#!22020033320003!#!20081212!#!20090101!#!会计机关!#!04!#!20090630!#!20090630!#!0!#!!#!备注内容……会计从业人员变更信息<accountant-change/〉在数据的CDATA数据块中,第一个数据字段固定为操作标记,具体取值可参考5。1。5节。C!#!41142512456398!#!220211198812297895!#!20091212!#!100!#!张三!#!张思!@!C!#!41142512456399!#!220211198812297899!#!20091212!#!100!#!王五!#!王武!@!……会计从业人员调转信息<accountant-migrate/>在数据的CDATA数据块中,第一个数据字段固定为操作标记,具体取值可参考5。1。5节.C!#!41142512456398!#!220211198812297895!#!20100928!#!100000!#!20101025!#!411425!@!C!#!41142512456399!#!220211198812297899!#!20100928!#!100000!#!20101025!#!411425!@!……会计从业人员备注信息〈accountant-note/〉在数据的CDATA数据块中,第一个数据字段固定为操作标记,具体取值可参考5.1.5节.C!#!41142512456398!#!220211198812297895!#!20081212!#!调出!@!C!#!41142512456399!#!220211198812297899!#!20081212!#!考试!@!C!#!41142512456398!#!220211198812297895!#!20081212!#!退休!@!……会计从业人员附件信息<attachments〉ﻩﻩﻩ〈!—会计从业人员照片信息,采用Base64编码-->〈attachmentid_num=“身份证件号码”acnt_id=“档案号”type=“01”>照片数据(Base64编码)〈/attachment〉ﻩ……</attachments>ﻩﻩ由于附件可能多种多样,并且数据类型很多,目前系统只考虑照片。照片是二进制数据为了使用XML文档格式存储和传输,首先将照片内容编码为Base64字符串,这样就可以直接作为数据放入XML文档中,当服务器接到数据后再使用Base64解码,得到实际的照片数据.由于各地方系统杂乱多样,不同地方之间使用的档案号甚至可能重复,这里必须指明照片这个附件两个相关属性作为依据:acnt_id:该附件所对应的会计从业人员档案号;id_num:该附件所对应的会计从业人员的有效身份证件号码;使用这两个属性作为消除会计从业人员数据重复的依据。注:会计从业人员跨省调转数据规范和会计从业人员数据上报数据规范十分类似,不同的是:跨省调转一个文件只存储一个会计从业人员的信息且附件信息也存储到该文件中;数据上报一个文件包含多个会计从业人员信息,附件数据和基础数据分离.数据文件处理规则各地方会计从业人员管理系统必须实现对4.3.3.1节描述的数据格式的导入(会计从业人员调入)和导出(会计从业人员调出)功能,跨省调转平台同样实现上述导入和导出功能,为跨省会计从业人员的调转做一个中转平台。生成文件/上传文件文件的命名、尺寸、分隔符必须符合接口规范要求。读取文件/下载文件调转文件格式增加zip压缩包形式现在全国会计人员信息管理系统对于调转转出的导入文件支持xml文件格式和zip压缩包的格式,在各地方会计系统进行导入的时候可以用这两种文件格式的方式进行导入调转,xml文件的格式还是按4.3.4.1的格式进行编写,zip压缩包只是可以一次导入多个xml文件,但是需要确保压缩包中的每个xml文件都符合4.3.4.1要求的文件格式。zip压缩包的命名没有严格规定,最好是以调出地行政区划为压缩包名字的开头.在导入时每个压缩包中的上报文件要少于100个.在调转功能的导出功能现在也支持导出成zip压缩包的格式。关于zip包的命名规范可以参照:文件名=地方行政区划代码+“_”+YYYYMMDD+“_”+编号。zip;地方行政区划代码:如上海、北京、河北的行政区划代码,具体见国家标准行政区划表;编号:受网络速度限制,单文件尺寸不宜过大,数据应分多文件存储,编号可取四位数字,0001-9999;示例:北京市的2008年12月25号的第一个数据文件可用如下名称:110000_20081225_0001。zip,编号依次类推,同一天从1开始编号.数据交换协议会计从业人员数据上报交换数据文件内容约束需要上报的数据内容包括如下几类:会计人员的基础信息;会计人员的继续教育信息;会计人员的奖励信息;会计人员的处罚信息;会计人员的调转信息;会计人员的变更信息;会计人员的备注信息;会计人员的附件信息;考虑到全国人员的数据量很大,对于数据内容,除第一次外,以后只需要上报发生了变更的数据(对于非基础信息的修改,不遵循此例,具体请参考5.1.5节“数据操作标记相关说明"),对于没有发生变化的数据不需要传输,上述描述这些数据信息必须按照接口规范的要求进行文件内容组织、数据校验和文件生成,否则系统无法接收,具体数据描述可参考数据字典章节.交换数据文件基本约束交换文件相关约束,规定了文件的类型、数据内容的编码、文件的命名和相关存储规则。交换文件类型和字符编码规范使用XML文件作为数据交换的标准格式,交互文件存放目录可以根据实际情况设置,全国会计从业人员信息管理系统根据设置的存放目录和同步频率到指定的目录获取本地系统导出的符合接口规范的数据文件,然后导入到系统中。为了文件内容的构造和解析一致,本规范规定数据文件内容编码统一使用UTF-8.交换文件命名约定会计从业人员基础数据文件文件名=地方行政区划代码+“_”+YYYYMMDD+“_"+编号+“_"+“DATA”.XML;地方行政区划代码:如上海、北京、河北的行政区划代码,具体见国家标准行政区划表;编号:受网络速度限制,单文件尺寸不宜过大,数据应分多文件存储,编号可取四位数字,0001—9999;示例:北京市的2008年12月25号的第一个数据文件可用如下名称:110000_20081225_0001_DATA。XML,编号依次类推,同一天从1开始编号。会计从业人员附件数据文件文件名=地方行政区划代码+“_”+YYYYMMDD+“_”+编号+“_”+“ATTACH".XML;地方行政区划代码:如上海、北京、河北的行政区划代码,具体见国家标准行政区划表;编号:受网络速度限制,单文件尺寸不宜过大,附件数据应分多文件存储,编号可取四位数字,0001-9999;示例:北京市的2008年12月25号的第一个附件数据文件可用如下名称:110000_20081225_0001_ATTACH。XML,编号一次类推,同一天从1开始编号.说明:上报数据文件名称中的“行政区划代码”指的是上报地区行政区划将行政区划改成行政区划(或代码)(或代码);将行政区划改成行政区划(或代码) 行政区划代码在数据上报文件中只允许使用各地一级行政区划代码,具体可参考HYPERLINK\l"行政区划代码”行政区划代码表。文件容量约定ﻩ由于数据量过大时不仅影响数据的网络传输而且影响数据的解析,所以这里对数据文件的大小做一规范。数据上报中单个文件允许存储多个会计记录,所以每个文件中存储容量要求不超过5M,具体可以存储多少条记录,地方可以根据实际情况权衡。附件文件要求同上。说明:单个文件尺寸不要超过5M,具体可以存放多少条记录地方系统根据实际情况权衡;同一个会计人员的数据不允许跨文件存储;交换文件存储约束文件存储约定本地导出的数据文件要存放到预先设置的FTP服务目录下,为全国会计从业人员信息管理系统数据同步做数据准备。文件在FTP服务器上的存储采用文件系统类似的层级结构,具体描述如下:以各地区一级代码作为根目录名,如北京则用110000;在地方名目录下存放当天的所有导出文件,文件的命名规则请参考5.1。2.2节;服务器工作目录中只存储尚未被全国系统处理的文件,已经处理的将自动会移动到备份目录中。具体的FTP访问要使用的用户名、密码和访问目录将随后另附文件发布,请各地方系统自行预留配置参数。FTP服务器目录访问权限约定每个地区有一个FTP账户,且必须在全国会计从业人员信息管理系统中注册;每个地区只有对本地区的目录有读写权限;说明:ﻩ这里的地区指各地一级行政区划代码所对应的地区,具体可参考HYPERLINK\l”行政区划代码"行政区划代码表.文件覆盖约定如果存在重名文件问题,则将原来文件移动到其他目录,用最新文件存储在当前目录下。文件清理约定由于数据文件量较大,FTP服务器备份目录中的数据只保留三个月;FTP服务器中的备份文件如果超过三个月的将直接删除;数据文件在全国系统中存有备份,这里只做转储;交换文件数据参数约束数据空值约束对于通过全国会计从业人员信息管理系统上传或下载的规范数据,如果数据为空,则以空字符串“”表示,禁止使用null来表示空串,并且即使是空值其相应的字段分隔符也必须要加上。示例: 如果某个会计人员的非全日制最高学历为空,则错误和正确的表示方法如下:错误:……!#!张三!#!null!#!411425!#!……正确:……!#!张三!#!!#!411425!#!……特殊字符约束使用文本作为传输文件格式,文件的数据必须使用一些特殊字符进行字段间和记录间的数据分割,所以这些字符不允许出现在数据的正文内容中,目前用到的特殊分隔符如下列所示:!@! ﻩ记录分隔符,用来分割两个会计从业人员数据记录,数据内容中不允许出现否则解析出错;!#!ﻩﻩ字段分隔符,用来分割一个会计从业人员记录中的两个字段,数据内容中不允许出现,否则解析出错。数据记录操作标记同步数据文件需要记录同步操作的类型,操作标记放在数据文件中每个记录的第一个字段,数据操作的描述如下表所示。操作标记操作描述备注A表示该记录是新添加的数据如果存在则记录插入异常D表示要删除该条记录(只针对基础信息)如果不存在则不处理U表示要修改基础信息记录处理基础数据的更新UR表示修改非基础信息记录专门处理非基础信息更新O表示该会计数据记录为本地跨省调出减少记录会计人员由本地调出后上报时使用I表示该会计数据记录为本地跨省调入增加记录会计人员调入本地后上报时使用说明:ﻩ在组织数据上报报文格式时,应遵循以下要求:对于新增的会计从业人员(不包含跨省调入)所有的数据记录都要使用“A”标记;对于已经上报过,需要修改基础信息的会计从业人员记录要使用“U”标记;对于已经上报过,需要修改除基础信息以外的其他子信息(如继续教育信息、变更信息、奖励信息等)要使用“UR”标记,由于财政部数据平台无法根据地方系统提供的数据定位到具体的字信息某一条记录,在字信息某一条记录需要更新时,必须将该会计人员的同一子信息的所有记录全部上传,例如:会计张三有三条继续教育信息,在本次上报时第二条发生了变更,那么在本次上报时的张三的继续教育信息中应该上报全部三条记录,且都使用“UR”标记,其他相关信息类推;对于会计从业人员调入本地后,需要上报本地增加人员的数据,必须使用“I”标记;对于会计从业人员由本地调出后,需要上报本地减少人员的数据,必须使用“O”标记;对于要删除(上报数据错误或该人员资格证失效等情况)的会计从业人员数据,都要使用“D"标记,此标记要慎重使用;若上报数据中,某人基础数据的标志为“D”,则数据平台将会将该人员的所有有关基础信息、子信息记录都进行清除,若只是该人子信息某一条记录删除,则需使用UR标记,参见UR标记使用规则。地方自建管理系统生成上报数据时的操作标记,需要严格按照接口规范处理,以下列表将对各个操作标记在财政部系统中的处理进行说明,请参照处理:标记名称使用说明A新增主记录不存在时则新添加一条;主记录存在时则插入异常,不允许插入;子记录插入时主记录必须存在否则不允许插入;U主记录更新主记录不存在时则新添加一条记录;主记录不存在时则更新已经存在的记录;子记录更新不使用该标记;UR子记录更新子记录更新时,需要将子记录数据全部重传;主记录不允许使用该标记;D记录删除主记录使用该标记,则其主记录及子记录全部删除;如果有一条子记录使用该标记,则删除所有子记录;I调入该会计人员首次调入时主记录使用该标记,存在则更新行政区划,否则新增记录;子记录的操作标记必须和主记录一致,否则拒绝插入;当数据中的行政区划必须和平台中的行政区划不一致时,必须使用该标记,否则不予操作;调入上报失败后,重新上报时也使用该标记,否则拒绝操作;O调出1、会计人员已经调出时主记录和子记录使用,表示该会计人员已经调出;主记录指的是会计从业人员的基础信息内容,子记录指的是奖惩、继续教育、调转等内容;错误日志采用累加方式,当会计人员记录中任何一条发生错误则,则整个会计人员保存失败,事务回滚,并记录错误日志,每个会计人员一条错误日志;文件头中的会计人员记录数字段的含义:由于一个上报文件中可以包含多一个会计人员,每个会计人员可以包含多条记录(主记录只有一条,子记录多条),会计人员记录数指的是该文件中会计人员的个数,而不是指文件中数据记录的条数。会计人员的关键字不能包含控制字符,否则文件解析失败;规范例外网络不可到达情况对于某些地方系统基于安全考虑不能进行通过网络传输,可以按照规范要求导出数据文件,然后通过刻盘或者其他方式对文件进行转储,定期将存储介质报送到财政部人工导入到全国会计从业人员信息管理系统。对于某些地方系统只在局域网内运行,无法访问外部网络进行FTP上传,这些地方也可以在实现接口规范后,通过导出文件转储,直接将存储介质报送到财政部,然后人工导入。文件类型无法提供情况目前系统只能支持规范要求的数据文件类型及格式.其他说明单位变更说明地方自建管理系统中,若发生了地区行政区划信息的变更,例如地区的拆分、合并等,上报涉及地区编码变化的会计人员数据或者在进行调转业务操作时,可能会发生无法完成的异常情况,必须按照如下规则进行处理:首先在财政部平台中正确更新(添加新单位、删除旧单位、单位拆分或单位合并)单位信息,使单位编码变更与地方自建管理系统同步;若此次变更涉及到会计人员信息中行政区划变更,则需将发生变更的单位所包含会计人员数据以更新形式上报至财政部数据平台;删除某单位前,若该单位下包含有会计人员,必须先将属于该单位的会计人员数据转入新单位,通过数据上报将变更后的信息同步至财政部数据平台后,再进行单位删除;会计从业人员跨省调转交换数据文件内容约束会计从业人员跨省调转数据内容包括如下几类:会计人员的基础信息;会计人员的继续教育信息;会计人员的奖励信息;会计人员的处罚信息;会计人员的调转信息;会计人员的变更信息;会计人员的备注信息;会计人员的附件信息;具体信息可以参考接口数据字典章节。上述描述这些数据信息必须按照接口规范的要求进行文件内容组织、数据校验和文件生成,否则系统无法接收。交换数据文件基本约束交换文件相关约束,规定了文件的类型、数据内容的编码、文件的命名和相关存储规则。交换文件类型和字符编码规范使用XML文件作为数据交换的标准格式,交互文件存放目录可以根据实际情况设置,全国会计从业人员信息管理系统根据设置的存放目录和同步频率到指定的目录获取本地系统导出的符合接口规范的数据文件,然后导入到系统中。为了文件内容的构造和解析一致,本规范规定数据文件内容编码统一使用UTF-8。交换文件命名约定文件名=操作标志+“_"+地方行政区划代码+“_"+YYYYMMDD+“_”+会计人员档案号+“_”+“DATA”.XML;操作标志:用来标志是上传文件还是下载文件,上传:“U”,下载:“D";地方行政区划代码:如上海、北京、河北的行政区划代码,具体请参考国家标准行政区划表;YYYYMMDD:从调转平台下载或者上传的操作日期;会计人员档案号:会计从业人员从业资格证档案号;示例:2008年8月25日从跨省调转平台下载的文件可用如下名称:D_110000_20080825_10000034567812_DATA.XML。2008年8月25日从地方系统导出的要上传到跨省调转平台的文件可用如下名称:U_110000_20080825_10000034567812_DATA。XML。说明:对于调出地地方系统导出的文件中的行政区划代码指的是本地行政区划或代码);对于跨省调转平台上下载的文件中的行政区划代码指的是调入地行政区划代码;文件容量约定跨省调转数据的单个文件中只存储一个会计从业人员记录,其数据量不会太大,这里不做限制。交换文件存储约束对于跨省调转的上传文件,跨省调转平台根据文件来源进行备份处理,地方系统的导出文件在本地需进行备份处理。交换文件数据参数约束数据空值约束对于通过全国会计从业人员信息管理系统上传或下载的规范数据,如果数据为空,则以空字符串“”表示,禁止使用null来表示空串,并且即使是空值其相应的字段分隔符也必须要加上。示例: 如果某个会计人员的非全日制最高学历为空,则错误和正确的表示方法如下:错误:……!#!张三!#!null!#!411425!#!……正确:……!#!张三!#!!#!411425!#!……特殊字符约束使用文本作为传输文件格式,文件的数据必须使用一些特殊字符进行字段间和记录间的数据分割,所以这些字符不允许出现在数据的正文内容中,目前用到的特殊分隔符如下列所示:!@!ﻩﻩ记录分隔符,用来分割两个会计从业人员数据记录,数据内容中不允许出现否则解析出错;!#!ﻩﻩ字段分隔符,用来分割一个会计从业人员记录中的两个字段,数据内容中不允许出现,否则解析出错。数据记录操作标记会计人员跨省调转需要记录同步操作的类型,操作标记放在数据文件中每个记录的第一个字段,数据操作的描述如下表所示。操作标记操作描述备注O表示该会计数据记录是调出记录在跨省调转时调出地生成,该标志指当前人员为本地调出人员I表示该会计数据记录是调入记录在跨省调转时调转平台生成,该标志指当前人员为该地调入人员,地方系统导入时可不做处理说明:ﻩ跨省调转报文应遵循如下原则:对于调出会计从业人员数据,要使用“O"标记;对于调入会计从业人员数据,要使用“I”标记;网络不可到达情况对于某些地方系统基于安全考虑不能进行通过网络传输,可以按照规范要求导出数据文件,然后通过刻盘或者其他方式对文件进行转储,定期将存储介质报送到当地财政内网环境处理,或根据财政部其他相关要求处理。文件类型无法提供情况目前系统只能支持规范要求的数据文件类型及格式。数据完整和安全协议数据完整性数据完整性概述地方会计从业人员数据上报需要进行数据文件的网络传输,由于网络环境复杂和网络的可靠性等问题,数据文件在传输个过程中有可能数据部分丢失,或者是被插入一些非法数据,这样数据文件的完整性无法得到保证,如果数据文件本身是不完整的或者遭到了篡改,只有当进行数据解析时才能发现问题,而这个过程耗费了大量的系统资源,为了避免这种情况的出现并且将这种系统开销降低到最低,本规范要求对数据文件进行计算MD5摘要,摘要内容和数据文件内容一同传送到服务器端,该要求仅适用于全国会计人员数据上报。MD5介绍及工作原理MessageDigestAlgorithmMD5(中文名为消息摘要算法第五版)为计算机安全领域广泛使用的一种散列函数,用以提供消息的完整性保护.该算法的文件号为RFC1321(R.Rivest,MITLaboratoryforComputerScienceandRSADataSecurityInc.April1992)MD5的典型应用是对一段信息(Message)产生信息摘要(Message-Digest),以防止被篡改。比如,在UNIX下有很多软件在下载的时候都有一个文件名相同,文件扩展名为.md5的文件,在这个文件中通常只有一行文本,大致结构如:3MD5(filename.tar.gz)=0ca175b9c0f726a831d895e26932461这就是filename。tar.gz文件的数字签名。MD5将整个文件当作一个大文本信息,通过其不可逆的字符串变换算法,产生了这个唯一的MD5信息摘要。众所周知,地球上任何人都有自己独一无二的指纹,这常常成为公安机关鉴别罪犯身份最值得信赖的方法;与之类似,MD5就可以为任何文件(不管其大小、格式、数量)产生一个同样独一无二的“数字指纹",如果任何人对文件做了任何改动,其MD5值也就是对应的“数字指纹”都会发生变化。我们常常在某些软件下载站点的某软件信息中看到其MD5值,它的作用就在于我们可以在下载该软件后,对下载回来的文件用专门的软件(如WindowsMD5Check等)做一次MD5校验,以确保我们获得的文件与该站点提供的文件为同一文件.利用MD5算法来进行文件校验的方案被大量应用到软件下载站、论坛数据库、系统文件安全等方面。MD5的典型应用是对一段Message(字节串)产生fingerprint(指纹),以防止被“篡改”:举个例子,你将一段话写在一个叫data.txt文件中,并对这个data。txt产生一个MD5的值并记录在案,然后你可以传播这个文件给别人,别人如果修改了文件中的任何内容,你对这个文件重新计算MD5时就会发现(两个MD5值不相同)。如果再有一个第三方的认证机构,用MD5还可以防止文件作者的“抵赖",这就是所谓的数字签名应用。MD5还广泛用于操作系统的登陆认证上,如Unix、各类BSD系统登录密码、数字签名等诸多方。如在UNIX系统中用户的密码是以MD5(或其它类似的算法)经Hash运算后存储在文件系统中。当用户登录的时候,系统把用户输入的密码进行MD5Hash运算,然后再去和保存在文件系统中的MD5值进行比较,进而确定输入的密码是否正确.通过这样的步骤,系统在并不知道用户密码的明码的情况下就可以确定用户登录系统的合法性.这可以避免用户的密码被具有系统管理员权限的用户知道。MD5将任意长度的“字节串”映射为一个128bit的大整数,并且是通过该128bit反推原始字符串是困难的,换句话说就是,即使你看到源程序和算法描述,也无法将一个MD5的值变换回原始的字符串,从数学原理上说,是因为原始的字符串有无穷多个,这类似不存在反函数的数学函数.所以,要遇到了md5密码的问题,比较好的办法是:你可以用这个系统中的MD5函数重新设一个密码,如admin,把生成的一串密码的Hash值覆盖原来的Hash值就行了。数据上报完整性规范MD5上报文件列表规则根据系统对数据完整性的要求以及MD5的应用场景,系统采用MD5摘要方式来保证数据完整性,上报文件应符合满足如下规则:目前上报文件包括数据文件和附件文件;导出上报文件必须符合接口规范;对每个上报文件分别使用MD5算法,计算其MD5摘要;将文件名称以及该文件对应的MD5摘要内容存储到一个文本文件中;每天可以生成多个MD5文件,具体文件命名参考后续章节,每个MD5文件中描述的上报文件必须存在且先于MD5文件上传至FTP服务器;上报时,必须先发送上报文件到FTP服务器,待上报文件发送结束后再发送MD5文件。MD5列表文件中的上报文件,部里系统按照顺序进行处理,地方系统可以根据实际的数据组织规则进行处理;MD5文件应进行必要的拆分,这个可以提高部里系统的处理效率,降低上报用时;说明:本次修订,取消了每天只能生成一个MD5文件的限制,现在每天可以生成多个MD5文件,且不再使用覆盖的方式,而是每个MD5文件是一个处理单元,MD5文件中描述的上报文件必须全部存在否则部里系统认为该MD5文件无效不予处理。MD5文件名命名规则文件名=地区行政区划代码+“_"+YYYYMMDD+“_”+编号+“。MD5”地区行政区划代码:本地行政区划一级代码,与数据上报要求一致;YYYYMMDD:MD5文件的生成日期;编号:MD5文件的生成序号,同一天从0000到9999;MD5:使用。MD5作为文件扩展名;示例:符合要求的MD5摘要存储文件的文件名如下:110000_20101212_0001。MD5110000_20101212_0002。MD5110000_20101212_0003.MD5110000_20101212_0004.MD5……MD5列表文件格式文件内容每行存储一条记录,每条记录包含上报文件名称和MD5摘要内容,上报文件名称和MD5摘要之间使用一个空格分割,记录之间使用换行分割。示例:地区行政区划代码为110000的地方系统2008年12月25日产生的第一个MD5列表文件。列表文件名称:110000_20081225_0000。MD5列表文件内容:110000_20081225_0001_DATA。XMLasdfwereasdfwereasdfwereasdfwere110000_20081225_0002_DATA.XMLkdfuwereasdfwereasdfiureasdfwere110000_20081225_0003_DATA。XMLuiytwereasdfwereasdfwereasdfwere110000_20081225_0004_DATA。XMLpiuywereasdfwereasdfwereasdfwere110000_20081225_0004_DATA.XMLpiuywereasdfwereasdfwereasdfwere110000_20081225_0001_ATTACH.XMLxdudfyywereasdfwereasdfwereasdfwere110000_20081225_0002_ATTACH.XMLkiyuitywereasdfwereasdfwereasdfwere110000_20081225_0003_ATTACH.XMLrtyilwlwereasdfwereasdfwereasdfwere……上报文件列表工作原理全国系统采用定时扫描的方式进行上报文件的处理,其处理过程如下:扫描进程开始扫描某地区的FTP目录,如果没有MD5摘要文件则等待下次处理,如果存在MD5摘要文件则下载MD5摘要文件进入下载队列;从下载队列中获取一个MD5文件进行下载检查,如果一个MD5文件中的上报文件在FTP服务器中都存在,则开始下载,如果MD5文件中的部分文件缺失,则记录MD5文件完整错误;当一次下载结束后,开始进行数据上报的处理,上报处理程序以MD5文件为单位进行,使用多个线程处理;FTP扫描和下载程序结束后在FTP服务器上备份处理,上报处理程序结束后在本地进行备份处理,至此一次定时任务执行结束,等待下次定时任务到来;根据以上的MD5文件列表的工作原理,提出如下要求:当上报文件和MD5文件都准备好以后,先上传上报文件,待上报文件传送结束后再发送MD5文件;MD5文件中的上报文件按顺序进行处理,地方系统在组织上报文件时应妥善安排其顺序以防止出现主信息尚不存在就上报子信息的错误;MD5文件应进行合理的拆分以提高上报程序的处理效率(建议);4、地方系统应妥善安排上报尤其是自动上报频度以降低出错的概率(待财政部确定);ﻬ远程调用接口支持概述远程调用接口可以让两个信息系统无障碍地甚至跨平台地通讯,它为不同系统之间的互操作提供了一个优秀的解决方案。为了方便地方系统的功能自动化操作要求,对全国会计从业人员信息管理系统中的部分功能,我们提供了远程调用接口以方便部分有条件的地方系统对程序的自动化处理。远程调用接口为财政部调转平台提供WebService服务供地方系统调用,地方系统可根据自身情况选择性地实现。技术规范1、跨省调转平台与地方系统间的交互是由跨省调转平台提供WebService服务,地方系统发起服务请求,跨省调转平台做完业务处理后给地方系统处理结果。2、跨省调转平台提供的WebService服务输入参数和处理业务后返回的结果数据均为xml格式。3、由于目前硬件环境还未具备,WebService调用地址无法提供,目前只提供wsdl文件,地方系统需进行调用地址参数配置,以保证未来测试、生产环境的地址变更。待测试、生产环境地址确定后将会下发测试、生产环境接口调用地址.请参见“附件02:getMigrate.wsdl”。跨省调转平台和地方系统交互数据格式本数据格式为跨省调转平台与地方系统接收发送数据的标准格式。数据格式:基本结构如下图所示:说明:总体上,报文全部内容封装在一个XML报文中,报文分为两部分:报文头部分、报文体部分.报文头部分报文头部分用于标识每一次业务交互所收发报文的公共属性。报文体部分报文体部分用于存放具体的业务数据,其内容由具体调用的服务决定,各服务报文体的XML结构统一。地方系统请求数据报文的结构请求报文完整结构〈?xmlversion="1.0”encoding="UTF-8"?><ROOT> ﻩ<HEAD> ﻩﻩ……ﻩﻩ</HEAD〉ﻩﻩ<PARAMS〉业务报文</PARAMS〉</ROOT〉请求报文头标签格式ﻩ〈HEAD〉ﻩﻩﻩ〈TIME_STAMP>调用时间戳(2008-12—1120:15:27)〈/TIME_STAMP>ﻩﻩﻩ〈SID〉调用服务编码〈/SID> ﻩﻩ〈REGION_CODE>地方行政区划</REGION_CODE〉ﻩ ﻩ<USERNAME〉用户名</USERNAME> ﻩ <PASSWORD>密码</PASSWORD>ﻩﻩﻩ<RECORDS_CNT>记录数</RECORDS_CNT〉 </HEAD>ﻩ请求报文头标签说明TIME_STAMP标签:该次服务的时间戳(2008—12—1120:15:27);SID标签:客户端发起服务调用编码,请参见7.4.1中服务编码表中服务编码REGION_CODE标签:发出请求所在地的行政区划一级代码USERNAME标签:校验用户名,为预留字段,可为空,若无法实现7。3固定IP客户端限制将通过此方式实现安全验证;PASSWORD标签:校验密码,为预留字段,可为空RECORDS_CNT标签:报文体中查询人员数,必须与报文体中记录数完全一致。请求报文体格式<PARAMS>ﻩﻩﻩﻩ〈PARAM> ﻩﻩ ﻩ<fieldname="region_code">110000</field>ﻩ ﻩﻩ<fieldname="acnt_id">123456789</field>ﻩ ﻩ ﻩ<fieldname="busi_id">12345678911000019860000</field〉ﻩﻩﻩ</PARAM> ﻩ<PARAM〉ﻩﻩﻩ ﻩ〈fieldname=”region_code">……〈/field〉ﻩﻩﻩﻩﻩ<fieldname=”acnt_id">……</field〉 ﻩ ﻩ〈fieldname="busi_id">……〈/field〉ﻩﻩﻩ〈/PARAM〉ﻩﻩﻩ……ﻩ </PARAMS〉请求报文体标签说明PARAMS标签:单据标签.该标签涵盖真正的业务报文。其中每一个<PARAM〉〈/PARAM>为一个需要查询的人员。PARAM标签:参数标签。该标签代表一组参数。field标签:字段标签。代表一个字段,其中属性name的值代表该字段的名称,field标签的value代表该字段的值.Field标签中需要包含的业务数据属性值及解释见7.4节中提供的各服务对应的字典表。必须严格按照所调用服务中的数据字典进行报文组织。平台返回结果数据报文的结构返回结果数据报文完整结构<?xmlversion="1.0"encoding="UTF-8”?><ROOT>ﻩﻩ <HEAD> ﻩ ﻩ报文头ﻩ ﻩ〈/HEAD〉ﻩﻩﻩ〈RESULTS〉业务报文〈/RESULTS>〈/ROOT>返回结果数据报文头标签格式<HEAD〉ﻩﻩ 〈TIME_STAMP〉返回时间戳(2008-12—1120:15:27)〈/TIME_STAMP〉ﻩﻩﻩ<RESULT〉处理结果(1为成功,0为失败)〈/RESULT>ﻩﻩﻩ<MESSAGE_CODE〉失败消息ID</MESSAGE_CODE>ﻩﻩﻩ<MESSAGE_INFO〉失败消息内容</MESSAGE_INFO〉ﻩ ﻩ<RECORDS_CNT〉记录数</RECORDS_CNT〉</HEAD〉返回结果数据报文头标签说明TIME_STAMP标签:时间戳标签。RESULT标签:表示服务的执行状态,1为成功,0为失败.MESSAGE_CODE标签:消息内容ID,目前暂为空,预留。MESSAGE_INFO标签:失败后对应MESSAGE_CODE的消息内容。RECORDS_CNT标签:本报文返回结果中人员数据记录条数返回结果数据报文体格式〈RESULTS><RESULT>ﻩﻩﻩ<fieldname="migrate_status">10〈/field〉ﻩ ﻩ〈fieldname="busi_id”>123456</field>ﻩﻩﻩ<fieldname=”acnt_id">123456</field> ﻩ <fieldname=”migrt_out_region”〉…〈/field〉ﻩﻩﻩ<fieldname=”migrt_in_region”>…〈/field>ﻩﻩﻩ<fieldname="out_opera_time">…</field〉ﻩﻩﻩ<fie="in_opera_time">…</field></RESULT>〈RESULT>ﻩﻩﻩ<fieldname="migrate_status”>…〈/field> <fieldname="busi_id"〉…</field〉ﻩ ﻩ〈fieldname=”acnt_id">…</field>ﻩ ﻩ〈fie="migrt_out_region”>…〈/field> ﻩﻩ<fieldname="migrt_in_region"〉…〈/field>ﻩ ﻩ〈fieldname=”out_opera_time"〉…</field>ﻩﻩﻩ〈fieldname=”in_opera_time”>…</field>〈/RESULT>...…〈/RESULTS〉返回结果数据报文体标签说明RESULTS标签:单据标签。该标签涵盖真正的业务报文。RESULT标签:返回值标签。该标签代表一组返回值.field标签:字段标签。代表一个字段,其中属性name的值代表该字段的名称,field标签的value代表该字段的值。Field标签中需要包含的业务数据属性值及解释见7。4节中提供的各服务对应字典表。必须严格按照字典表中数据规范进行报文组织.接口报文样例请求报文(以跨省调转调出人员状态查询为例) <?xmlversion=”1。0”encoding="UTF-8”?〉<ROOT〉ﻩﻩ〈HEAD>〈TIME_STAMP>2008-12—1120:15:27</TIME_STAMP>ﻩﻩﻩ 〈SID〉0101</SID> ﻩﻩ ﻩ〈REGION_CODE>110000〈/REGION_CODE>ﻩﻩﻩﻩﻩ<USERNAME>sungl</USERNAME>ﻩ ﻩ ﻩ<PASSWORD>sungl</PASSWORD〉ﻩﻩﻩ <RECORDS_CNT〉10〈/RECORDS_CNT>ﻩ </HEAD〉 ﻩ<PARAMS>ﻩﻩ ﻩ<PARAM>ﻩﻩ ﻩﻩ<fieldname="region_code”〉110000</field>ﻩﻩﻩﻩ 〈fieldname=”acnt_id">123456789〈/field>ﻩﻩﻩﻩ <fieldname="busi_id"〉12345678911000019860000</field>ﻩ ﻩ</PARAM〉ﻩﻩﻩ<PARAM>ﻩ ﻩﻩﻩ<fieldname="region_code">……</field> <fieldname="acnt_id"〉……</field〉ﻩﻩﻩﻩﻩ<fieldname="busi_id”〉……</field>ﻩﻩﻩ</PARAM〉ﻩ ﻩ…… ﻩ</PARAMS〉〈/ROOT>返回报文(以跨省调转调出人员状态查询返回结果为例)〈?xmlversion="1。0”encoding=”UTF-8"?><ROOT〉ﻩ <HEAD>ﻩﻩﻩﻩ <TIME_STAMP>2008-12—1120:15:27〈/TIME_STAMP>ﻩﻩﻩﻩﻩ〈RESULT>1〈/RESULT>ﻩ ﻩ <MESSAGE_CODE〉</MESSAGE_CODE>ﻩﻩﻩ <MESSAGE_INFO〉</MESSAGE_INFO> ﻩ <RECORDS_CNT>10</RECORDS_CNT〉 ﻩﻩ〈/HEAD>ﻩﻩﻩ<RESULTS><RESULT>ﻩﻩ ﻩ<fieldname="migrate_status">10</field〉ﻩ ﻩ ﻩ<fieldname="busi_id">123456</field〉 ﻩﻩﻩﻩ〈fieldname="acnt_id">123456〈/field> ﻩﻩ ﻩ<fieldname="migrt_out_region">…〈/field>ﻩﻩﻩﻩ <fieldname=”migrt_in_region"〉…</field>ﻩﻩﻩﻩﻩ〈fieldname=”out_opera_time"〉…</field>ﻩﻩﻩ ﻩ<fieldname="in_opera_time”>…〈/field></RESULT><RESULT〉ﻩﻩﻩ ﻩ<fieldname=”migrate_status”〉20</field>ﻩﻩ ﻩﻩ〈fiel="busi_id”〉12545454</field〉ﻩﻩﻩﻩﻩ<fieldname="acnt_id"〉45457878</field〉ﻩ ﻩﻩ <fieldname="migrt_out_region”〉…</field>ﻩﻩ ﻩﻩ<fieldname="migrt_in_region"〉…</field〉 ﻩﻩﻩﻩ<fieldname=”out_opera_time"〉…〈/field>ﻩ ﻩﻩﻩ〈fieldname="in_opera_time">…</field>〈/RESULT></RESULTS></ROOT>安全访问说明为了保证数据访问安全及高效,远程调用接口目前采用客户端访问限定IP方式进行控制。地方系统在准备调用此远程接口时,需提前将调用客户端IP地址提供给跨省调转平台进行维护,跨省调转平台根据访问的IP及相应的机构信息共同进行

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

评论

0/150

提交评论