软件设计说明书

1、软件设计说明书软件设计说明书文档编号文档名称业务环节增值税一般纳税人申报功能模块增值税一般纳税人申报（江苏专用）编写人田长全编写日期2006.08.29审核人审核日期苏州国税确认人确认日期神州数码确认人确认日期七、个体定额接口七、个体定额接口方法名方法名：public String doService(String sid, Hashtable reqStr)服务服务ID：JS.GTDEHD.HD.PORTAL.CTAIS调用方式调用方式：EJBXML类型类型：自定义参数说明参数说明：sid：服务 ID，reqStr：其 key 值为主附表的服务 ID，value 值为 XML 字符串，数据格

2、式见附录一，reqStr 值的内容如下：请求数据： 索引ID名称类型长度 小数 必须说明1NSRSBH纳税人识别号CHAR20Y单行2ZSXM_DM征收项目代码CHAR2Y3SL税率NUMBER106N4ZSPM_DM征收品目代码CHAR4Y5YSKM预算科目CAHR7Y6BMJC级次CHAR2Y7BMJK金库CHAR5Y5XSSR销售收入NUMBER162N9DEBZ是否定额CHAR1Y6SE税额NUMBER162N7YXQ_Q核定期限起DATE8Y8YXQ_Z核定期限止DATE8N9ZSRQ终审审批日期DATE8N10NSR_SWJG_DM纳税人税务机构代码char11Y11SWJG_DM

3、修改人税务机构代码Char11Y12LRR_DM录入人char11Y13XGRQ修改人Char11Y返回数据索引ID名称类型长度小数必须说明1returnCode处理结果CHAR2Y00-成功2returnMessage处理结果描述VARCHAR128Y注：此提交数据即为定期定额户的税种认定信息。设计说明：此接口是向表 HD_DSQC_LS 表中插入数据，WSPZXH 自动生成。如果表中已经存在该记录，需将原表中记录的 YXBZ 字段置为”N”后插入。YXBZ 默认为 Y。LRRQ,XGR 默认系统时间。根据 NSRSBH、ZSXM_DM、ZSPM_DM、YXQ_Q 查询是否有相同记录，若其

4、YXBZ 为 Y，将其置为 N。八、税票作废八、税票作废方法名方法名：public String doService(String sid, Hashtable reqStr)服务服务ID：JS.TYJKS.SPZF. PORTAL.CTAIS调用方式调用方式：EJBXML类型类型：自定义参数说明参数说明：sid：服务ID，reqStr：其key值为主附表的服务ID，value值为XML字符串，数据格式见附录一，reqStr值的内容如下：请求数据： 索引ID名称类型长度 小数 必须说明1xtsphm系统税票号码NUMBER20Y单行2lrr_dm录入人代码char11Y3spzflx_dm税票

5、作废类型代码char1Y1：作废印刷税票号码2：不作废印刷税票号码返回数据索引ID名称类型长度小数必须说明1returnCode处理结果CHAR2Y00-成功2returnMessage处理结果描述VARCHAR128Y3cwxx错误信息VARCHAR2500N如果 returnCode 不为”00”,则 cwxx 必须赋值.注: 实现功能：根据税票号，将原开具的税票进行作废处理1） 如果是正划票，作废税票前需要取消正划2） 税票未发生缴款业务才能作废（未抵缴、未汇总、未上解、未入库）3） 只作废税票，不涉及应征（不管是税票录入还是通过申报产生）4） 如果存在滞纳金，则作废对应滞纳金（包含滞纳

6、金应征一起作废）5） 如果对应的滞纳金已经扣款或者入库，则不允许作废税票凭证种类：通用缴款书注：不作废 yzpzxh，作废 xtsphm;设计说明：判断顺序：if(pzzl=501)If(如果对应的滞纳金已经扣款或者入库)提示“对应的滞纳金已经扣款或者入库，不允许作废税票” ；Return;elseIf(未抵缴、未汇总、未上解、未入库)If(是正划票)取消正划；If(存在滞纳金)作废滞纳金；作废税票;返回作废信息；else提示响应信息；Return;九九、组织机构代码、税号、法人身份证号比对组织机构代码、税号、法人身份证号比对1 1、组织机构代码证号码重复检测组织机构代码证号码重复检测方法名方

