POPBill Developers
연동신청
  • 가이드 0
  • 레퍼런스 0
  • 오류코드 0
홈택스수집(현금)
  • 전자세금계산서
  • 현금영수증
  • 전자명세서
  • 홈택스수집(세금)
  • 홈택스수집(현금)
  • 사업자등록상태조회
  • 기업정보조회
  • 계좌조회
  • 예금주조회
  • 카카오톡
  • 문자
  • 팩스
PowerBuilder
  • Java
  • PHP
  • .NET
  • .NET Core
  • Node.js
  • Python
  • Ruby
  • ASP
  • Delphi
  • PowerBuilder
  • Visual Basic
  • MS Access
SDK 레퍼런스

홈택스 수집 요청

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 팝빌회원 아이디
응답

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

예외
PopbillException

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 팝빌회원 아이디
응답
JobState
예외
PopbillException

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 서브루틴 반환 결과값
응답

-

예외
PopbillException