2. 수집 내역 확인
2.1. Search - 수집 내역 확인
홈택스에서 수집된 전자세금계산서 매입/매출 내역을 확인합니다.
- 38개 항목으로 구성된 내역 확인이 가능합니다.
htTaxinvoiceService.search(CorpNum, JobID, Type, TaxType, PurposeType, TaxRegIDType, TaxRegIDYN, TaxRegID, Page, PerPage, Order, UserID, SearchString, success, error)- 매개변수 Page, PerPage, Order를 이용하여 페이징 기능을 구현할 수 있습니다.
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| JobID | string | 18 | Y |
작업아이디
[RequestJob - 수집 요청] API의 반환값
|
|
| Type | Array | N |
세금계산서 문서형태 (다중 선택 가능)
N세금계산서
M수정세금계산서
기본값 : 전체조회
|
||
| TaxType | Array | N |
과세형태 (다중 선택 가능)
T과세
N면세
Z영세
기본값 : 전체조회
|
||
| PurposeType | Array | N |
영수/청구 (다중 선택 가능)
R영수
C청구
N없음
기본값 : 전체조회
|
||
| TaxRegIDType | string | - | N |
종사업장번호의 주체
S공급자
B공급받는자
T수탁자
기본값 : 전체조회
|
|
| TaxRegIDYN | string | 1 | N |
종사업장번호 유무
0없음
1있음
기본값 : 전체조회
|
|
| TaxRegID | string | - | Y |
종사업장번호
다수건 검색시 콤마(',')로 구분. 예) 1234,1000
기본값 : 전체조회
|
|
| Page | number | - | 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" 입력 기본값 : 전체조회
|
|
| success | function | - | Y | 성공에 대한 콜백 함수 | |
| error | function | - | Y | 실패에 대한 콜백 함수 | |
Return
Throws
2.2. Summary - 수집 내역 합계
홈택스에서 수집된 전자세금계산서 매입/매출 내역의 합계정보를 제공합니다. ※ 합계정보 - 수집 건수, 공급가액 합계, 세액 합계, 총계 (공급가액 합계+세액 합계)
htTaxinvoiceService.summary(CorpNum, JobID, Type, TaxType, PurposeType, TaxRegIDType, TaxRegIDYN, TaxRegID, UserID, SearchString, success, error)Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| JobID | string | 18 | Y |
작업아이디
[RequestJob - 수집 요청] API의 반환값
|
|
| Type | Array | N |
세금계산서 문서형태 (다중 선택 가능)
N세금계산서
M수정세금계산서
기본값 : 전체조회
|
||
| TaxType | Array | N |
과세형태 (다중 선택 가능)
T과세
N면세
Z영세
기본값 : 전체조회
|
||
| PurposeType | Array | N |
영수/청구 (다중 선택 가능)
R영수
C청구
N없음
기본값 : 전체조회
|
||
| TaxRegIDType | string | - | N |
종사업장번호의 주체
S공급자
B공급받는자
T수탁자
기본값 : 전체조회
|
|
| TaxRegIDYN | string | 1 | N |
종사업장번호 유무
0없음
1있음
기본값 : 전체조회
|
|
| TaxRegID | string | - | Y |
종사업장번호
다수건 검색시 콤마(',')로 구분. 예) 1234,1000
기본값 : 전체조회
|
|
| UserID | string | 50 | N | 팝빌회원 아이디 | |
| SearchString | string | 13 | N |
조회 검색어 ('-' 제외)
- 상호명 조회시 거래처상호 입력 - 사업자 조회시 사업자번호 입력 - 개인 조회시 주민등록번호 입력 - 외국인 조회시 "9999999999999" 입력 기본값 : 전체조회
|
|
| success | function | - | Y | 성공에 대한 콜백 함수 | |
| error | function | - | Y | 실패에 대한 콜백 함수 | |
Return
Throws
2.3. GetTaxinvoice - 수집 상세 확인
홈택스에서 수집된 전자세금계산서 1건의 상세정보를 제공합니다.
- 60개 항목과 99개 품목으로 구성된 정보 확인이 가능합니다.
htTaxinvoiceService.getTaxinvoice(CorpNum, NTSConfirmNum, UserID, success, error)Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| NTSConfirmNum | string | 24 | Y | 전자세금계산서 국세청승인번호 | |
| UserID | string | 50 | N | 팝빌회원 아이디 | |
| success | function | - | Y | 성공에 대한 콜백 함수 | |
| error | function | - | Y | 실패에 대한 콜백 함수 |
Return
Throws
2.4. GetXML - 수집 상세 확인 (XML)
홈택스에서 수집된 전자세금계산서 1건의 상세정보를 XML 데이터 포맷으로 제공합니다.
htTaxinvoiceService.getXML(CorpNum, NTSConfirmNum, UserID, success, error)Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| NTSConfirmNum | string | 24 | Y | 전자세금계산서 국세청승인번호 | |
| UserID | string | 50 | N | 팝빌회원 아이디 | |
| success | function | - | Y | 성공에 대한 콜백 함수 | |
| error | function | - | Y | 실패에 대한 콜백 함수 |
Return
Throws
2.5. GetPopUpURL - 전자세금계산서 보기 팝업 URL
홈택스에서 수집된 전자세금계산서 1건을 확인하는 페이지 팝업 URL을 반환합니다.
- 반환 받은 URL 정보는 30초 동안만 유효합니다.
htTaxinvoiceService.getPopUpURL(CorpNum, NTSConfirmNum, UserID, success, error)Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| NTSConfirmNum | string | 24 | Y | 전자세금계산서 국세청승인번호 | |
| UserID | string | 50 | N | 팝빌회원 아이디 | |
| success | function | - | Y | 성공에 대한 콜백 함수 | |
| error | function | - | Y | 실패에 대한 콜백 함수 |
Return
string - 요청에 대한 응답 URL
Throws
2.6. GetPrintURL - 전자세금계산서 인쇄 팝업 URL
홈택스에서 수집된 전자세금계산서 1건 출력하는 페이지 팝업 URL을 반환합니다.
- 반환 받은 URL 정보는 30초 동안만 유효합니다.
htTaxinvoiceService.getPrintURL(CorpNum, NTSConfirmNum, UserID, success, error)Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | string | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| NTSConfirmNum | string | 24 | Y | 전자세금계산서 국세청승인번호 | |
| UserID | string | 50 | N | 팝빌회원 아이디 | |
| success | function | - | Y | 성공에 대한 콜백 함수 | |
| error | function | - | Y | 실패에 대한 콜백 함수 |
Return
string - 요청에 대한 응답 URL