com.popbill.api

Interface HTTaxinvoiceService

All Superinterfaces:

BaseService

All Known Implementing Classes:

HTTaxinvoiceServiceImp

public interface HTTaxinvoiceService
extends BaseService

Hometax Taxinvoice Service Interface.

Version:

1.0.0

Author:

JeongYoHan

Method Summary

Modifier and Type	Method and Description
Response	checkCertValidation(String CorpNum) 홈택스 공인인증서 로그인 테스트
Response	checkDeptUser(String CorpNum) 부서사용자 등록정보 확인
Response	checkLoginDeptUser(String CorpNum) 부서사용자 로그인 테스트
Response	deleteDeptUser(String CorpNum) 부서사용자 등록정보 삭제
Date	getCertificateExpireDate(String CorpNum) 홈택스연계 공인인증서 만료일시 확인
String	getCertificatePopUpURL(String CorpNum) 홈택스연계 공인인증서 등록 URL 확인
String	getCertificatePopUpURL(String CorpNum, String UserID) 홈택스연계 공인인증서 등록 URL 확인
ChargeInfo	getChargeInfo(String CorpNum) 과금정보 확인
String	getFlatRatePopUpURL(String CorpNum) 정액제 신청 URL
String	getFlatRatePopUpURL(String CorpNum, String UserID) 정액제 신청 URL
FlatRateState	getFlatRateState(String CorpNum) 정액제 서비스 상태 확인
FlatRateState	getFlatRateState(String CorpNum, String UserID) 정액제 서비스 상태 확인
HTTaxinvoiceJobState	getJobState(String CorpNum, String JobID) 수집 상태 확인
HTTaxinvoiceJobState	getJobState(String CorpNum, String JobID, String UserID) 수집 상태 확인
String	getPopUpURL(String CorpNum, String NTSConfirmNum) 홈택스 전자세금계산서 팝업 URL
String	getPopUpURL(String CorpNum, String NTSConfirmNum, String UserID) 홈택스 전자세금계산서 팝업 URL
String	getPrintURL(String CorpNum, String NTSConfirmNum) 홈택스 전자세금계산서 인쇄 팝업 URL
String	getPrintURL(String CorpNum, String NTSConfirmNum, String UserID) 홈택스 전자세금계산서 인쇄 팝업 URL
HTTaxinvoice	getTaxinvoice(String CorpNum, String NTSConfirmNum) 상세정보 확인 - JSON
HTTaxinvoice	getTaxinvoice(String CorpNum, String NTSConfirmNum, String UserID) 상세정보 확인 - JSON
HTTaxinvoiceXMLResponse	getXML(String CorpNum, String NTSConfirmNum) 상세정보 확인 - XML
HTTaxinvoiceXMLResponse	getXML(String CorpNum, String NTSConfirmNum, String UserID) 상세정보 확인 - XML
HTTaxinvoiceJobState[]	listActiveJob(String CorpNum) 수집 상태 목록 확인
HTTaxinvoiceJobState[]	listActiveJob(String CorpNum, String UserID) 수집 상태 확인
Response	registDeptUser(String corpNum, String deptUserID, String deptUserPWD) 부서사용자 계정등록
String	requestJob(String CorpNum, QueryType queryType, String DType, String SDate, String EDate) 홈택스 전자(세금)계산서 수집 요청
String	requestJob(String CorpNum, QueryType queryType, String DType, String SDate, String EDate, String UserID) 홈택스 전자(세금)계산서 수집 요청
HTTaxinvoiceSearchResult	search(String CorpNum, String JobID, String[] Type, String[] TaxType, String[] PurposeType, String TaxRegIDYN, String TaxRegIDType, String TaxRegID, Integer Page, Integer PerPage, String Order) 수집 결과 조회
HTTaxinvoiceSearchResult	search(String CorpNum, String JobID, String[] Type, String[] TaxType, String[] PurposeType, String TaxRegIDYN, String TaxRegIDType, String TaxRegID, Integer Page, Integer PerPage, String Order, String UserID) 수집 결과 조회
HTTaxinvoiceSearchResult	search(String CorpNum, String JobID, String[] Type, String[] TaxType, String[] PurposeType, String TaxRegIDYN, String TaxRegIDType, String TaxRegID, Integer Page, Integer PerPage, String Order, String UserID, String SearchString) 수집 결과 조회
HTTaxinvoiceSummary	summary(String CorpNum, String JobID, String[] Type, String[] TaxType, String[] PurposeType, String TaxRegIDYN, String TaxRegIDType, String TaxRegID) 수집 결과 요약정보 조회
HTTaxinvoiceSummary	summary(String CorpNum, String JobID, String[] Type, String[] TaxType, String[] PurposeType, String TaxRegIDYN, String TaxRegIDType, String TaxRegID, String UserID) 수집 결과 요약정보 조회
HTTaxinvoiceSummary	summary(String CorpNum, String JobID, String[] Type, String[] TaxType, String[] PurposeType, String TaxRegIDYN, String TaxRegIDType, String TaxRegID, String UserID, String SearchString) 수집 결과 요약정보 조회