7、法名：public String doService(String sid, Hashtable reqStr)服务服务ID：JS. HMCFJC.CX. PORTAL.CTAIS调用方式调用方式：EJBXML类型类型：自定义参数说明参数说明：sid：服务ID，reqStr：其key值为主附表的服务ID，value值为XML字符串，数据格式见附录一，reqStr值的内容如下：请求数据： 索引ID名称类型长度 小数 必须说明1dmzhm代码征号码char9Y单行返回数据索引ID名称类型长度小数必须说明1returnCode处理结果CHAR2Y00-成功2returnMessage处理结果描述VA

8、RCHAR128Y3recordNum检索到的记录数char2Y检索到的企业数量JS. HMCFJC.CX. SZJK.PORTAL.CTAIS4nsrsbh税号char20Y纳税人识别号(可能多行)5nsrmc企业名称char80Y纳税人名称6nsrzt_mc企业当前情况Char16Y纳税人状态名称注: 实现功能：根据代码征号码，检索纳税人类型为“非注销迁出 51”的，非个体经济的企业中，有没有代码征号码相同的企业（15 位税号后九位） 。设计说明：查询调件： 纳税人识别号 7-15 位=dmzhm 纳税人状态 in (10,20,30,40,21,22,59) 登记注册类型 not in

9、(400,410,420,430)2 2、根据法人名称和证件号码检索非正常户企业信息、根据法人名称和证件号码检索非正常户企业信息方法名方法名：public String doService(String sid, Hashtable reqStr)服务服务ID：JS.FZCHQYXX.CX. PORTAL.CTAIS调用方式调用方式：EJBXML类型类型：自定义参数说明参数说明：sid：服务ID，reqStr：其key值为主附表的服务ID，value值为XML字符串，数据格式见附录一，reqStr值的内容如下：请求数据： 索引ID名称类型长度 小数 必须说明1fddbrmc企业法人char50

10、Y单行2zjhm法人证件号char20Y单行3FRZJLX_DM法人证件类型代码char2Y单行返回数据索引ID名称类型长度小数必须说明1returnCode处理结果CHAR2Y00-成功2returnMessage处理结果描述VARCHAR128Y3recordNum检索到的记录数Char2Y 检索到的企业数量JS.FZCHQYXX.CX. SZJK.PORTAL.CTAIS4nsrsbh税号char20Y纳税人识别号(可能多行)5nsrmc企业名称Char80Y纳税人名称6Nsr_swjg_mc税务机关名称char60Y税务机关名称注: 实现功能：根据“企业法人+法人证件号”检索状态非正常

11、的企业信息，主要用于检查是否有认定为非正常户的企业的法人开办新企业。设计说明：查询条件：企业法人=fddbrmc 法人证件号=zjhm 纳税人状态=40;3 3、根据税号获取正常开业企业信息、根据税号获取正常开业企业信息方法名方法名：public String doService(String sid, Hashtable reqStr)服务服务ID：JS.ZCKYQYXX.CX. PORTAL.CTAIS调用方式调用方式：EJBXML类型类型：自定义参数说明参数说明：sid：服务ID，reqStr：其key值为主附表的服务ID，value值为XML字符串，数据格式见附录一，reqStr值的内

12、容如下：请求数据： 索引ID名称类型长度 小数 必须说明1nsrsbh纳税人识别号char15Y单行返回数据索引ID名称类型长度小数必须说明1returnCode处理结果CHAR2Y00-成功索引ID名称类型长度小数必须说明2returnMessage处理结果描述VARCHAR128YJS.ZCKYQYXX.CX.SZJK. PORTAL.CTAIS3nsrsbh税号char20Y纳税人识别号(可能多行)4nsrmc企业名称char80Y纳税人名称5nsrzt_dm企业当前情况（代码）char2Y纳税人状态代码6ZCDZ注册地址char80N注册地址7DJZCLX_DM注册类型（代码）char

