com.popbill.api

Interface HTCashbillService

All Superinterfaces:

BaseService

All Known Implementing Classes:

HTCashbillServiceImp

public interface HTCashbillService
extends BaseService

Hometax Cashbill 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) 정액제 서비스 상태 확인
HTCashbillJobState	getJobState(String CorpNum, String JobID) 수집 상태 확인
HTCashbillJobState	getJobState(String CorpNum, String JobID, String UserID) 수집 상태 확인
HTCashbillJobState[]	listActiveJob(String CorpNum) 수집 상태 목록 확인
HTCashbillJobState[]	listActiveJob(String CorpNum, String UserID) 수집 상태 목록 확인
Response	registDeptUser(String CorpNum, String DeptUserID, String DeptUserPWD) 부서사용자 계정등록
String	requestJob(String CorpNum, QueryType queryType, String SDate, String EDate) 수집 요청
String	requestJob(String CorpNum, QueryType queryType, String SDate, String EDate, String UserID) 수집 요청
HTCashbillSearchResult	search(String CorpNum, String JobID, String[] TradeUsage, String[] TradeType, Integer Page, Integer PerPage, String Order) 수집 결과 조회
HTCashbillSearchResult	search(String CorpNum, String JobID, String[] TradeUsage, String[] TradeType, Integer Page, Integer PerPage, String Order, String UserID) 수집 결과 조회
HTCashbillSummary	summary(String CorpNum, String JobID, String[] TradeUsage, String[] TradeType) 수집 결과 요약정보 조회
HTCashbillSummary	summary(String CorpNum, String JobID, String[] TradeUsage, String[] TradeType, String UserID) 수집 결과 요약정보 조회

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

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 SDate,
                  String EDate)
           throws PopbillException

수집 요청

Parameters:

CorpNum - 연동회원 사업자번호

queryType - 현금영수증 유형, SELL-매출 현금영수증, BUY-매입 현금영수증

SDate - 시작일자 (yyyyMMdd)

EDate - 종료일자 (yyyyMMdd)

Returns:

작업아이디 (jobID)

Throws:

PopbillException

requestJob

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

수집 요청

Parameters:

CorpNum - 연동회원 사업자번호

queryType - 현금영수증 유형, SELL-매출 현금영수증, BUY-매입 현금영수증

SDate - 시작일자 (yyyyMMdd)

EDate - 종료일자 (yyyyMMdd)

UserID - 연동회원 아이디

Returns:

작업아이디 (jobID)

Throws:

PopbillException

getJobState

HTCashbillJobState getJobState(String CorpNum,
                               String JobID)
                        throws PopbillException

수집 상태 확인

Parameters:

CorpNum - 연동회원 사업자번호

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

Returns:

수집 상태 (see. com.popbill.api.htcashbill.HTCashbillJobState)

Throws:

PopbillException

getJobState

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

수집 상태 확인

Parameters:

CorpNum - 연동회원 사업자번호

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

UserID - 연동회원 아이디

Returns:

수집 상태 (see. com.popbill.api.htcashbill.HTCashbillJobState)

Throws:

PopbillException

listActiveJob

HTCashbillJobState[] listActiveJob(String CorpNum)
                            throws PopbillException

수집 상태 목록 확인

Parameters:

CorpNum - 연동회원 사업자번호

Returns:

수집상태 배열 (see. com.popbill.api.htcashbill.HTCashbillJobState)

Throws:

PopbillException

listActiveJob

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

수집 상태 목록 확인

Parameters:

CorpNum - 연동회원 사업자번호

UserID - 연동회원 아이디

Returns:

수집상태 배열 (see. com.popbill.api.htcashbill.HTCashbillJobState)

Throws:

PopbillException

search

HTCashbillSearchResult search(String CorpNum,
                              String JobID,
                              String[] TradeUsage,
                              String[] TradeType,
                              Integer Page,
                              Integer PerPage,
                              String Order)
                       throws PopbillException

수집 결과 조회

Parameters:

CorpNum - 연동회원 사업자번호

JobID - 작업 아이디

TradeUsage - 거래용도 배열, P-소득공제용, C-지출증빙용

TradeType - 현금영수증 형태 배열, N-일반현금영수증, C-취소현금영수증

Page - 페이지 번호

PerPage - 페이지당 검색개수

Order - 정렬방향

Returns:

수집 결과 (see. com.popbill.api.htcashbill.HTCashbillSearchResult)

Throws:

PopbillException

search

HTCashbillSearchResult search(String CorpNum,
                              String JobID,
                              String[] TradeUsage,
                              String[] TradeType,
                              Integer Page,
                              Integer PerPage,
                              String Order,
                              String UserID)
                       throws PopbillException

수집 결과 조회

Parameters:

CorpNum - 연동회원 사업자번호

JobID - 작업 아이디

TradeUsage - 거래용도 배열, P-소득공제용, C-지출증빙용

TradeType - 현금영수증 형태 배열, N-일반현금영수증, C-취소현금영수증

Page - 페이지 번호

PerPage - 페이지당 검색개수

Order - 정렬방향

UserID - 연동회원 아이디

Returns:

수집 결과 (see. com.popbill.api.htcashbill.HTCashbillSearchResult)

Throws:

PopbillException

summary

HTCashbillSummary summary(String CorpNum,
                          String JobID,
                          String[] TradeUsage,
                          String[] TradeType)
                   throws PopbillException

수집 결과 요약정보 조회

Parameters:

CorpNum - 연동회원 사업자번호

JobID - 작업 아이디

TradeUsage - 거래용도 배열, P-소득공제용, C-지출증빙용

TradeType - 현금영수증 형태 배열, N-일반현금영수증, C-취소현금영수증

Returns:

수집 결과 (see. com.popbill.api.htcashbil.HTCashbillSummary)

Throws:

PopbillException

summary

HTCashbillSummary summary(String CorpNum,
                          String JobID,
                          String[] TradeUsage,
                          String[] TradeType,
                          String UserID)
                   throws PopbillException

수집 결과 요약정보 조회

Parameters:

CorpNum - 연동회원 사업자번호

JobID - 작업 아이디

TradeUsage - 거래용도 배열, P-소득공제용, C-지출증빙용

TradeType - 현금영수증 형태 배열, N-일반현금영수증, C-취소현금영수증

UserID - 연동회원 아이디

Returns:

수집 결과 (see. com.popbill.api.htcashbil.HTCashbillSummary)

Throws:

PopbillException

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

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

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

getCertificateExpireDate

Date getCertificateExpireDate(String CorpNum)
                       throws PopbillException

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

Parameters:

CorpNum - 연동회원 사업자번호

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 - 연동회원 사업자번호

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

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

Returns:

Response

Throws:

PopbillException

checkDeptUser

Response checkDeptUser(String CorpNum)
                throws PopbillException

부서사용자 등록정보 확인

Parameters:

CorpNum - 연동회원 사업자번호

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