Methods inherited from interface com.popbill.api.BaseService

checkID, checkIsMember, getAccessURL, getBalance, getChargeURL, getContactInfo, getContactInfo, getCorpInfo, getCorpInfo, getPartnerBalance, getPartnerURL, getPaymentHistory, getPaymentHistory, getPaymentURL, getPointInfo, getPopbillURL, getPopbillURL, getRefundableBalance, getRefundableBalance, getRefundHistory, getRefundHistory, getRefundInfo, getRefundInfo, getSettleResult, getSettleResult, getUseHistory, getUseHistory, getUseHistoryURL, joinMember, listContact, listContact, paymentRequest, paymentRequest, quitMember, quitMember, refund, refund, registContact, registContact, updateContact, updateCorpInfo, updateCorpInfo

Method Detail

getFlatRatePopUpURL

String getFlatRatePopUpURL(String CorpNum)
                    throws PopbillException

정액제 신청 URL

Parameters:

CorpNum - 연동회원 사업자번호

Returns:

정액제 신청 url

Throws:

PopbillException

getFlatRatePopUpURL

String getFlatRatePopUpURL(String CorpNum,
                           String UserID)
                    throws PopbillException

정액제 신청 URL

Parameters:

CorpNum - 연동회원 사업자번호

UserID - 연동회원 아이디

Returns:

정액제 신청 url

Throws:

PopbillException

getChargeInfo

ChargeInfo getChargeInfo(String CorpNum)
                  throws PopbillException

과금정보 확인

Parameters:

CorpNum - 연동회원 사업자번호

Returns:

과금정보 (see. com.popbill.api.ChargeInfo)

Throws:

PopbillException

requestJob

String requestJob(String CorpNum,
                  QueryType queryType,
                  String DType,
                  String SDate,
                  String EDate)
           throws PopbillException

홈택스 전자(세금)계산서 수집 요청

Parameters:

CorpNum - 연동회원 사업자번호

queryType - 수집유형, 매출, 매입, 수탁 중 반환

Returns:

작업아이디(jobID)

Throws:

PopbillException

requestJob

String requestJob(String CorpNum,
                  QueryType queryType,
                  String DType,
                  String SDate,
                  String EDate,
                  String UserID)
           throws PopbillException

홈택스 전자(세금)계산서 수집 요청

Parameters:

CorpNum - 연동회원 사업자번호

queryType - 수집유형, 매출,매입,수탁 중 반환

UserID - 연동회원 아이디

Returns:

작업아이디(jobID)

Throws:

PopbillException

getJobState

HTTaxinvoiceJobState getJobState(String CorpNum,
                                 String JobID)
                          throws PopbillException

수집 상태 확인

Parameters:

CorpNum - 연동회원 사업자번호

JobID - 수집요청시 반환받은 작업아이디

Returns:

수집 상태 (see. com.popbill.api.httaxinvoice.HTTaxinvoiceJobState)

Throws:

PopbillException

getJobState

HTTaxinvoiceJobState getJobState(String CorpNum,
                                 String JobID,
                                 String UserID)
                          throws PopbillException

수집 상태 확인

Parameters:

CorpNum - 연동회원 사업자번호

JobId - 수집요청시 반환받은 작업아이디

UserID - 연동회원 아이디

Returns:

수집 상태 (see. com.popbill.api.httaxinvoice.HTTaxinvoiceJobState)

Throws:

PopbillException

listActiveJob

HTTaxinvoiceJobState[] listActiveJob(String CorpNum)
                              throws PopbillException

수집 상태 목록 확인

Parameters:

CorpNum - 연동회원 사업자번호

