2. 세금계산서 정보확인
2.1. GetInfo - 상태 확인
- 세금계산서 1건의 상태 및 요약정보를 확인합니다.
- 리턴값 TaxinvoiceInfo 의 변수 'stateCode'를 통해 세금계산서의 상태코드를 확인합니다. [참고] 팝빌 상태코드
TaxinvoiceInfo getInfo(String CorpNum, MgtKeyType KeyType, String MgtKey, String UserID) throws PopbillExceptionParameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
세금계산서 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | String | 24 | Y | 파트너가 할당한 문서번호 | |
| UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.2. GetInfos - 다수건 상태 확인
- 다수건의 세금계산서 상태 및 요약 정보를 확인합니다. (1회 호출에 최대 1,000건 확인 가능)
- 리턴값 TaxinvoiceInfo 의 변수 'stateCode'를 통해 세금계산서의 상태코드를 확인합니다. [참고] 팝빌 상태코드
TaxinvoiceInfo[] getInfos(String CorpNum, MgtKeyType KeyType, String[] MgtKeyList, String UserID) throws PopbillException- 문서번호를 통해 세금계산서 목록을 구현하는 경우 활용합니다.
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
세금계산서 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKeyList | String[ ] | Y |
조회할 세금계산서 문서번호
최대 : 1,000건
|
||
| UserID | String | 50 | N | 팝빌회원 아이디 | |
Return
Throws
2.3. GetDetailInfo - 상세정보 확인
- 세금계산서 1건의 상세정보를 확인합니다.
Taxinvoice getDetailInfo(String CorpNum, MgtKeyType KeyType, String MgtKey, String UserID) throws PopbillExceptionParameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
세금계산서 유형
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | String | 24 | Y | 파트너가 할당한 문서번호 | |
| UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.4. CheckMgtKeyInUse - 문서번호 사용 여부 확인
- 파트너가 세금계산서 관리 목적으로 할당하는 문서번호의 사용여부를 확인합니다.
- 이미 사용 중인 문서번호는 중복 사용이 불가하고, 세금계산서가 삭제된 경우에만 문서번호의 재사용이 가능합니다.
Boolean checkMgtKeyInUse(String CorpNum, MgtKeyType KeyType, String MgtKey, String UserID) throws PopbillExceptionParameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
세금계산서 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | String | 24 | Y | 파트너가 할당한 문서번호 | |
| UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Boolean - true : (사용중) / false : (미사용중)
Throws
2.5. GetXML - 상세정보 확인(XML)
- 세금계산서 1건의 상세정보를 XML로 반환합니다.
TaxinvoiceXML getXML(String CorpNum, MgtKeyType KeyType, String MgtKey, String UserID) throws PopbillExceptionParameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
세금계산서 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | String | 24 | Y | 파트너가 할당한 문서번호 | |
| UserID | String | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.6. Search - 목록 조회
- 검색조건에 해당하는 세금계산서를 조회합니다. (최대 조회기간 : 6개월)
TISearchResult Search(String CorpNum, MgtKeyType KeyType, String DType, String SDate, String EDate, String[] State, String[] Type, String[] TaxType, String[] IssueType, Boolean LateOnly, String TaxRegIDType, String TaxRegID, String TaxRegIDYN, String QString, Integer Page, Integer PerPage, String Order, String InterOPYN, String[] RegType, String[] CloseDownState, String MgtKey, String UserID) throws PopbillException- 매개변수 Page, PerPage, Order를 이용하여 페이징 기능을 구현할 수 있습니다.
Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
세금계산서 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| DType | String | 1 | Y |
조회 기준일자 유형 (택 1)
R등록일자
W작성일자
I발행일자
|
|
| SDate | String | 8 | Y |
조회 기간의 시작일자
형식 : yyyyMMdd
|
|
| EDate | String | 8 | Y |
조회 기간의 종료일자
형식 : yyyyMMdd
|
|
| State | String[ ] | N |
세금계산서 상태코드
2, 3번째 자리에 와일드카드(*) 사용가능. 예) "3**", "60*"
[참고] 팝빌 상태코드
기본값 : 전체조회
|
||
| Type | String[ ] | N |
세금계산서 문서유형 (다중 선택 가능)
N세금계산서
M수정세금계산서
기본값 : 전체조회
|
||
| TaxType | String[ ] | N |
과세형태 (다중 선택 가능)
T과세
N면세
Z영세
기본값 : 전체조회
|
||
| IssueType | String[ ] | N |
발행형태 (다중 선택 가능)
N정발행
R역발행
T위수탁발행
기본값 : 전체조회
|
||
| LateOnly | Boolean | - | N |
지연발행 여부
true지연발행
false정상발행
기본값 : 전체조회
|
|
| TaxRegIDType | String | 1 | N |
종사업자번호의 주체 (택 1)
S공급자
B공급받는자
T수탁자
기본값 : 전체조회
|
|
| TaxRegID | String | - | N |
종사업장번호
다수건 검색시 콤마(',')로 구분. 예) 1234,1000
기본값 : 전체조회
|
|
| TaxRegIDYN | String | 1 | N |
종사업장번호 유무
0없음
1있음
기본값 : 전체조회
|
|
| QString | String | - | N |
조회 검색어 ('-' 제외)
- 상호명 조회시 거래처상호 입력 - 사업자 조회시 사업자번호 입력 - 개인 조회시 주민등록번호 입력 - 외국인 조회시 "9999999999999" 입력 기본값 : 전체조회
|
|
| Page | Integer | - | N |
목록 페이지번호
기본값 : 1
|
|
| PerPage | Integer | - | N |
페이지당 표시할 목록 건수
최대 : 1,000건
기본값 : 500건
|
|
| Order | String | 1 | N |
조회 기준일자 유형을 기준으로 하는 목록 정렬 방향
D내림차순 : 기본값
A오름차순
|
|
| InterOPYN | String | 1 | N |
세금계산서 작성유형
0팝빌 사이트를 통해 작성한 세금계산서
1API로 작성한 세금계산서
기본값 : 전체조회
|
|
| RegType | String[ ] | N |
전자세금계산서 등록 유형 (다중 선택 가능)
P팝빌에서 등록(발행)
H홈택스 또는 ASP에서 등록(발행)
기본값 : 전체조회
|
||
| CloseDownState | String[ ] | N |
휴폐업상태 (다중 선택 가능)
기본값 : 전체조회
|
||
| MgtKey | String | - | N |
문서번호
세금계산서의 문서번호 또는 국세청승인번호 중 검색하고자 하는 정보 입력
기본값 : 전체조회
|
|
| UserID | String | 50 | N | 팝빌회원 아이디 | |
Return
Throws
2.7. GetLogs - 세금계산서 상태 변경이력 확인
- 세금계산서의 상태에 대한 변경이력을 확인합니다.
TaxinvoiceLog[] getLogs(String CorpNum, MgtKeyType KeyType, String MgtKey, String UserID) throws PopbillExceptionParameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
|---|---|---|---|---|---|
| CorpNum | String | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| KeyType | MgtKeyType | - | Y |
세금계산서 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
|
|
| MgtKey | String | 24 | Y | 파트너가 할당한 문서번호 | |
| UserID | String | 50 | N | 팝빌회원 아이디 |