2. 세금계산서 정보확인

2.1. GetInfo - 상태 확인

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

Function GetInfo(CorpNum As String, KeyType As MgtKeyType, MgtKey As String, Optional UserID As String = "") As PBTIInfo

Parameters

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

Return

PBTIInfo

Throws

Err

2.2. GetInfos - 다수건 상태 확인

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

Function GetInfos(CorpNum As String, KeyType As MgtKeyType, MgtKeyList As Collection, Optional UserID As String = "") As Collection

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

Parameters

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

Return

PBTIInfo[ ]

Throws

Err

2.3. GetDetailInfo - 상세정보 확인

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

Function GetDetailInfo(CorpNum As String, KeyType As MgtKeyType, MgtKey As String, Optional UserID As String = "") As PBTaxinvoice

Parameters

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

Return

PBTaxinvoice

Throws

Err

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

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

Function checkMgtKeyInUse(CorpNum As String, KeyType As MgtKeyType, MgtKey As String) As PBResponse

Parameters

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

Return

PBResponse

Throws

Err

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

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

Function GetXML(CorpNum As String, KeyType As MgtKeyType, MgtKey As String, Optional UserID As String = "") As PBTaxinvoiceXML

Parameters

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

Return

PBTaxinvoiceXML

Throws

Err

2.6. Search - 목록 조회

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

Function Search(CorpNum As String, KeyType As MgtKeyType, DType As String, SDate As String, EDate As String, state As Collection, TType As Collection, taxType As Collection, LateOnly As String, Page As Integer, PerPage As Integer, Order As String, Optional TaxRegIDType As String, Optional TaxRegID As String, Optional TaxRegIDYN As String, Optional QString As String, Optional UserID As String = "", Optional interOPYN As String = "", Optional issueType As Collection = Null, Optional regType As Collection = Null, Optional closeDownState As Collection = Null, Optional mgtKey As String = "")

페이지 관련 항목(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	Collection		N	세금계산서 상태코드 2, 3번째 자리에 와일드카드() 사용가능. 예) "3", "60" [참고] 팝빌 상태코드 기본값 : 전체조회
TType	Collection		N	세금계산서 문서유형 (다중 선택 가능) N세금계산서 M수정세금계산서 기본값 : 전체조회
taxType	Collection		N	과세형태 (다중 선택 가능) T과세 N면세 Z영세 기본값 : 전체조회
LateOnly	String	-	Y	지연발행 여부 1지연발행 0정상발행 기본값 : 전체조회
Page	Integer	-	N	목록 페이지번호 기본값 : 1
PerPage	Integer	-	N	페이지당 표시할 목록 건수 최대 : 1,000건 기본값 : 500건
Order	String	1	Y	조회 기준일자 유형을 기준으로 하는 목록 정렬 방향 D내림차순 : 기본값 A오름차순
TaxRegIDType	String	1	N	종사업자번호의 주체 (택 1) S공급자 B공급받는자 T수탁자 기본값 : 전체조회
TaxRegID	String	-	N	종사업장번호 다수건 검색시 콤마(',')로 구분. 예) 1234,1000 기본값 : 전체조회
TaxRegIDYN	String	1	N	종사업장번호 유무 0없음 1있음 기본값 : 전체조회
QString	String	-	N	조회 검색어 ('-' 제외) - 상호명 조회시 거래처상호 입력 - 사업자 조회시 사업자번호 입력 - 개인 조회시 주민등록번호 입력 - 외국인 조회시 "9999999999999" 입력 기본값 : 전체조회
UserID	String	50	N	팝빌회원 아이디
interOPYN	String	1	N	세금계산서 작성유형 0팝빌 사이트를 통해 작성한 세금계산서 1API로 작성한 세금계산서 기본값 : 전체조회
issueType	Collection		N	발행형태 (다중 선택 가능) N정발행 R역발행 T위수탁발행 기본값 : 전체조회
regType	Collection		N	전자세금계산서 등록 유형 (다중 선택 가능) P팝빌에서 등록(발행) H홈택스 또는 ASP에서 등록(발행) 기본값 : 전체조회
closeDownState	Collection		N	휴폐업상태 (다중 선택 가능) N미확인 0미등록 1사업중 2폐업 3휴업 4확인실패 기본값 : 전체조회
mgtKey	String	-	N	문서번호 세금계산서의 문서번호 또는 국세청승인번호 중 검색하고자 하는 정보 입력 기본값 : 전체조회

Return

PBTISearchList

Throws

Err

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

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

Function GetLogs(CorpNum As String, KeyType As MgtKeyType, MgtKey As String, Optional UserID As String = "") As Collection

Parameters

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

Return

PBTILog[ ]

Throws

Err

2.8. GetURL - 팝빌 세금계산서 문서함 팝업 URL

로그인 상태로 팝빌 사이트의 전자세금계산서 문서함 메뉴에 접근할 수 있는 페이지의 팝업 URL을 반환합니다.
반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.

Function GetURL(CorpNum As String, UserID As String, TOGO As String) As String

Parameters

변수명	타입	길이	필수	설명
CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
UserID	String	50	N	팝빌회원 아이디
TOGO	String	-	Y	접근 메뉴 (택 1) TBOX임시 문서함 SWBOX매출 발행 대기함 SBOX매출 문서함 PWBOX매입 발행 대기함 PBOX매입 문서함 WRITE정발행 작성

Return

String - 요청에 대한 응답 URL

Throws

Err