2. 내역 수집 결과 조회
2.1. Search - 수집 결과 조회
- 함수 [GetJobState – 수집 상태 확인]를 통해 상태 정보가 확인된 작업아이디를 활용하여 수집된 전자세금계산서 매입/매출 내역을 조회합니다.
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 - 수집 요청]의 반환값
|
|
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 - 수집 요청] 함수의 {DType}을 기준으로 하는 목록 정렬 방향
|
|
UserID | String | 50 | N | 팝빌회원 아이디 | |
SearchString | String | 13 | N |
조회 검색어 ('-' 제외)
- 상호명 조회시 거래처상호 입력 - 사업자 조회시 사업자번호 입력 - 개인 조회시 주민등록번호 입력 - 외국인 조회시 "9999999999999" 입력 기본값 : 전체조회
|
Return
Throws
2.2. Summary - 수집결과 요약정보 조회
-
함수 [GetJobState – 수집 상태 확인]를 통해 상태 정보가 확인된 작업아이디를 활용하여 수집된 전자세금계산서 매입/매출 내역의 요약 정보를 조회합니다.
※ 요약정보: 전자세금계산서 수집 건수, 공급가액 합계, 세액 합계, 합계 금액
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 - 수집 요청]의 반환값
|
|
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 - 상세정보 확인 (JSON)
- 국세청승인번호를 통해 수집한 전자세금계산서 1건의 상세정보를 반환합니다.
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초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
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초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
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