POPBill Developers
API Reference

1. 내역 수집

1.1. RequestJob - 수집 요청

  • 홈택스에 신고된 전자세금계산서 매입/매출 내역 수집을 팝빌에 요청합니다. (조회기간 단위 : 최대 3개월)
htTaxinvoiceService.requestJob(CorpNum, Type, DType, SDate, EDate, UserID, success, error)
  • 주기적으로 자체 DB에 세금계산서 정보를 INSERT 하는 경우, {DType} 값을 "S"로 하는 것을 권장합니다.
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
Type string 7 Y 세금계산서 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
DType string 1 Y 조회할 일자 유형 (택 1)
W작성일자
I발행일자
S전송일자
SDate string 8 Y 조회 기간의 시작일자
형식 : yyyyMMdd
EDate string 8 Y 조회 기간의 종료일자
형식 : yyyyMMdd
UserID string 50 N 팝빌회원 아이디
success function - Y 성공에 대한 콜백 함수
error function - Y 실패에 대한 콜백 함수
Return

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

Throws

PopbillException

1.2. GetJobState - 수집 상태 확인

htTaxinvoiceService.getJobState(CorpNum, JobID, UserID, success, error)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
JobID string 18 Y 작업 아이디
UserID string 50 N 팝빌회원 아이디
success function - Y 성공에 대한 콜백 함수
error function - Y 실패에 대한 콜백 함수
Return

HTTaxinvoiceJobState

Throws

PopbillException

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

  • 전자세금계산서 매입/매출 내역 수집요청에 대한 상태 목록을 확인합니다.
  • 수집 요청 후 1시간이 경과한 수집 요청건은 상태정보가 반환되지 않습니다.
htTaxinvoiceService.listActiveJob(CorpNum, UserID, success, error)
Parameters
순번변수명타입길이필수설명
CorpNum string 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID string 50 N 팝빌회원 아이디
success function - Y 성공에 대한 콜백 함수
error function - Y 실패에 대한 콜백 함수
Return

HTTaxinvoiceJobState[ ]

Throws

PopbillException