POPBill Developers
API Reference

2. 내역 수집 결과 조회

2.2. Summary - 수집결과 요약정보 조회

  • 함수 [GetJobState – 수집 상태 확인]를 통해 상태 정보가 확인된 작업아이디를 활용하여 수집된 전자세금계산서 매입/매출 내역의 요약 정보를 조회합니다.

    ※ 요약정보: 전자세금계산서 수집 건수, 공급가액 합계, 세액 합계, 합계 금액

function Summary($CorpNum, $JobID, $Type, $TaxType, $PurposeType, $TaxRegIDYN = null, $TaxRegIDType = null, $TaxRegID = null, $UserID = null, $SearchString = null)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
JobID String 18 Y 작업 아이디
Type Array N 세금계산서 문서형태 (다중 선택 가능)
N세금계산서
M수정세금계산서
기본값 : 전체조회
TaxType Array N 과세형태 (다중 선택 가능)
T과세
N면세
Z영세
기본값 : 전체조회
PurposeType Array N 결제대금 수취여부 (다중 선택 가능)
R영수
C청구
N없음
기본값 : 전체조회
TaxRegIDYN String 1 N 종사업장번호 유무
0없음
1있음
기본값 : 전체조회
TaxRegIDType String 1 N 종사업장번호의 주체
S공급자
B공급받는자
T수탁자
기본값 : 전체조회
TaxRegID String - N 종사업장번호
다수건 검색시 콤마(',')로 구분. 예) 1234,1000
기본값 : 전체조회
UserID String 50 N 팝빌회원 아이디
SearchString String 13 N 조회 검색어 ('-' 제외)
- 상호명 조회시 거래처상호 입력
- 사업자 조회시 사업자번호 입력
- 개인 조회시 주민등록번호 입력
- 외국인 조회시 "9999999999999" 입력
기본값 : 전체조회
Return

HTTaxinvoiceSummary

Throws

PopbillException

2.3. GetTaxinvoice - 상세정보 확인 (JSON)

  • 국세청승인번호를 통해 수집한 전자세금계산서 1건의 상세정보를 반환합니다.
function GetTaxinvoice($CorpNum, $NTSConfirmNum, $UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
NTSConfirmNum String 24 Y 전자세금계산서 국세청승인번호
UserID String 50 N 팝빌회원 아이디
Return

HTTaxinvoice

Throws

PopbillException

2.4. GetXML - 상세정보 확인 (XML)

  • 국세청승인번호를 통해 수집한 전자세금계산서 1건의 상세정보를 XML 형태의 문자열로 반환합니다.
function GetXML($CorpNum, $NTSConfirmNum, $UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
NTSConfirmNum String 24 Y 전자세금계산서 국세청승인번호
UserID String 50 N 팝빌회원 아이디
Return

HTTaxinvoiceXMLResponse

Throws

PopbillException

2.5. GetPopUpURL - 홈택스 전자세금계산서 보기 팝업 URL

  • 수집된 전자세금계산서 1건의 상세내역을 확인하는 페이지의 팝업 URL을 반환합니다.
  • 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetPopUpURL($CorpNum , $NTSConfirmNum, $UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
NTSConfirmNum String 24 Y 전자세금계산서 국세청승인번호
UserID String 50 N 팝빌회원 아이디
Return

String - 요청에 대한 응답 URL

Throws

PopbillException

2.6. GetPrintURL - 홈택스 전자세금계산서 인쇄 팝업 URL

  • 수집된 전자세금계산서 1건의 상세내역을 인쇄하는 페이지의 URL을 반환합니다.
  • 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
function GetPrintURL($CorpNum , $NTSConfirmNum, $UserID = null)
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
NTSConfirmNum String 24 Y 전자세금계산서 국세청승인번호
UserID String 50 N 팝빌회원 아이디
Return

String - 요청에 대한 응답 URL

Throws

PopbillException