package com.jysy.taxcore.comm.ic;

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

/**
 * 稅控機IC卡管理類, 實現(xiàn)了如下功能:
 * 1. 發(fā)行初始化卡
 *
 * <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 {

    /**
     * 發(fā)行初始化卡
     * @param swdjzlObject         --稅務登記資料
     *     swdjzlObject 所有參數(shù)
     *                  其中 jyxmmx(經(jīng)營項目明細) 不超過5個
     * @throws TaxBaseICException  --如果保存時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     */
    public void ICfxcshk(SwdjzlObject swdjzlObject) throws TaxBaseICException;

    /**
     * 發(fā)行抄報稅卡
     * @param swdjzlObject         --ic卡登記基本資料
     *     swdjzlObject 參數(shù)主要是 納稅人識別號、稅控機號、卡密碼、報稅日期
     * @throws TaxBaseICException  --如果保存時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     */
    public void ICfxcbsk(SwdjzlObject swdjzlObject) throws TaxBaseICException;

    /**
     * 補發(fā)II型機抄報稅卡
     * @param swdjzlObject         --ic卡登記基本資料
     *     swdjzlObject 參數(shù)主要是 納稅識別號、稅控機號、卡密碼、報稅日期
     * @throws TaxBaseICException  --如果保存時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     */
    public void ICbfcbskII(SwdjzlObject swdjzlObject) throws TaxBaseICException;

    /**
     * 補發(fā)I型機抄報稅卡
     * @param swdjzlObject         --ic卡登記基本資料
     *     swdjzlObject 參數(shù)主要是 納稅識別號、稅控機號、卡密碼、報稅日期
     * @throws TaxBaseICException  --如果保存時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     */
    public void ICbfcbsk(SwdjzlObject swdjzlObject) throws TaxBaseICException;

    /**
     * 補發(fā)I型機系統(tǒng)設置卡
     * @param swdjzlObject         --ic卡登記基本資料
     *     swdjzlObject 參數(shù)主要是 納稅識別號、稅控機號、卡密碼
     * @throws TaxBaseICException  --如果保存時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     */
    public void ICbfxtszk(SwdjzlObject swdjzlObject) throws TaxBaseICException;

    /**
     * 補發(fā)I型機收款員卡
     * @param swdjzlObject         --ic卡登記基本資料
     *     swdjzlObject 參數(shù)主要是 納稅識別號、稅控機號、卡密碼
     * @param num         --收款員編號 1 - 4
     * @throws TaxBaseICException  --如果保存時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     */
    public void ICbfskyk(SwdjzlObject swdjzlObject, int num) throws TaxBaseICException;

    /**
     * 補發(fā)I型機維修卡
     * @param wxbh                 --維修編號,暫時定為空字符串 ("")
     * @throws TaxBaseICException  --如果保存時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     */
    public void ICbfwxk(String wxbh) throws TaxBaseICException;

    /**
     * 從抄報稅卡中讀取稅務登記資料
     *
     * @return 稅務登記資料
     *         swdjzlObject 返回參數(shù)主要是 稅務登記號、納稅人識別號、稅控機號、報稅日期
     * @throws TaxBaseICException 如果讀取時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     */
    public SwdjzlObject getCbskSwdjzlObject() throws TaxBaseICException;

    /**
     * 從抄報稅卡中讀取發(fā)票使用情況
     *
     * @return 發(fā)票使用情況
     *         fpsyqkObject 中屬性 swdjzl 返回主要參數(shù)是 稅務登記號、納稅人識別號、稅控機號、報稅日期
     * @throws TaxBaseICException 如果讀取時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     *
     * 注意：讀取發(fā)票使用情況后必須調(diào)用 updateCfpbz 回寫抄發(fā)票成功標志
     */
    public FpsyqkObject getFpsyqkObject() throws TaxBaseICException;

    /**
     * 從抄報稅卡中讀取申報數(shù)據(jù)
     *
     * @return 申報數(shù)據(jù)
     *         SbsjObject 中屬性 swdjzl 返回主要參數(shù)是 稅務登記號、納稅人識別號、稅控機號、報稅日期
     * @throws TaxBaseICException 如果讀取時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     *
     * 注意：讀取抄報稅卡中讀取申報數(shù)據(jù)必須調(diào)用 updateSbsjbz 回寫申報數(shù)據(jù)成功標志
     */
    public SbsjObject getSbsjObject() throws TaxBaseICException;

    /**
     * 回寫抄發(fā)票成功標志
     * @param hxcfp              --回寫抄發(fā)票對象
     *        hxcfp 的屬性 kmm(卡密碼) 必須傳入
     * @throws TaxBaseICException 如果讀取時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     */
    public void updateCfpbz(HxcfpObject hxcfp) throws TaxBaseICException;

    /**
     * 回寫申報數(shù)據(jù)成功標志
     * @param hxsbsj              --回寫申報數(shù)據(jù)對象
     *        hxsbsj 的屬性 kmm(卡密碼) 必須傳入
     *                 屬性 xcbsrq 為 getSbsjObject 中的 swdjzl 的報稅日期月份加 1
     * @throws TaxBaseICException 如果讀取時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     */
    public void updateSbsjbz(HxsbsjObject hxsbsj) throws TaxBaseICException;

    /**
     * 修改抄報稅卡報稅日期
     * @param bsrq               --報稅日期對象
     *        bsrq 屬性 kmm(卡密碼) bsrq(bsrq) 必須傳入
     *
     * @throws TaxBaseICException 如果讀取時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     */
    public void updateBsrq(ICardSQObject bsrq) throws TaxBaseICException;

    /**
     * 將發(fā)票銷售信息保存到IC卡中
     *
     * @param fpxsjlObject 發(fā)票銷售信息
     *        fpxsjlObject 屬性 kmm(卡密碼) 必須傳入
     *                     屬性 fpxxObjects(購買銷售記錄) 必須傳入
     *          fpxxObjects 中每個 FpxxObject 對象主要參數(shù) zgdm(字軌代碼) qshm(起始號碼) jzhm(截止號碼)
     *
     * @throws TaxBaseICException 如果讀取時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     */
    public void saveFpxsxx(FpxsjlObject fpxsjlObject) throws TaxBaseICException;

    /**
     * 讀取銷售的發(fā)票信息
     *
     * @return 卡中發(fā)票銷售信息
     * @throws TaxBaseICException 如果讀取時發(fā)生異常, 拋出封裝了異常編碼的異常對象
     */
    public FpxsjlObject getFpxsxx() throws TaxBaseICException;

    /**
     * 依據(jù)發(fā)票銷售信息，從IC卡中注銷相應的發(fā)票銷售信息
     * @param fpxsjlObject 銷售的發(fā)票信息
     *        fpxsjlObject 屬性 kmm(卡密碼) 必須傳入
     *                     屬性 fpxxObjects(購買銷售記錄) 必須傳入
     *          fpxxObjects 中每個 FpxxObject 對象主要參數(shù) zgdm(字軌代碼) qshm(起始號碼) jzhm(截止號碼)
     * @throws TaxBaseICException exception 如果注銷發(fā)生異常，拋出封裝了異常編碼的異常對象
     */
    public void ZxFpxsxx(FpxsjlObject fpxsjlObject) throws TaxBaseICException;

    /**
     * IC卡全卡清空
     * @param kmm 卡密碼                  --必須傳入,不能為空,4個字節(jié)
     * @throws TaxBaseICException exception 如果注銷發(fā)生異常，拋出封裝了異常編碼的異常對象
     */
    public void cleanICK(String kmm) throws TaxBaseICException;

    /**
     * 讀取讀卡器設置
     * @return 讀卡器設置
     * @throws TaxBaseICException exception 如果注銷發(fā)生異常，拋出封裝了異常編碼的異常對象
     */
    public ICReaderSettingObject getICReaderSettingObject() throws TaxBaseICException;

    /**
     * 設置讀卡器設置
     * @param setting 讀卡器設置
     * @throws TaxBaseICException exception 如果注銷發(fā)生異常，拋出封裝了異常編碼的異常對象
     */
    public void setICReaderSettingObject(ICReaderSettingObject setting) throws TaxBaseICException;

    /**
     * 交通運輸業(yè)（南京）稅控接口增加項目
     * @author 李大軍
     * @date 2004-05-28
     */

    /**
     * 發(fā)行用戶卡
     * @param swdjzlObject         --稅務登記資料
     *     主要參數(shù)：
     *         納稅人編號、納稅人識別號、補發(fā)次數(shù)、機器注冊號、總額限額、
     *         單張限額、退票總額、授權期限、申報方式、
     *         發(fā)卡方代碼、單位名稱、TSAM卡注冊號、明細標志、
     *         其中 jyxmmx(經(jīng)營項目明細) 不超過6個
     *              主要參數(shù)
     *                   索引、稅目代碼、稅率、稅種稅目中文名稱、稅種稅目英文名稱
     * @throws TaxBaseICException
     */
    public void ICMakeTIDCard(SwdjzlObject swdjzlObject, boolean isAdd)throws TaxBaseICException;

    /**
     * 發(fā)行稅控卡
     * @param swdjzlObject         --稅務登記資料
     *     主要參數(shù)：
     *         納稅人編號、納稅人識別號、補發(fā)次數(shù)、機器注冊號、總額限額、
     *         單張限額、退票總額、授權期限、申報方式、
     *         發(fā)卡方代碼、單位名稱、TSAM卡注冊號、明細標志、
     *         其中 jyxmmx(經(jīng)營項目明細) 不超過6個
     *              主要參數(shù)
     *                   索引、稅目代碼、稅率、稅種稅目中文名稱、稅種稅目英文名稱
     * @throws TaxBaseICException
     */
    public void ICMakeTSAMCard(SwdjzlObject swdjzlObject)throws TaxBaseICException;

    /**
     * 發(fā)行大容量卡
     * @param swdjzlObject         --稅務登記資料
     *     主要參數(shù)：
     *         納稅人識別號、納稅人名稱
     * @throws TaxBaseICException
     */
    public void ICMakeAT45Card(SwdjzlObject swdjzlObject)throws TaxBaseICException;

    /**
     * 修改用戶卡稅種稅目信息
     * @param SbsjObject SbsjObject     --稅務登記資料
     *     主要參數(shù)：
     *         納稅人編號
     *         其中 jyxmmx(經(jīng)營項目明細) 不超過20個
     *              主要參數(shù)
     *                   索引、稅目代碼、稅率、稅種稅目中文名稱、稅種稅目英文名稱
     * @throws TaxBaseICException
     */
    public void ICChangeTaxItems(SwdjzlObject swdjzlObject)throws TaxBaseICException;

    /**
     * 稅控數(shù)據(jù)回傳
     * @param 序號(1-10)
     * @return 申報數(shù)據(jù)
     *         SbsjObject 中屬性 swdjzl 返回主要參數(shù)是 swdjh(國標的納稅人編碼)
     *         sksbsj 是稅控監(jiān)控數(shù)據(jù)(MAX 10 臺機器的數(shù)據(jù))
     * @throws TaxBaseICException
     */
    public SbsjObject getBssj() throws TaxBaseICException;

    /**
     * 回送監(jiān)控管理數(shù)據(jù)(完稅)
     * @param SbsjObject SbsjObject     --稅務登記資料
     *    主要參數(shù)：
     *         機器注冊號、總額限額、單張限額、退票總額、授權期限、TSAM卡注冊號、明細標志
     *         其中 jyxmmx(經(jīng)營項目明細) 不超過6個
     *              主要參數(shù)
     *                   索引、稅目代碼、稅率、稅種稅目中文名稱、稅種稅目英文名稱
     * @throws TaxBaseICException
     */
    public void updateTaxEnd(SwdjzlObject swdjzlObject) throws TaxBaseICException;

    /**
     * 發(fā)票明細數(shù)據(jù)回傳                   --申報發(fā)票明細數(shù)據(jù)
     * @param SbfpmxsjObject  SbfpmxsjObject
     * 主要參數(shù)：
     *
     * @throws TaxBaseICException
     */
    public SbfpmxsjObject getFpmxsj() throws TaxBaseICException;

    /**
     * 發(fā)行稅務管理卡
     * 主要參數(shù)：
     *
     * @param CheckCardData String
     * @throws TaxBaseICException
     */
    public void ICMakeCheckCard(CheckCardObject CheckCardObject) throws TaxBaseICException;

}