API Reference 홈택스수집 PowerBuilder 내역 수집

1. 내역 수집

1.1. RequestJob - 수집 요청

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

function string requestjob(string corpnum, string keytype, string sdate, string edate, string userid) throws popbillexception

Parameters

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

Return

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

Throws

PopbillException

1.2. GetJobState - 수집 상태 확인

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

function jobstate getjobstate(string corpnum, string jobid, string userid) throws popbillexception

Parameters

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

Return

JobState

Throws

PopbillException

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

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

subroutine listactivejob(string corpnum, ref jobstate ref_returnlist[ ]) throws popbillexception

Parameters

순번	변수명	타입	길이	필수	설명
	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
	ref_returnlist	ref JobState[ ]		Y	서브루틴 반환 결과값

Return

-

Throws

PopbillException