2. 세금계산서 정보확인

2.1. GetInfo - 상태 확인

세금계산서 1건의 상태 및 요약정보를 확인합니다.
리턴값 TaxinvoiceInfo 의 변수 'stateCode'를 통해 세금계산서의 상태코드를 확인합니다. [참고] 팝빌 상태코드

def getInfo(CorpNum, MgtKeyType, MgtKey):

Parameters

변수명	타입	길이	필수	설명
CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
KeyType	str	-	Y	세금계산서 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
MgtKey	str	24	Y	파트너가 할당한 문서번호

Return

TaxinvoiceInfo

Throws

PopbillException

2.2. GetInfos - 다수건 상태 확인

다수건의 세금계산서 상태 및 요약 정보를 확인합니다. (1회 호출 시 최대 1,000건 확인 가능)
리턴값 TaxinvoiceInfo 의 변수 'stateCode'를 통해 세금계산서의 상태코드를 확인합니다. [참고] 팝빌 상태코드

def getInfos(CorpNum, MgtKeyType, MgtKeyList):

문서번호를 통해 세금계산서 목록을 구현하는 경우 활용합니다.

Parameters

변수명	타입	길이	필수	설명
CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
KeyType	str	-	Y	세금계산서 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
MgtKeyList	list		Y	조회할 세금계산서 문서번호 최대 : 1,000건

Return

TaxinvoiceInfo[ ]

Throws

PopbillException

2.3. GetDetailInfo - 상세정보 확인

세금계산서 1건의 상세정보를 확인합니다.

def getDetailInfo(CorpNum, MgtKeyType, MgtKey):

Parameters

변수명	타입	길이	필수	설명
CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
KeyType	str	-	Y	세금계산서 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
MgtKey	str	24	Y	파트너가 할당한 문서번호

Return

Taxinvoice

Throws

PopbillException

2.4. CheckMgtKeyInUse - 문서번호 사용 여부 확인

파트너가 세금계산서 관리 목적으로 할당하는 문서번호의 사용여부를 확인합니다.
이미 사용 중인 문서번호는 중복 사용이 불가하고, 세금계산서가 삭제된 경우에만 문서번호의 재사용이 가능합니다.

def checkMgtKeyInUse(CorpNum, MgtKeyType, MgtKey):

Parameters

변수명	타입	길이	필수	설명
CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
KeyType	str	-	Y	세금계산서 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
MgtKey	str	24	Y	확인할 문서번호

Return

bool - True : (사용중) / False : (미사용중)

Throws

PopbillException

2.5. GetXML - 상세정보 확인 (XML)

세금계산서 1건의 상세정보를 XML로 반환합니다.

def getXML(CorpNum, MgtKeyType, MgtKey):

Parameters

변수명	타입	길이	필수	설명
CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
KeyType	str	-	Y	세금계산서 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
MgtKey	str	24	Y	파트너가 할당한 문서번호

Return

TaxinvoiceXML

Throws

PopbillException

2.6. Search - 목록 조회

검색조건에 해당하는 세금계산서를 조회합니다. (최대 조회기간 : 6개월)

def search(CorpNum, MgtKeyType, DType, SDate, EDate, State, Type, TaxType, LateOnly, TaxRegIDYN, TaxRegIDType, TaxRegID, Page, PerPage, Order, UserID=None, QString=None, InterOPYN=None, IssueType=None, RegType=None, CloseDownState=None, MgtKey=None):

매개변수 Page, PerPage, Order를 이용하여 페이징 기능을 구현할 수 있습니다.

Parameters

변수명	타입	길이	필수	설명
CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
KeyType	str	-	Y	세금계산서 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
DType	str	1	Y	조회 기준일자 유형 (택 1) R등록일자 W작성일자 I발행일자
SDate	str	8	Y	조회 기간의 시작일자 형식 : yyyyMMdd
EDate	str	8	Y	조회 기간의 종료일자 형식 : yyyyMMdd
State	list		N	세금계산서 상태코드 2, 3번째 자리에 와일드카드() 사용가능. 예) "3", "60" [참고] 팝빌 상태코드 기본값 : 전체조회
Type	list		N	세금계산서 문서유형 (다중 선택 가능) N세금계산서 M수정세금계산서 기본값 : 전체조회
TaxType	list		N	과세형태 (다중 선택 가능) T과세 N면세 Z영세 기본값 : 전체조회
LateOnly	bool	-	N	지연발행 여부 true지연발행 false정상발행 기본값 : 전체조회
TaxRegIDYN	str	1	N	종사업장번호 유무 0없음 1있음 기본값 : 전체조회
TaxRegIDType	str	1	N	종사업자번호의 주체 (택 1) S공급자 B공급받는자 T수탁자 기본값 : 전체조회
TaxRegID	str	-	N	종사업장번호 다수건 검색시 콤마(',')로 구분. 예) 1234,1000 기본값 : 전체조회
Page	int	-	N	목록 페이지번호 기본값 : 1
PerPage	int	-	N	페이지당 표시할 목록 건수 최대 : 1,000건 기본값 : 500건
Order	str	1	N	조회 기준일자 유형을 기준으로 하는 목록 정렬 방향 D내림차순 : 기본값 A오름차순
UserID	str	50	N	팝빌회원 아이디
Qstring	str	-	N	조회 검색어 ('-' 제외) - 상호명 조회시 거래처상호 입력 - 사업자 조회시 사업자번호 입력 - 개인 조회시 주민등록번호 입력 - 외국인 조회시 "9999999999999" 입력 기본값 : 전체조회
InterOPYN	str	1	N	세금계산서 작성유형 0팝빌 사이트를 통해 작성한 세금계산서 1API로 작성한 세금계산서 기본값 : 전체조회
IssueType	list		N	발행형태 (다중 선택 가능) N정발행 R역발행 T위수탁발행 기본값 : 전체조회
RegType	list		N	전자세금계산서 등록 유형 (다중 선택 가능) P팝빌에서 등록(발행) H홈택스 또는 ASP에서 등록(발행) 기본값 : 전체조회
CloseDownState	list		N	휴폐업상태 (다중 선택 가능) N미확인 0미등록 1사업중 2폐업 3휴업 4확인실패 기본값 : 전체조회
MgtKey	str	-	N	문서번호 세금계산서의 문서번호 또는 국세청승인번호 중 검색하고자 하는 정보 입력 기본값 : 전체조회

Return

TISearchResult

Throws

PopbillException

2.7. GetLogs - 세금계산서 상태 변경이력 확인

세금계산서의 상태에 대한 변경이력을 확인합니다.

def getLogs(CorpNum, MgtKeyType, MgtKey):

Parameters

변수명	타입	길이	필수	설명
CorpNum	str	10	Y	팝빌회원 사업자번호 ('-' 제외)
KeyType	str	-	Y	세금계산서 유형 (택 1) SELL매출 BUY매입 TRUSTEE위수탁
MgtKey	str	24	Y	파트너가 할당한 문서번호

Return

TaxinvoiceLog[ ]

Throws

PopbillException