POPBill Developers
API Reference

1. 내역 수집

1.1. RequestJob - 수집 요청

홈택스에 신고된 현금영수증 매입/매출 내역 수집을 팝빌에 요청합니다.

  • 최대 3개월 단위로 수집 요청이 가능하며, 수집기한의 제한은 없습니다.
  • API를 호출하고 반환 받은 작업아이디(JobID)는 수집을 요청한 시점으로부터 1시간 동안만 유효합니다.
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 – 수집 요청] API를 호출하고 반환 받은 작업아이디(JobID)를 이용하여 수집 상태를 확인합니다.

  • 수집상태(jobState) = 3(완료) 이면서, 수집 결과코드(errorCode) = 1(수집성공)인 경우 [Search - 수집 내역 확인] 이 가능합니다.
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 - 수집 상태 목록 확인

[RequestJob – 수집 요청] API를 호출하고 반환 받은 작업아이디(JobID) 목록의 수집 상태를 확인합니다.
subroutine listactivejob(string corpnum, ref jobstate ref_returnlist[ ]) throws popbillexception
Parameters
순번변수명타입길이필수설명
corpnum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
ref_returnlist ref JobState[ ] Y 서브루틴 반환 결과값
Return

-

Throws

PopbillException