13、3Y登记注册类型代码8FDDBRMC法人char50N法定代表人9ZY 主营char4000N主营10JY兼营char4000兼营11ZCZB注册资金number162N注册资本12ZCBZ_DM货币单位（代码）char3N注册币种代码13GJ_DM国籍（代码）char3投资方国籍（可能多个）待定。注: 实现功能：根据纳税人识别号检索正常开业正常开业(正常登记)的企业信息，主要用于1） 、外部开业登记后的检查和补发数据（交换平台数据可能不实时，无法满足开业登记后马上数据检索需要） ；2） 、自动填充一些分支机构，总机构信息；设计说明：查询条件：纳税人状态 in (10,20,30,40,21,

14、22,59);十十、外资所得税入库和退库接口、外资所得税入库和退库接口方法名方法名：public String doService(String sid, Hashtable reqStr)服务服务ID：JS.WZSDSRKTK.CX. PORTAL.CTAIS调用方式调用方式：EJBXML类型类型：自定义参数说明参数说明：sid：服务ID，reqStr：其key值为主附表的服务ID，value值为XML字符串，数据格式见附录一，reqStr值的内容如下：请求数据： 索引ID名称类型长度 小数 必须说明1nsrsbh纳税人识别号varchar20Y单行2ksrq开始日期varchar10Y单行

15、3jzrq截止日期varchar10Y单行返回数据索引ID名称类型长度小数必须说明1returnCode处理结果CHAR2Y00-成功,99-无记录2returnMessage处理结果描述CHAR128Y3recordNum检索到的记录数char5Y检索到的记录数JS.WZSDSRKTK.CX. SZJK.PORTAL.CTAIS4JKPZXH缴款凭证序号char20税票号5SKSX税款性质char201-入库，02-退库6FSRQ入库或退税日期char10入库或退税日期7SE税额number162税款8TTLX_DM退税类型编码char2退税的性质类型9SSSQ_Q所属时期起date8纳税人

16、税款所属时期起10SSSQ_Z所属时期止date8纳税人税款所属时期止11ZSPM_DM征收品目代码char4税目编码12SKSX_DM税款属性char2税款属性注: 实现功能：1、 查询上解日期或退库日期在开始日期与截止日期之间的该纳税人的外资所得税入库或退库记录明细（开始日期上解日期/退库日期截止日期）2、 代扣代缴的所得税不在此范围内(sksx_dm15)3、 滞纳金、罚款不在此查询结果内(skzl_dm in(10,90)4、 返回数据包括：税票号、税款性质(入库还是退库)、上解或退税日期、税款、退税类型编码、税款所属时期、税目编码、申报类型(正常申报税款还是查补税款)。返回的数据可以

17、是多行。退库明细：调帐类型 in (1,4) 征收项目代码=05 退库日期 is not null (此时 sksx 为退库，xtsphm 与 jkpzxh 同,sksx_dm 为空)。入库明细：调帐类型 in (1,4) 征收项目代码=05 入库日期 is not null;(此时 sksx 为入库，ttlx_dm 为空)十一、擎天出口退税软件新增需求十一、擎天出口退税软件新增需求1 1、业务说明：业务说明：2、 业务处理流程：擎天出口退税资格认证-增值税一般纳税人申报-汇总导出3、 处理逻辑：1） 、擎天出口退税资格认证：新增模块，用于判断是否必须读入“出口货物征免税明细表主表” 、 “出

18、口货物征免税明细表从表” 、 “进口料件模拟抵扣税额明细表”这三个 XML 文件。2)、增值税一般纳税人申报：a. 具备了“擎天出口退税资格”的一般纳税人，在申报时必须读入“出口货物征免税明细表主表” 、 “出口货物征免税明细表从表” 、 “进口料件模拟抵扣税额明细表”三个 XML 文件。b. 保存前需要审核增值税纳税申报表与这 3 个附表的关系。c. 保存成功的同时生成“出口生产企业申报的增值税纳税情况汇总表” 。3)、擎天出口退税相关数据导出：a. 能按县局、市局导出某个所属期所有企业的“出口货物征免税明细表主表” 、 “出口货物征免税明细表从表” 、 “进口料件模拟抵扣税额明细表”和“出

