2. 내역 수집 결과 조회
2.1. Search - 수집 결과 조회
- 함수 [GetJobState – 수집 상태 확인]를 통해 상태 정보가 확인된 작업아이디를 활용하여 수집된 전자세금계산서 매입/매출 내역을 조회합니다.
function Search(CorpNum : String; JobID : String; DocType : Array Of String; TaxType : Array Of String; PurposeType : Array Of String; TaxRegIDType : String; TaxRegID : String; TaxRegIDYN : String; Page : Integer; PerPage : Integer; Order : String; UserID : String = ''; SearchString : String = '') : THomeTaxTISearchList;
- 페이지 정보(Page, PerPage, Order) 항목을 사용하여 전자세금계산서 매입/매출 내역 조회 목록 페이징 기능을 구현할 수 있습니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
JobID | String | 18 | Y |
작업 아이디
[RequestJob - 수집 요청]의 반환값
|
|
DocType | Array Of String | N |
세금계산서 문서형태 (다중 선택 가능)
N세금계산서
M수정세금계산서
기본값 : 전체조회
|
||
TaxType | Array Of String | N |
과세형태 (다중 선택 가능)
T과세
N면세
Z영세
기본값 : 전체조회
|
||
PurposeType | Array Of String | 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 | Integer | - | 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 : String; JobID : String; DocType : Array Of String; TaxType : Array Of String; PurposeType : Array Of String; TaxRegIDType : String; TaxRegID : String; TaxRegIDYN : String; UserID : String = ''; SearchString : String = '') : TTaxinvoiceSummary;
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
JobID | String | 18 | Y |
작업 아이디
[RequestJob - 수집 요청]의 반환값
|
|
DocType | Array Of String | N |
세금계산서 문서형태 (다중 선택 가능)
N세금계산서
M수정세금계산서
기본값 : 전체조회
|
||
TaxType | Array Of String | N |
과세형태 (다중 선택 가능)
T과세
N면세
Z영세
기본값 : 전체조회
|
||
PurposeType | Array Of String | 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 : String; NTSConfirmNum : String; UserID : String) : THomeTaxTaxinvoice;
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
NTSConfirmNum | String | 24 | Y | 전자세금계산서 국세청승인번호 | |
UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.4. GetXML - 상세정보 확인 (XML)
- 국세청승인번호를 통해 수집한 전자세금계산서 1건의 상세정보를 XML 형태의 문자열로 반환합니다.
function GetXML(CorpNum : String; NTSConfirmNum : String; UserID : String ) : TGetXMLResponse;
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 : String; NTSConfirmNum : String; UserID : String = '') : 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 : String; NTSConfirmNum : String; UserID : String = '') : String;
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
NTSConfirmNum | String | 24 | Y | 전자세금계산서 국세청승인번호 | |
UserID | String | 50 | N | 팝빌회원 아이디 |
Return
String - 요청에 대한 응답 URL