iiccardmanager.java~138~

java接口（关于java调用动态库

package com.jysy.taxcore.comm.ic;

import java.util.ArrayList;
import java.util.Calendar;
import com.jysy.taxcore.comm.exception.*;

/**
 * 税控机IC卡管理类, 实现了如下功能:
 * 1. 发行初始化卡
 *
 * <p>Title: IICCardManager</p>
 * <p>Description: 南京地税税控机IC卡编程接口</p>
 * <p>Copyright: Copyright (c) 2004 广东京粤商用技术有限公司</p>
 * <p>Company: 广东京粤商用技术有限公司</p>
 * @author 李志毅
 * @version 1.0
 *
 * 修改说明
 *     2004-04-19 修改了 getSbsjObject,getFpsyqkObject,getSbsjObject,updateSbsjbz 的说明
 */
public interface IICCardManager {

    /**
     * 发行初始化卡
     * @param swdjzlObject         --税务登记资料
     *     swdjzlObject 所有参数
     *                  其中 jyxmmx(经营项目明细) 不超过5个
     * @throws TaxBaseICException  --如果保存时发生异常, 抛出封装了异常编码的异常对象
     */
    public void ICfxcshk(SwdjzlObject swdjzlObject) throws TaxBaseICException;

    /**
     * 发行抄报税卡
     * @param swdjzlObject         --ic卡登记基本资料
     *     swdjzlObject 参数主要是 纳税人识别号、税控机号、卡密码、报税日期
     * @throws TaxBaseICException  --如果保存时发生异常, 抛出封装了异常编码的异常对象
     */
    public void ICfxcbsk(SwdjzlObject swdjzlObject) throws TaxBaseICException;

    /**
     * 补发II型机抄报税卡
     * @param swdjzlObject         --ic卡登记基本资料
     *     swdjzlObject 参数主要是 纳税识别号、税控机号、卡密码、报税日期
     * @throws TaxBaseICException  --如果保存时发生异常, 抛出封装了异常编码的异常对象
     */
    public void ICbfcbskII(SwdjzlObject swdjzlObject) throws TaxBaseICException;

    /**
     * 补发I型机抄报税卡
     * @param swdjzlObject         --ic卡登记基本资料
     *     swdjzlObject 参数主要是 纳税识别号、税控机号、卡密码、报税日期
     * @throws TaxBaseICException  --如果保存时发生异常, 抛出封装了异常编码的异常对象
     */
    public void ICbfcbsk(SwdjzlObject swdjzlObject) throws TaxBaseICException;

    /**
     * 补发I型机系统设置卡
     * @param swdjzlObject         --ic卡登记基本资料
     *     swdjzlObject 参数主要是 纳税识别号、税控机号、卡密码
     * @throws TaxBaseICException  --如果保存时发生异常, 抛出封装了异常编码的异常对象
     */
    public void ICbfxtszk(SwdjzlObject swdjzlObject) throws TaxBaseICException;

    /**
     * 补发I型机收款员卡
     * @param swdjzlObject         --ic卡登记基本资料
     *     swdjzlObject 参数主要是 纳税识别号、税控机号、卡密码
     * @param num         --收款员编号 1 - 4
     * @throws TaxBaseICException  --如果保存时发生异常, 抛出封装了异常编码的异常对象
     */
    public void ICbfskyk(SwdjzlObject swdjzlObject, int num) throws TaxBaseICException;

    /**
     * 补发I型机维修卡
     * @param wxbh                 --维修编号,暂时定为空字符串 ("")
     * @throws TaxBaseICException  --如果保存时发生异常, 抛出封装了异常编码的异常对象
     */
    public void ICbfwxk(String wxbh) throws TaxBaseICException;

    /**
     * 从抄报税卡中读取税务登记资料
     *
     * @return 税务登记资料
     *         swdjzlObject 返回参数主要是 税务登记号、纳税人识别号、税控机号、报税日期
     * @throws TaxBaseICException 如果读取时发生异常, 抛出封装了异常编码的异常对象
     */
    public SwdjzlObject getCbskSwdjzlObject() throws TaxBaseICException;

    /**
     * 从抄报税卡中读取发票使用情况
     *
     * @return 发票使用情况
     *         fpsyqkObject 中属性 swdjzl 返回主要参数是 税务登记号、纳税人识别号、税控机号、报税日期
     * @throws TaxBaseICException 如果读取时发生异常, 抛出封装了异常编码的异常对象
     *
     * 注意：读取发票使用情况后必须调用 updateCfpbz 回写抄发票成功标志
     */
    public FpsyqkObject getFpsyqkObject() throws TaxBaseICException;