19、口生产企业申报的增值税纳税情况汇总表” 。b. 能按县局、市局清除某个所属期所有企业的“出口货物征免税明细表主表”、 “出口货物征免税明细表从表” 、 “进口料件模拟抵扣税额明细表”和“出口生产企业申报的增值税纳税情况汇总表” 的已导出标志。2 2、表单设计、表单设计1、报送擎天出口退税附表的企业认定（江苏专用）申报时是否需要报送擎天出口退税软件生成的附表导入保存取消退出报送擎天出口退税附表的企业认定（江苏专用） 纳税人识别号纳税人名称1） 、纳税人识别号为必录项，录入后检查该纳税人是否存在，不存在给出提示；存在则带出纳税人名称。2） 、保存时，根据需要选择是否钩选“申报时是否需要报送擎天出口

20、退税软件生成的附表” ；3） 、 “导入”按钮用于批量导入出口退税的资格认证信息；点击“导入”时，读入用户选中的 XML 文件，将信息存入数据库中。 （给出样例）2、2003 版增值税一般纳税人申报（江苏专用）2003版增值税一般纳税人申报（江苏专用）导入擎天数据保存导入取消退出1） 、输入纳税人识别号带出纳税人名称；填入申报日期、所属时期起止后，进行系列检查（见 2003 版增值税纳税申报（适用于一般纳税人） ） ，此时还要检查该纳税人是否具备“擎天出口退税企业”资格，若具备，提示“该纳税人具备擎天出口退税企业资格，请读入擎天出口退税数据” ，不读入“出口货物征免税明细表主表” 、 “出口货

21、物征免税明细表从表” 、 “进口料件模拟抵扣税额明细表”这三个 XML 文件不能保存；读盘时注意所读文件的格式正确：a、江苏出口退税企业附表文件的命名规则：“SB” +“_”+纳税人识别号+“_”+填报日期+“_”+CKTS+所属时期+“.XML” 。b、江苏出口退税企业倒出文件的命名规则：“SB” + “_”+地区代码 6 位（SWJG_DM 2-7 位）+倒出日期+“_”+CKTS+所属时期+“.XML” 。2） 、保存前，a.检查“出口货物征免税明细表主表”第 9 栏“出口发票人民币总金额”合计数是否等于“增值税纳税申报主表”第 7 栏“免、抵、退办法出口货物销售额-一般货物-本月数”

22、，误差在 1 分钱内； b.检查“出口货物征免税明细表从表”第 22 栏“不予抵扣税额”合计数减去“进口料件模拟抵扣税额明细表”第 11 栏“不予抵扣抵减额”合计数=“增值税纳税申报主表”第 18 栏“免抵退税办法出口货物不得抵扣进项税额” ，误差在 1 分钱内。注意：检查前需要检查是否存在该文件4） 、保存成功的同时生成“出口生产企业申报的增值税纳税情况汇总表” ，汇总表与增值税主表对应关系如下：4SB_YM所属期（年月）char6Y比如 2006 的 1 月可表示为”200601”5NX_AMT内销货物销售额 number142Y增值税主表第1栏6JYZS_AMT简易征税货物销售额 num

23、ber142Y增值税主表第5栏7MS_AMT免税货物销售额 number142Y增值税主表第8栏8XZHT_AMT出口征税货物销售额 number142Y传出09XZHT_SE出口征税货物税额 number142Y传出010MDT_AMT出口货物免税销售额 number142Y增值税增值税主表第7栏11XXSE销项税额合计 number142Y增值税主表第11栏12BQJXSE进项税额发生额 number142Y增值税主表第12栏13BQJXSEZC 进项税额转出 number142Y增值税主表第14栏14BYDKSE其中：免抵退不予抵扣税额number142Y增值税附表二第18栏15BYDK

24、DJE 不予抵扣税额抵减额number142Y(传出0)16YDKSE先征后退进口料件模拟税额number142Y(传出0)17JXSE进项税额合计 number142Y增值税主表第17栏18SQJZDKSE 上期留抵税额净额 number142Y增值税主表第13栏19CBDJSQLD查补税额抵减上期留抵税额 number142Y(传出0)20YTSE免抵退货物应退税额 number142Y增值税主表第15栏21YNSE应纳税额 number142Y增值税主表第19栏减去第20栏注意：保存之前先保存附表 1、附表 2，否则给出提示不能保存；5)、删除增值税主表时将“出口货物征免税明细表主表”

