POPBill Developers
API Reference

1. 내역 수집

1.1. RequestJob - 수집 요청

  • 홈택스에 신고된 현금영수증 매입/매출 내역 수집을 팝빌에 요청합니다. (조회기간 단위 : 최대 3개월)
String RequestJob(String CorpNum, KeyType cbType, String SDate, String EDate, String UserID)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리)
cbType KeyType - Y 현금영수증 유형 : SELL / BUY 중 택 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 - 수집 상태 확인

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

HTCashbillJobState

Throws

PopbillException

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

  • 현금영수증 매입/매출 내역 수집요청에 대한 상태 목록을 확인합니다.
  • 수집 요청 후 1시간이 경과한 수집 요청건은 상태정보가 반환되지 않습니다.
List<HTCashbillJobState> ListActiveJob(String CorpNum, String UserID)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 (하이픈 '-' 제외 10자리)
UserID String 50 N 팝빌회원 아이디
Return

List<HTCashbillJobState>

Throws

PopbillException