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

1. 내역 수집

1.1. RequestJob - 수집 요청

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

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

• 주기적으로 자체 DB에 세금계산서 정보를 INSERT 하는 경우, {dtype} 값을 "S"로 하는 것을 권장합니다.

Parameters

순번	변수명	타입	길이	필수	설명
	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
	keytype	string	-	Y	세금계산서 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
	dtype	string	-	Y	조회할 일자 유형 (택 1) W작성일자 I발행일자 S전송일자
	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	작업 아이디 [RequestJob - 수집 요청]의 반환값
	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