2. 수집 내역 확인
2.1. Search - 수집 내역 확인
홈택스에서 수집된 전자세금계산서 매입/매출 내역을 확인합니다.
- 38개 항목으로 구성된 내역 확인이 가능합니다.
Function Search(CorpNum As String, jobID As String, tiType As Collection, taxType As Collection, purposeType As Collection, taxRegIDType As String, taxRegID As String, taxRegIDYN As String, page As Integer, perPage As Integer, order As String, Optional UserID As String = "", Optional SearchString As String = "") As PBHTTaxinvoiceSearch
- 매개변수 Page, PerPage, Order를 이용하여 페이징 기능을 구현할 수 있습니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
jobID | String | 18 | Y |
작업아이디
[RequestJob - 수집 요청] API의 반환값
|
|
tiType | Collection | N |
세금계산서 문서형태 (다중 선택 가능)
N세금계산서
M수정세금계산서
기본값 : 전체조회
|
||
taxType | Collection | N |
과세형태 (다중 선택 가능)
T과세
N면세
Z영세
기본값 : 전체조회
|
||
purposeType | Collection | N |
영수/청구 (다중 선택 가능)
R영수
C청구
N없음
기본값 : 전체조회
|
||
taxRegIDType | String | - | N |
종사업장번호의 주체
S공급자
B공급받는자
T수탁자
기본값 : 전체조회
|
|
taxRegID | String | - | Y |
종사업장번호
다수건 검색시 콤마(',')로 구분. 예) 1234,1000
기본값 : 전체조회
|
|
taxRegIDYN | String | 1 | N |
종사업장번호 유무
0없음
1있음
기본값 : 전체조회
|
|
page | Integer | - | N |
목록 페이지번호
기본값 : 1
|
|
perPage | String | - | N |
페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
|
|
order | String | 1 | Y |
목록 정렬 방향
D내림차순 : 기본값
A오름차순
[RequestJob - 수집 요청] API의 매개변수 {DType} 기준
|
|
UserID | String | 50 | N | 팝빌회원 아이디 | |
SearchString | String | 13 | N |
조회 검색어 ('-' 제외)
- 상호명 조회시 거래처상호 입력 - 사업자 조회시 사업자번호 입력 - 개인 조회시 주민등록번호 입력 - 외국인 조회시 "9999999999999" 입력 기본값 : 전체조회
|
Return
Throws
2.2. Summary - 수집 내역 합계
홈택스에서 수집된 전자세금계산서 매입/매출 내역의 합계정보를 제공합니다. ※ 합계정보 - 수집 건수, 공급가액 합계, 세액 합계, 총계 (공급가액 합계+세액 합계)
Function Summary(CorpNum As String, jobID As String, tiType As Collection, taxType As Collection, purposeType As Collection, taxRegIDType As String, taxRegID As String, taxRegIDYN As String, Optional UserID As String = "", Optional SearchString As String = "") As PBHTTaxinvoiceSummary
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
jobID | String | 18 | Y |
작업아이디
[RequestJob - 수집 요청] API의 반환값
|
|
tiType | Collection | N |
세금계산서 문서형태 (다중 선택 가능)
N세금계산서
M수정세금계산서
기본값 : 전체조회
|
||
taxType | Collection | N |
과세형태 (다중 선택 가능)
T과세
N면세
Z영세
기본값 : 전체조회
|
||
purposeType | Collection | N |
영수/청구 (다중 선택 가능)
R영수
C청구
N없음
기본값 : 전체조회
|
||
taxRegIDType | String | - | N |
종사업장번호의 주체
S공급자
B공급받는자
T수탁자
기본값 : 전체조회
|
|
taxRegID | String | - | Y |
종사업장번호
다수건 검색시 콤마(',')로 구분. 예) 1234,1000
기본값 : 전체조회
|
|
taxRegIDYN | String | 1 | N |
종사업장번호 유무
0없음
1있음
기본값 : 전체조회
|
|
UserID | String | 50 | N | 팝빌회원 아이디 | |
SearchString | String | 13 | N |
조회 검색어 ('-' 제외)
- 상호명 조회시 거래처상호 입력 - 사업자 조회시 사업자번호 입력 - 개인 조회시 주민등록번호 입력 - 외국인 조회시 "9999999999999" 입력 기본값 : 전체조회
|
Return
Throws
2.3. GetTaxinvoice - 수집 상세 확인
홈택스에서 수집된 전자세금계산서 1건의 상세정보를 제공합니다.
- 60개 항목과 99개 품목으로 구성된 정보 확인이 가능합니다.
Function GetTaxinvoice(CorpNum As String, ntsconfirmNum As String, Optional UserID As String = "") As PBHTTaxinvoice
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
ntsconfirmNum | String | 24 | Y | 전자세금계산서 국세청승인번호 | |
UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.4. GetXML - 수집 상세 확인 (XML)
홈택스에서 수집된 전자세금계산서 1건의 상세정보를 XML 데이터 포맷으로 제공합니다.
Function GetXML(CorpNum As String, ntsconfirmNum As String, Optional UserID As String = "") As PBHTTaxinvoiceXML
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
ntsconfirmNum | String | 24 | Y | 전자세금계산서 국세청승인번호 | |
UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.5. GetPopUpURL - 전자세금계산서 보기 팝업 URL
홈택스에서 수집된 전자세금계산서 1건을 확인하는 페이지 팝업 URL을 반환합니다.
- 반환 받은 URL 정보는 30초 동안만 유효합니다.
Function GetPopUpURL(CorpNum As String, ntsconfirmNum As String, Optional UserID As String = "") As String
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
ntsconfirmNum | String | 24 | Y | 전자세금계산서 국세청승인번호 | |
UserID | String | 50 | N | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL
Throws
2.6. GetPrintURL - 전자세금계산서 인쇄 팝업 URL
홈택스에서 수집된 전자세금계산서 1건 출력하는 페이지 팝업 URL을 반환합니다.
- 반환 받은 URL 정보는 30초 동안만 유효합니다.
Function GetPrintURL(CorpNum As String, ntsconfirmNum As String, Optional UserID As String = "") As String
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
ntsconfirmNum | String | 24 | Y | 전자세금계산서 국세청승인번호 | |
UserID | String | 50 | N | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL