API Reference 홈택스연동 Java 내역 수집

1. 내역 수집

1.1. RequestJob - 수집 요청

• 홈택스에 신고된 현금영수증 매입/매출 내역 수집을 팝빌에 요청합니다. (조회기간 단위 : 최대 3개월)

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

Parameters

순번	변수명	타입	길이	필수	설명
	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
	QueryType	QueryType	-	Y	현금영수증 유형 (택 1) SELL매출 BUY매입
	SDate	String	8	Y	조회 기간의 시작일자 형식 : yyyyMMdd
	EDate	String	8	Y	조회 기간의 종료일자 형식 : yyyyMMdd
	UserID	String	50	N	팝빌회원 아이디

Return

String - 요청에 대한 작업아이디(JobID)

Throws

PopbillException

1.2. GetJobState - 수집 상태 확인

• 함수 [RequestJob – 수집 요청]를 통해 반환 받은 작업 아이디의 상태를 확인합니다.
• [Search – 수집 결과 조회] 또는 [Summary – 수집결과 요약정보 조회]를 사용하기 전에 수집 작업의 진행 상태, 수집 작업의 성공 여부를 확인해야 합니다.

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

Parameters

순번	변수명	타입	길이	필수	설명
	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
	JobID	String	18	Y	작업 아이디
	UserID	String	50	N	팝빌회원 아이디

Return

HTCashbillJobState

Throws

PopbillException

1.3. ListActiveJob - 수집 상태 목록 확인

• 현금영수증 매입/매출 내역 수집요청에 대한 상태 목록을 확인합니다.
• 수집 요청 후 1시간이 경과한 수집 요청건은 상태정보가 반환되지 않습니다.

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

Parameters

순번	변수명	타입	길이	필수	설명
	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
	UserID	String	50	N	팝빌회원 아이디

Return

HTCashbillJobState[ ]

Throws

PopbillException