Returns:

수집상태 배열 (see. com.popbill.api.httaxinvoice.HTTaxinvoiceJobState)

Throws:

PopbillException

listActiveJob

HTTaxinvoiceJobState[] listActiveJob(String CorpNum,
                                     String UserID)
                              throws PopbillException

수집 상태 확인

Parameters:

CorpNum - 연동회원 사업자번호

UserID - 연동회원 아이디

Returns:

수집 상태 (see. com.popbill.api.httaxinvoice.HTTaxinvoiceJobState)

Throws:

PopbillException

search

HTTaxinvoiceSearchResult search(String CorpNum,
                                String JobID,
                                String[] Type,
                                String[] TaxType,
                                String[] PurposeType,
                                String TaxRegIDYN,
                                String TaxRegIDType,
                                String TaxRegID,
                                Integer Page,
                                Integer PerPage,
                                String Order)
                         throws PopbillException

수집 결과 조회

Parameters:

CorpNum - 연동회원 사업자번호

JobID - 작업 아이디

Type - 문서형태 배열

TaxType - 과세형태 배열

PurposeType - 영수/청구 배열

TaxRegIDYN - 종사업장 유무

TaxRegIDType - 종사업장번호 사업자 유형

TaxRegID - 종사업장번호, 다수 기재시 콤마(",")로 구분하여 구성

Page - 페이지 번호

PerPage - 페이지당 검색개수

Order - 정렬방향

Returns:

수집 결과 (see. com.popbill.api.httaxinvoice.HTTaxinvoiceSearchResult)

Throws:

PopbillException

search

HTTaxinvoiceSearchResult search(String CorpNum,
                                String JobID,
                                String[] Type,
                                String[] TaxType,
                                String[] PurposeType,
                                String TaxRegIDYN,
                                String TaxRegIDType,
                                String TaxRegID,
                                Integer Page,
                                Integer PerPage,
                                String Order,
                                String UserID)
                         throws PopbillException

수집 결과 조회

Parameters:

CorpNum - 연동회원 사업자번호

JobID - 작업 아이디

Type - 문서형태 배열

TaxType - 과세형태 배열

PurposeType - 영수/청구 배열

TaxRegIDYN - 종사업장 유무

TaxRegIDType - 종사업장번호 사업자 유형

TaxRegID - 종사업장번호, 다수 기재시 콤마(",")로 구분하여 구성

Page - 페이지 번호

PerPage - 페이지당 검색개수

Order - 정렬방향

UserID - 연동회원 아이디

Returns:

수집 결과 (see. com.popbill.api.httaxinvoice.HTTaxinvoiceSearchResult)

Throws:

PopbillException

search

HTTaxinvoiceSearchResult search(String CorpNum,
                                String JobID,
                                String[] Type,
                                String[] TaxType,
                                String[] PurposeType,
                                String TaxRegIDYN,
                                String TaxRegIDType,
                                String TaxRegID,
                                Integer Page,
                                Integer PerPage,
                                String Order,
                                String UserID,
                                String SearchString)
                         throws PopbillException

수집 결과 조회

Parameters:

CorpNum - 연동회원 사업자번호

JobID - 작업 아이디

Type - 문서형태 배열

TaxType - 과세형태 배열

PurposeType - 영수/청구 배열

TaxRegIDYN - 종사업장 유무

TaxRegIDType - 종사업장번호 사업자 유형

TaxRegID - 종사업장번호, 다수 기재시 콤마(",")로 구분하여 구성

Page - 페이지 번호

PerPage - 페이지당 검색개수

Order - 정렬방향

UserID - 연동회원 아이디

SearchString - 검색어

Returns:

수집 결과 (see. com.popbill.api.httaxinvoice.HTTaxinvoiceSearchResult)

Throws:

PopbillException

summary

HTTaxinvoiceSummary summary(String CorpNum,
                            String JobID,
                            String[] Type,
                            String[] TaxType,
                            String[] PurposeType,
                            String TaxRegIDYN,
                            String TaxRegIDType,
                            String TaxRegID)
                     throws PopbillException

수집 결과 요약정보 조회

Parameters:

CorpNum - 연동회원 사업자번호

JobID - 수집요청시 반환받은 작업아이디

Type - 문서형태 배열

TaxType - 과세형태 배열

PurposeType - 영수/청구 배열

TaxRegIDYN - 종사업장 유무