25、、 “出口货物征免税明细表从表” 、 “进口料件模拟抵扣税额明细表”和“出口生产企业申报的增值税纳税情况汇总表”一并删除。3、擎天出口退税相关数据导出（江苏专用）擎天出口退税汇总导出（江苏专用）按县局导出按市局导出生成文件取消退出所属时期起所属时期止导出路径清除导出1） 、根据 GW_DM 获得纳税人的税务机关，根据税务机关的第 2 到 7 位判断该操作人员导出的权限，并生成相应县或市的导出文件；（按县局导出、按市局技术细节待考证）2） 、点击“生成文件” ，可以按市局或县局导出某个属期所有企业的“出口货物征免税明细表主表” 、 “出口货物征免税明细表从表” 、 “进口料件模拟抵扣税额明细表”

26、和“出口生产企业申报的增值税纳税情况汇总表”，对已导出的数据置“导出标志”为 true；3） 、点击“清除导出”按钮，可以将“导出标志”全部置为 false，以便重新导出。3 3、前后台设计、前后台设计1、擎天出口退税企业资格认证（江苏专用）1） 、前台设计序序 号号页面路径页面路径页面说明页面说明1worksbzzs2003jszyindex.jsp主页面2worksbzzs2003jszyjsindex.js主要函数体JSP 设计见表单设计的“擎天出口退税企业资格认证（江苏专用） ”模块；JS 设计仅将主要函数列举如下：函数名对应文件输入参数输出参数功能说明btn_can_onclick(

27、)index.js 取消按钮事件btn_save_onclick()index.js 保存按钮事件init()index.js 初始化函数nsrsbh_onchange(obj)index.js 内部功能函数btn_readxml_onchange(obj)index.js 导入按钮事件 2)、中间层设计 a. QtcktszgBndService：擎天出口退税资格认定的边界服务方法名称方法描述public boolean saveBindParam() 保存信息public void nsrEntered()响应识别号输入事件的服务public void init(Object forO)初

28、始化服务Public void readxml(Object )批量度入数据并保存b. QtcktszgManager：擎天出口退税资格认定的管理者类方法名称方法描述public String getNsrxx(String nsrsbh) throws Exception取纳税人信息 public boolean saveBindParam (HashMap forMap) throws Exception 保存变更数据c. QtcktszgWorkArea.：擎天出口退税资格认定的用户工作区方法名称方法描述public SbhBmManager getMngr()取纳税人识别号编码变更的管

29、理者对象3） 、后台设计表类型操作类型表名称表注释代码表数据表增加删除修改查询DJ_NSRXX登记纳税人信息RD_JS_NSR_QTCKTSZG擎天出口退税资格认定2、2003 版增值税一般纳税人申报（江苏专用）1） 、前台设计a. JSP 设计见表单设计的“2003 版增值税一般纳税人申报（江苏专用） ”模块，参考“2003 版增值税纳税申报（适用于一般纳税人） ” ；b. JS 设计参考“2003 版增值税纳税申报（适用于一般纳税人） ”2） 、中间层设计a. 参考“2003 版增值税纳税申报（适用于一般纳税人） ” ；b. 申报前检查申报主表与SB_JS_CKHWZMSMXZB、SB_J

30、S_CKHWZMSMXCB、SB_JS_JKLJMNTKSEMXB 的校验关系。BndService 中增加方法：public boolean checkQtsj(Object arg)c. 修改保存方法，保存时将SB_JS_CKHWZMSMXZB、SB_JS_CKHWZMSMXCB、SB_JS_JKLJMNTKSEMXB 同时保存，同时生成汇总表 SB_JS_CKSCQYZZSNSQKHZB。3） 、后台设计参考 2003 版增值税纳税申报（适用于一般纳税人） ，增加的表结构如下：表类型操作类型表名称表注释代码表数据表增加删除修改查询SB_JS_CKHWZMSMXZB出口货物征免税明细表主表

