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;


}