    /**
     * 从抄报税卡中读取申报数据
     *
     * @return 申报数据
     *         SbsjObject 中属性 swdjzl 返回主要参数是 税务登记号、纳税人识别号、税控机号、报税日期
     * @throws TaxBaseICException 如果读取时发生异常, 抛出封装了异常编码的异常对象
     *
     * 注意：读取抄报税卡中读取申报数据必须调用 updateSbsjbz 回写申报数据成功标志
     */
    public SbsjObject getSbsjObject() throws TaxBaseICException;

    /**
     * 回写抄发票成功标志
     * @param hxcfp              --回写抄发票对象
     *        hxcfp 的属性 kmm(卡密码) 必须传入
     * @throws TaxBaseICException 如果读取时发生异常, 抛出封装了异常编码的异常对象
     */
    public void updateCfpbz(HxcfpObject hxcfp) throws TaxBaseICException;

    /**
     * 回写申报数据成功标志
     * @param hxsbsj              --回写申报数据对象
     *        hxsbsj 的属性 kmm(卡密码) 必须传入
     *                 属性 xcbsrq 为 getSbsjObject 中的 swdjzl 的报税日期月份加 1
     * @throws TaxBaseICException 如果读取时发生异常, 抛出封装了异常编码的异常对象
     */
    public void updateSbsjbz(HxsbsjObject hxsbsj) throws TaxBaseICException;

    /**
     * 修改抄报税卡报税日期
     * @param bsrq               --报税日期对象
     *        bsrq 属性 kmm(卡密码) bsrq(bsrq) 必须传入
     *
     * @throws TaxBaseICException 如果读取时发生异常, 抛出封装了异常编码的异常对象
     */
    public void updateBsrq(ICardSQObject bsrq) throws TaxBaseICException;

    /**
     * 将发票销售信息保存到IC卡中
     *
     * @param fpxsjlObject 发票销售信息
     *        fpxsjlObject 属性 kmm(卡密码) 必须传入
     *                     属性 fpxxObjects(购买销售记录) 必须传入
     *          fpxxObjects 中每个 FpxxObject 对象主要参数 zgdm(字轨代码) qshm(起始号码) jzhm(截止号码)
     *
     * @throws TaxBaseICException 如果读取时发生异常, 抛出封装了异常编码的异常对象
     */
    public void saveFpxsxx(FpxsjlObject fpxsjlObject) throws TaxBaseICException;

    /**
     * 读取销售的发票信息
     *
     * @return 卡中发票销售信息
     * @throws TaxBaseICException 如果读取时发生异常, 抛出封装了异常编码的异常对象
     */
    public FpxsjlObject getFpxsxx() throws TaxBaseICException;

    /**
     * 依据发票销售信息，从IC卡中注销相应的发票销售信息
     * @param fpxsjlObject 销售的发票信息
     *        fpxsjlObject 属性 kmm(卡密码) 必须传入
     *                     属性 fpxxObjects(购买销售记录) 必须传入
     *          fpxxObjects 中每个 FpxxObject 对象主要参数 zgdm(字轨代码) qshm(起始号码) jzhm(截止号码)
     * @throws TaxBaseICException exception 如果注销发生异常，抛出封装了异常编码的异常对象
     */
    public void ZxFpxsxx(FpxsjlObject fpxsjlObject) throws TaxBaseICException;

    /**
     * IC卡全卡清空
     * @param kmm 卡密码                  --必须传入,不能为空,4个字节
     * @throws TaxBaseICException exception 如果注销发生异常，抛出封装了异常编码的异常对象
     */
    public void cleanICK(String kmm) throws TaxBaseICException;

    /**
     * 读取读卡器设置
     * @return 读卡器设置
     * @throws TaxBaseICException exception 如果注销发生异常，抛出封装了异常编码的异常对象
     */
    public ICReaderSettingObject getICReaderSettingObject() throws TaxBaseICException;

    /**
     * 设置读卡器设置
     * @param setting 读卡器设置
     * @throws TaxBaseICException exception 如果注销发生异常，抛出封装了异常编码的异常对象
     */
    public void setICReaderSettingObject(ICReaderSettingObject setting) throws TaxBaseICException;

    /****************************************************************************
     * 交通运输业（南京）税控接口增加项目
    *
     * @author 李大军
    *
     * @date 2004-05-28
     ****************************************************************************/

    /**
     * 发行用户卡
     * @param swdjzlObject         --税务登记资料
     *     主要参数：
     *         纳税人编号、纳税人识别号、补发次数、税控机号、总额限额、
     *         单张限额、退票总额、授权期限、申报方式、
     *         发卡方代码、单位名称、TSAM卡注册号、明细标志、
     *         其中 jyxmmx(经营项目明细) 不超过6个
     *              主要参数
     *                   索引、税目代码、税率、税种税目中文名称、税种税目英文名称
     * @throws TaxBaseICException
     */
    public void ICMakeTIDCard(SwdjzlObject swdjzlObject, boolean isAdd)throws TaxBaseICException;