TaxRegIDType - 종사업장번호 사업자 유형

TaxRegID - 종사업장번호, 다수 기재시 콤마(",")로 구분하여 구성

Returns:

수집 결과 요약정보 (see. com.popbill.api.httaxinvoice.HTTaxinvoiceSearchSummary)

Throws:

PopbillException

summary

HTTaxinvoiceSummary summary(String CorpNum,
                            String JobID,
                            String[] Type,
                            String[] TaxType,
                            String[] PurposeType,
                            String TaxRegIDYN,
                            String TaxRegIDType,
                            String TaxRegID,
                            String UserID)
                     throws PopbillException

수집 결과 요약정보 조회

Parameters:

CorpNum - 연동회원 사업자번호

JobID - 수집요청시 반환받은 작업아이디

Type - 문서형태 배열

TaxType - 과세형태 배열

PurposeType - 영수/청구 배열

TaxRegIDYN - 종사업장 유무

TaxRegIDType - 종사업장번호 사업자 유형

TaxRegID - 종사업장번호, 다수 기재시 콤마(",")로 구분하여 구성

UserID - 연동회원 아이디

Returns:

수집 결과 요약정보 (see. com.popbill.api.httaxinvoice.HTTaxinvoiceSearchSummary)

Throws:

PopbillException

summary

HTTaxinvoiceSummary summary(String CorpNum,
                            String JobID,
                            String[] Type,
                            String[] TaxType,
                            String[] PurposeType,
                            String TaxRegIDYN,
                            String TaxRegIDType,
                            String TaxRegID,
                            String UserID,
                            String SearchString)
                     throws PopbillException

수집 결과 요약정보 조회

Parameters:

CorpNum - 연동회원 사업자번호

JobID - 수집요청시 반환받은 작업아이디

Type - 문서형태 배열

TaxType - 과세형태 배열

PurposeType - 영수/청구 배열

TaxRegIDYN - 종사업장 유무

TaxRegIDType - 종사업장번호 사업자 유형

TaxRegID - 종사업장번호, 다수 기재시 콤마(",")로 구분하여 구성

UserID - 연동회원 아이디

SearchString - 검색어

Returns:

수집 결과 요약정보 (see. com.popbill.api.httaxinvoice.HTTaxinvoiceSearchSummary)

Throws:

PopbillException

getTaxinvoice

HTTaxinvoice getTaxinvoice(String CorpNum,
                           String NTSConfirmNum)
                    throws PopbillException

상세정보 확인 - JSON

Parameters:

CorpNum - 연동회원 사업자번호

NTSConfirmNum - 국세청승인번호

Returns:

전자(세금)계산서 상세정보 (see. com.popbill.api.httaxinvoice.HTTaxinvoice)

Throws:

PopbillException

getTaxinvoice

HTTaxinvoice getTaxinvoice(String CorpNum,
                           String NTSConfirmNum,
                           String UserID)
                    throws PopbillException

상세정보 확인 - JSON

Parameters:

CorpNum - 연동회원 사업자번호

NTSConfirmNum - 국세청승인번호

UserID - 연동회원 아이디

Returns:

전자(세금)계산서 상세정보 (see. com.popbill.api.httaxinvoice.HTTaxinvoice)

Throws:

PopbillException

getXML

HTTaxinvoiceXMLResponse getXML(String CorpNum,
                               String NTSConfirmNum)
                        throws PopbillException

상세정보 확인 - XML

Parameters:

CorpNum - 연동회원 사업자번호

NTSConfirmNum - 국세청 승인번호

Returns:

전자(세금)계산서 XML 정보 (see. com.popbill.api.httaxinvoiceHTTaxinvoiceXMLResponse)

Throws:

PopbillException

getXML

HTTaxinvoiceXMLResponse getXML(String CorpNum,
                               String NTSConfirmNum,
                               String UserID)
                        throws PopbillException

상세정보 확인 - XML

Parameters:

CorpNum - 연동회원 사업자번호

NTSConfirmNum - 국세청승인번호

UserID - 연동회원 아이디

Returns:

전자(세금)계산서 XML 정보 (see. com.popbill.api.httaxinvoiceHTTaxinvoiceXMLResponse)

Throws:

PopbillException

getFlatRateState

FlatRateState getFlatRateState(String CorpNum)
                        throws PopbillException

정액제 서비스 상태 확인