31、SB_JS_CKHWZMSMXCB出口货物征免税明细表从表”SB_JS_JKLJMNTKSEMXB进口料件模拟抵扣税额明细表SB_JS_CKSCQYZZSNSQKHZB出口生产企业申报的增值税纳税情况汇总表3、擎天出口退税相关数据导出（江苏专用）1） 、前台设计a. JSP 设计见表单设计的“擎天出口退税相关数据导出（江苏专用） ”模块；b. JS 设计参考“五小票导出”2） 、中间层设计参考“五小票导出” ；3） 、后台设计表类型操作类型表名称表注释代码表数据表增加删除修改查询SB_JS_CKHWZMSMXZB出口货物征免税明细表主表SB_JS_CKHWZMSMXCB出口货物征免税明细表从表

32、”SB_JS_JKLJMNTKSEMXB进口料件模拟抵扣税额明细表SB_JS_CKSCQYZZSNSQKHZB出口生产企业申报的增值税纳税情况汇总表4 4、库表结构设计说明、库表结构设计说明仅将新增表列举如下，其他表见增值税一般纳税人申报及其附列资料表 2 模块。1、出口货物征免税明细表主表（SB_JS_CKHWZMSMXZB）索引ID名称类型长度 小数 必须说明1.CPCODE海关代码varchar10Y2.SWDJHM税号varchar15Y（主键）3.SB_YM所属期（年月）char6Y比如 2006 的 1 月可表示为”200601”（ 主键）4.SB_NO申报序号char6Y主键5.

33、INV_NO出口发票号varchar12Y6.CKRQ出口日期char10Y7.TDCODE贸易性质码varchar2Y8.CKRMBJE出口发票人民币总金额number132Y9.JZPZH记帐凭证号varchar50Y10.TZBJ调帐标记varchar20Y11.NOTE备注varchar20Y12.FLAG标记varchar1Y13.DCBZ导出标志char1N2、出口货物征免税明细表从表(SB_JS_CKHWZMSMXCB)索引ID名称类型长度 小数 必须说明1.CPCODE海关代码varchar10Y（ 主键）2.SB_YM所属期（年月）char6Y比如 2006 的 1 月可表示

34、为”200601” （ 主键）3SB_NO主表申报序号char6Y（ 主键）4SBCB_NO从表序号char4Y（ 主键）5BGDHM报关单号码varchar21Y6CKZMH代理出口证明号varchar20Y7SPDM商品代码varchar12Y8SPMC商品名称varchar50Y索引ID名称类型长度 小数 必须说明9JLDW计量单位varchar6Y10CKSL出口数量number154Y11WBCODE外币代码varchar3Y12WBKIND外币币别varchar50Y13WBJE外币金额number132Y14WBHL外币汇率number138Y15BGDRMBJE 报关单人民币金

35、额number132Y16MYHL美元汇率number138Y17MYJE美元金额number132Y18CKRMBJE出口发票人民币金额number132Y19ZSL征税率number52Y20TSL退税率number52Y21YYMDTSE 应免抵退税额number132Y22BYDKSE不予抵扣税额number132Y23BSLXBZ补税类型标志varchar1Y24YDKBZ已抵扣标志varchar1Y25NOTE备注varchar20Y26JLJGDJHM进料加工手册登记号码varchar20Y27JHFPL计划分配率number94Y28ZCJSJG组成计税价格number132Y

36、29MDTSEDJE 免抵退税额抵减额number132Y30SJMDTSE实际免抵退税额number132Y31DCBZ导出标志char1N3、进口料件模拟抵扣税额明细表（SB_JS_JKLJMNTKSEMXB）索引ID名称类型长度小数必须说明1.CPCODE海关代码varchar10Y2SWDJHM纳税人登记号varchar15Y（ 主键）4JS_MODE 退税方法char2Y5SB_YM所属期（年月）char6Y比如 2006 的 1 月可表示为”200601” （ 主键）6SB_NO申报序号varchar6Y（ 主键）7NO证明编号varchar20Y8ITEM_NO 项号varchar4Y9CJ_YM出具证明年月char6Y10YDKSE应抵扣模拟税额number132Y索引ID名称类型长度小数必须说明11BYDKDJE 不予抵扣抵减额number132Y12YTSE应抵扣退税额number132Y13NOTE备注varchar10Y14FLAG标记char1Y15DCBZ导出标志char1N4、出口生产企业申报的增值税纳税情况汇总表（SB_JS_CKSCQYZZSNSQKHZB）索引ID名称类型长度 小数 必须取数关系1.CPCODE海关代码varchar10Y2SWDJ