    /**
     * 发行税控卡
     * @param swdjzlObject         --税务登记资料
     *     主要参数：
     *         纳税人编号、纳税人识别号、补发次数、税控机号、总额限额、
     *         单张限额、退票总额、授权期限、申报方式、
     *         发卡方代码、单位名称、TSAM卡注册号、明细标志、
     *         其中 jyxmmx(经营项目明细) 不超过6个
     *              主要参数
     *                   索引、税目代码、税率、税种税目中文名称、税种税目英文名称
     * @throws TaxBaseICException
     */
    public void ICMakeTSAMCard(SwdjzlObject swdjzlObject)throws TaxBaseICException;

    /**
     * 发行大容量卡
     * @param swdjzlObject         --税务登记资料
     *     主要参数：
     *         纳税人识别号、纳税人名称
     * @throws TaxBaseICException
     */
    public void ICMakeAT45Card(SwdjzlObject swdjzlObject)throws TaxBaseICException;

    /**
     * 修改用户卡税种税目信息
     * @param SbsjObject SbsjObject     --税务登记资料
     *     主要参数：
     *         纳税人编号
     *         其中 jyxmmx(经营项目明细) 不超过20个
     *              主要参数
     *                   索引、税目代码、税率、税种税目中文名称、税种税目英文名称
     * @throws TaxBaseICException
     */
    public void ICChangeTaxItems(SwdjzlObject swdjzlObject)throws TaxBaseICException;

    /**
     * 报税数据接受
     * @param 序号(1-10)
     * @return 申报数据
     *         SbsjObject 中属性 swdjzl 返回主要参数是 swdjh(国标的纳税人编码)
     *         sksbsjlist 是税控监控数据(MAX 10 台机器的数据)
     * @throws TaxBaseICException
     */
    public SbsjObject getBssj() throws TaxBaseICException;

    /**
     * 回送监控管理数据(完税)
     * @param SbsjObject SbsjObject     --税务登记资料
     *    主要参数：
     *         税控机号、总额限额、单张限额、退票总额、授权期限、TSAM卡注册号、明细标志
     *         其中 jyxmmx(经营项目明细) 不超过6个
     *              主要参数
     *                   索引、税目代码、税率、税种税目中文名称、税种税目英文名称
     * @throws TaxBaseICException
     */
    public void updateTaxEnd(SwdjzlObject swdjzlObject) throws TaxBaseICException;

    /**
     * 发票明细数据回传                   --申报发票明细数据
     * @param SbsjObject SbsjObject     --税务登记资料
     *    主要参数：
     *         税控机号
     *
     * @return FpsyqkObject
     *         swdjzl 中的税控机号(skjh)
     *         fpsyxx 发票使用信息(FpsyxxObject)列表
     * @throws TaxBaseICException
     */
    public FpsyqkObject getFpsyxx(SwdjzlObject swdjzl) throws TaxBaseICException;

    /**
     * 发票明细数据回传                   --申报发票明细数据
     * @return FpsyqkObject
     *         swdjzl 中的纳税人识别号(nsrsbh)
     *         fpsymx 发票明细数据(SbfpmxsjObject)列表
     * @throws TaxBaseICException
     * 注:调用 getFpmxsj 后必须调用 updateCfpbz
     */
    public FpsyqkObject getFpmxsj() throws TaxBaseICException;

    /**
     * 发行税务管理卡
     * 主要参数：
     *
     * @param CheckCardData String
     * @throws TaxBaseICException
     */
    public void ICMakeCheckCard(CheckCardObject CheckCardObject) throws TaxBaseICException;

    /**
     * 读税控卡卡号和机器号
     * @return 税务登记资料
     *     主要参数：
     *          税控卡号、税控机号
     * @throws TaxBaseICException
     */
    public SwdjzlObject getTSAMCode() throws TaxBaseICException;

    /**
     * 读用户卡存放的机器信息
     * @return 税务登记资料列表(SwdjzlObject list)
     *     主要参数：
     *          税控卡号、税控机号
     * @throws TaxBaseICException
     */
    public ArrayList getTIDXX() throws TaxBaseICException;

    /**
     * 读用户卡卡号
     * @return 税务登记资料
     *     主要参数：
     *          用户卡号
     * @throws TaxBaseICException
     */
    public SwdjzlObject getyhkh() throws TaxBaseICException;

    /**
     * 往用户卡写卡号
     * @param swdjzlObject 税务登记资料
     *     主要参数：
     *          用户卡号
     * @throws TaxBaseICException
     */
    public void setyhkkh(SwdjzlObject swdjzlObject) throws TaxBaseICException;


}