Parameters:

CorpNum - 연동회원 사업자번호

Returns:

정액제 서비스 상태 (see. com.popbill.api.FlatRateState)

Throws:

PopbillException

getFlatRateState

FlatRateState getFlatRateState(String CorpNum,
                               String UserID)
                        throws PopbillException

정액제 서비스 상태 확인

Parameters:

CorpNum - 연동회원 사업자번호

UserID - 연동회원 아이디

Returns:

정액제 서비스 상태 (see. com.popbill.api.FlatRateState)

Throws:

PopbillException

getCertificatePopUpURL

String getCertificatePopUpURL(String CorpNum)
                       throws PopbillException

홈택스연계 공인인증서 등록 URL 확인

Parameters:

CorpNum - 연동회원 사업자번호

Returns:

홈택스연계 공인인증서 등록 URL

Throws:

PopbillException

getCertificatePopUpURL

String getCertificatePopUpURL(String CorpNum,
                              String UserID)
                       throws PopbillException

홈택스연계 공인인증서 등록 URL 확인

Parameters:

CorpNum - 연동회원 사업자번호

UserID - 연동회원 아이디

Returns:

홈택스연계 공인인증서 등록 URL

Throws:

PopbillException

getCertificateExpireDate

Date getCertificateExpireDate(String CorpNum)
                       throws PopbillException

홈택스연계 공인인증서 만료일시 확인

Parameters:

CorpNum - 연동회원 사업자번호.

Returns:

만료일시

Throws:

PopbillException

getPopUpURL

String getPopUpURL(String CorpNum,
                   String NTSConfirmNum)
            throws PopbillException

홈택스 전자세금계산서 팝업 URL

Parameters:

CorpNum - 연동회원 사업자번호

NTSConfirmNum - 세금계산서 국세청 승인번호

Returns:

Throws:

PopbillException

getPopUpURL

String getPopUpURL(String CorpNum,
                   String NTSConfirmNum,
                   String UserID)
            throws PopbillException

홈택스 전자세금계산서 팝업 URL

Parameters:

CorpNum - 연동회원 사업자번호

NTSConfirmNum - 세금계산서 국세청 승인번호

UserID - 회원아이디

Returns:

Throws:

PopbillException

getPrintURL

String getPrintURL(String CorpNum,
                   String NTSConfirmNum)
            throws PopbillException

홈택스 전자세금계산서 인쇄 팝업 URL

Parameters:

CorpNum - 연동회원 사업자번호

NTSConfirmNum - 세금계산서 국세청 승인번호

Returns:

Throws:

PopbillException

getPrintURL

String getPrintURL(String CorpNum,
                   String NTSConfirmNum,
                   String UserID)
            throws PopbillException

홈택스 전자세금계산서 인쇄 팝업 URL

Parameters:

CorpNum - 연동회원 사업자번호

NTSConfirmNum - 세금계산서 국세청 승인번호

UserID - 연동회원 아이디

Returns:

Throws:

PopbillException

checkCertValidation

Response checkCertValidation(String CorpNum)
                      throws PopbillException

홈택스 공인인증서 로그인 테스트

Parameters:

CorpNum - 연동회원 사업자번호

Returns:

Response

Throws:

PopbillException

registDeptUser

Response registDeptUser(String corpNum,
                        String deptUserID,
                        String deptUserPWD)
                 throws PopbillException

부서사용자 계정등록

Parameters:

corpNum - 연동회원 사업자번호

deptUserID - 홈택스 부서사용자 계정 아이디

deptUserPWD - 홈택스 부서사용자 계정 비밀번호

Returns:

Response

Throws:

PopbillException

checkDeptUser

Response checkDeptUser(String CorpNum)
                throws PopbillException

부서사용자 등록정보 확인

Parameters:

CorpNum - 연동회원 사업자번호

UserID -

Returns:

Response

Throws:

PopbillException

checkLoginDeptUser

Response checkLoginDeptUser(String CorpNum)
                     throws PopbillException

부서사용자 로그인 테스트

Parameters:

CorpNum - 연동회원 사업자번호

Returns:

Response

Throws:

PopbillException

deleteDeptUser

Response deleteDeptUser(String CorpNum)
                 throws PopbillException

부서사용자 등록정보 삭제

Parameters:

CorpNum - 연동회원 사업자번호

Returns:

Response

Throws:

PopbillException