POPBill Developers
API Reference

2. 세금계산서 정보확인

2.1. GetInfo - 상태 확인

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

TaxinvoiceInfo

Throws

PopbillException

2.2. GetInfos - 다수건 상태 확인

  • 다수건의 세금계산서 상태 및 요약 정보를 확인합니다. (1회 호출 시 최대 1,000건 확인 가능)
  • 리턴값 TaxinvoiceInfo 의 변수 'stateCode'를 통해 세금계산서의 상태코드를 확인합니다. [참고] 팝빌 상태코드
TaxinvoiceInfo[] getInfos(String CorpNum, MgtKeyType KeyType, String[] MgtKeyList) throws PopbillException
  • 문서번호를 통해 세금계산서 목록을 구현하는 경우 활용합니다.
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
KeyType MgtKeyType - Y 세금계산서 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
MgtKeyList String[ ] Y 조회할 세금계산서 문서번호
최대 : 1,000건
Return

TaxinvoiceInfo[ ]

Throws

PopbillException

2.3. GetDetailInfo - 상세정보 확인

  • 세금계산서 1건의 상세정보를 확인합니다.
Taxinvoice getDetailInfo(String CorpNum, MgtKeyType KeyType, String MgtKey) throws PopbillException
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
KeyType MgtKeyType - Y 세금계산서 유형
SELL매출
BUY매입
TRUSTEE위수탁
MgtKey String 24 Y 파트너가 할당한 문서번호
Return

Taxinvoice

Throws

PopbillException

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

  • 파트너가 세금계산서 관리 목적으로 할당하는 문서번호의 사용여부를 확인합니다.
  • 이미 사용 중인 문서번호는 중복 사용이 불가하고, 세금계산서가 삭제된 경우에만 문서번호의 재사용이 가능합니다.
Boolean checkMgtKeyInUse(String CorpNum, MgtKeyType KeyType, String MgtKey) throws PopbillException
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
KeyType MgtKeyType - Y 세금계산서 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
MgtKey String 24 Y 파트너가 할당한 문서번호
Return

Boolean - true : (사용중) / false : (미사용중)

Throws

PopbillException

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

  • 세금계산서 1건의 상세정보를 XML로 반환합니다.
TaxinvoiceXML getXML(String CorpNum, MgtKeyType KeyType, String MgtKey, String UserID) throws PopbillException
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
KeyType MgtKeyType - Y 세금계산서 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
MgtKey String 24 Y 파트너가 할당한 문서번호
UserID String 50 N 팝빌회원 아이디
Return

TaxinvoiceXML

Throws

PopbillException

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

  • 세금계산서의 상태에 대한 변경이력을 확인합니다.
TaxinvoiceLog[] getLogs(String CorpNum, MgtKeyType KeyType, String MgtKey) throws PopbillException
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
KeyType MgtKeyType - Y 세금계산서 유형 (택 1)
SELL매출
BUY매입
TRUSTEE위수탁
MgtKey String 24 Y 파트너가 할당한 문서번호
Return

TaxinvoiceLog[ ]

Throws

PopbillException

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

  • 로그인 상태로 팝빌 사이트의 전자세금계산서 문서함 메뉴에 접근할 수 있는 페이지의 팝업 URL을 반환합니다.
  • 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
String getURL(String CorpNum, String UserID, String TOGO) throws PopbillException
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID String 50 N 팝빌회원 아이디
TOGO String - Y 접근 메뉴 (택 1)
  • TBOX임시 문서함
  • SWBOX매출 발행 대기함
  • SBOX매출 문서함
  • PWBOX매입 발행 대기함
  • PBOX매입 문서함
  • WRITE정발행 작성
Return

String - 요청에 대한 응답 URL

Throws

PopbillException