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
Throws
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
Throws
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
Throws
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
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
Throws
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 | 
						휴폐업상태 (다중 선택 가능)
						
 기본값 : 전체조회 
					 | 
				||
| MgtKey | str | - | N | 
						문서번호
						 세금계산서의 문서번호 또는 국세청승인번호 중 검색하고자 하는 정보 입력 
						기본값 : 전체조회 
					 | 
				|
Return
Throws
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
Throws
2.8. GetURL - 세금계산서 문서함 팝업 URL
			
		- 전자세금계산서 문서함의 팝업 URL을 반환합니다.
 - 권장 사이즈 : width = 1,280px (최소 1,000px) / height = 800px
 - 반환되는 URL은 30초 동안만 사용이 가능합니다.
 - 반환되는 URL은 팝빌회원의 로그인 세션을 포함하고 있으니 사용에 유의하여 주시기 바랍니다.
 
def getURL(CorpNum, UserID, ToGo):
	
	
	
	
	
	
	Parameters
| 순번 | 변수명 | 타입 | 길이 | 필수 | 설명 | 
|---|---|---|---|---|---|
| CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
| UserID | str | 50 | N | 팝빌회원 아이디 | |
| ToGo | str | - | Y | 
				접근 메뉴 (택 1)
				
  | 
		
Return
str - 요청에 대한 응답 URL












