POPBill Developers
API Reference

A. 객체정보

Response

순번변수명타입길이설명
code int - API 처리에 대한 응답코드
1성공
message str - API 처리에 대한 응답메시지

PopbillException

순번변수명타입길이설명
code int - API 처리 실패에 대한 오류코드
음의 정수 8자리 숫자값 [참고] 오류코드
message str - API 처리 실패에 대한 오류메시지

HTTaxinvoiceJobState

순번변수명타입길이설명
jobID str 18 작업아이디
jobState str 1 수집상태
1대기
2진행
3완료
Type str 2 수집유형
매출
매입
수탁
queryDateType str 9 일자유형
WriteDate작성일자
IssueDate발행일자
SendDate전송일자
queryStDate str 8 시작일자
형식 : yyyyMMdd
queryEnDate str 8 종료일자
형식 : yyyyMMdd
errorCode int - 수집 결과코드
- 성공 : 1
- 실패 : 음의 정수 8자리 숫자값 [참고] 오류코드
errorReason str - 오류메시지
수집실패시 반환되는 사유
jobStartDT str 14 작업 시작일시
형식 : yyyyMMddHHmmss
jobEndDT str 14 작업 종료일시
형식 : yyyyMMddHHmmss
collectCount int - 수집개수
regDT str 14 수집 요청일시
형식 : yyyyMMddHHmmss

HTTaxinvoice

순번변수명타입길이설명
writeDate str 8 작성일자
형식 : yyyyMMdd
issueDT str 14 발행일시
형식 : yyyyMMddHHmmss
invoiceType int 3 전자세금계산서 종류
  • 101세금계산서
  • 102영세율 세금계산서
  • 103위수탁 세금계산서
  • 104수입 세금계산서
  • 105위수탁영세율 세금계산서
  • 201수정세금계산서
  • 202영세율 수정세금계산서
  • 203위수탁 수정세금계산서
  • 204수입 수정세금계산서
  • 205위수탁영세율 수정세금계산서
  • 301계산서
  • 303위수탁 계산서
  • 304수입 계산서
  • 401수정계산서
  • 403위수탁 수정계산서
  • 404수입 수정계산서
taxType str 2 과세형태
과세
영세
면세
taxTotal str 18 세액 합계
supplyCostTotal str 18 공급가액 합계
totalAmount str 18 합계금액
purposeType str 2 영수/청구
영수
청구
없음
serialNum str 30 일련번호
cash str 18 현금
chkBill str 18 수표
credit str 18 외상
note str 18 어음
remark1 str 150 비고1
remark2 str 150 비고2
remark3 str 150 비고3
ntsconfirmNum str 24 국세청승인번호
invoicerCorpNum str 10 공급자 사업자번호
invoicerMgtKey str 24 공급자 문서번호
invoicerTaxRegID str 4 공급자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
invoicerCorpName str 200 공급자 상호
invoicerCEOName str 100 공급자 대표자 성명
invoicerAddr str 300 공급자 주소
invoicerBizType str 100 공급자 업태
invoicerBizClass str 100 공급자 종목
invoicerContactName str 100 공급자 담당자 성명
invoicerDeptName str 100 공급자 담당자 부서명
invoicerTEL str 20 공급자 담당자 연락처
invoicerEmail str 100 공급자 담당자 이메일
invoiceeCorpNum str 13 공급받는자 등록번호 ('-' 제외)
- {invoiceeType}="사업자" 경우 사업자번호
- {invoiceeType}="개인" 경우 주민등록번호
- {invoiceeType}="외국인" 경우 "9999999999999"
invoiceeType str 3 공급받는자 유형
사업자
개인
외국인
invoiceeMgtKey str 24 공급자 문서번호
invoiceeTaxRegID str 4 공급받는자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
invoiceeCorpName str 200 공급받는자 상호
invoicerCEOName str 100 공급받는자 대표자 성명
invoiceeAddr str 300 공급받는자 주소
invoiceeBizType str 100 공급받는자 업태
invoiceeBizClass str 100 공급받는자 종목
invoiceeContactName1 str 100 공급받는자 주) 담당자 성명
invoiceeDeptName1 str 100 공급받는자 주) 담당자 부서명
invoiceeTEL1 str 20 공급받는자 주) 담당자 연락처
invoiceeEmail1 str 100 공급받는자 주) 담당자 이메일
invoiceeContactName2 str 100 공급받는자 부) 담당자 성명
invoiceeDeptName2 str 100 공급받는자 부) 담당자 부서명
invoiceeTEL2 str 20 공급받는자 부) 담당자 연락처
invoiceeEmail2 str 100 공급받는자 부) 담당자 이메일
trusteeCorpNum str 10 수탁자 사업자번호
trusteeMgtKey str 24 수탁자 문서번호
trusteeTaxRegID str 4 수탁자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
trusteeCorpName str 200 수탁자 상호
trusteeCEOName str 100 수탁자 대표자 성명
trusteeAddr str 300 수탁자 주소
trusteeBizType str 100 수탁자 업태
trusteeBizClass str 100 수탁자 종목
trusteeContactName str 100 수탁자 담당자 성명
trusteeDeptName str 100 수탁자 담당자 부서명
trusteeTEL str 20 수탁자 담당자 연락처
trusteeEmail str 100 수탁자 담당자 이메일
modifyCode int 1 수정 사유코드
  • 1기재사항 착오정정
  • 2공급가액 변동
  • 3환입
  • 4계약의 해지
  • 5내국신용장 사후개설
  • 6착오에 의한 이중발행
orgNTSConfirmNum str 24 당초 국세청승인번호
detailList HTTaxinvoiceDetail[] 상세항목
최대 : 99개

HTTaxinvoiceDetail

순번변수명타입길이설명
serialNum int 2 일련번호
purchaseDT str 8 거래일자
형식 : yyyyMMdd
itemName str 100 품명
spec str 60 규격
qty str 12 수량
소수점 아래 2번째 자리까지 반환 가능
마이너스 금액 반환 가능
unitCost str 18 단가
소수점 아래 2번째 자리까지 반환 가능
마이너스 금액 반환 가능
supplyCost str 18 공급가액
마이너스 금액 반환 가능
tax str 18 세액
마이너스 금액 반환 가능
remark str 100 비고

HTTaxinvoiceSearchResult

순번변수명타입길이설명
code int - API 처리에 대한 응답코드
message str - API 처리에 대한 응답메시지
total int - 총 검색결과 건수
perPage int - 페이지당 목록 건수
pageNum int - 페이지 번호
pageCount int - 페이지 개수
list HTTaxinvoiceAbbr[] 세금계산서 요약정보
최대 : 1,000건

HTTaxinvoiceAbbr

순번변수명타입길이설명
ntsconfirmNum str 24 전자세금계산서 국세청승인번호
writeDate str 8 작성일자
형식 : yyyyMMdd
issueDate str 8 발행일자
형식 : yyyyMMdd
sendDate str 8 전송일자
형식 : yyyyMMdd
taxType str 2 과세형태
과세
영세
면세
purposeType str 2 영수/청구
영수
청구
없음
supplyCostTotal str 18 공급가액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
taxTotal str 18 세액 합계
totalAmount str 18 합계금액
remark1 str 450 비고
전자세금계산서 비고1/2/3 값의 합
invoiceType str 2 세금계산서 유형
매입
매출
modifyYN bool - 수정 전자세금계산서 여부
True수정세금계산서
False일반세금계산서
orgNTSConfirmNum str 24 당초 국세청승인번호
purchaseDate str 8 품목1의 거래일자
형식 : yyyyMMdd
itemName str 100 품목1의 품명
spec str 60 품목1의 규격
qty str 12 품목1의 수량
소수점 아래 2번째 자리까지 반환 가능
마이너스 금액 반환 가능
unitCost str 18 품목1의 단가
소수점 아래 2번째 자리까지 반환 가능
마이너스 금액 반환 가능
supplyCost str 18 품목1의 공급가액
마이너스 금액 반환 가능
tax str 18 품목1의 세액
마이너스 금액 반환 가능
remark str 100 품목1의 비고
invoicerCorpNum str 10 공급자 사업자번호
invoicerTaxRegID str 4 공급자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
invoicerCorpName str 200 공급자 상호
invoicerCEOName str 100 공급자 대표자 성명
invoicerEmail str 100 공급자 담당자 이메일
invoiceeCorpNum str 13 공급받는자 등록번호 ('-' 제외)
- {invoiceeType}="사업자" 경우 사업자번호
- {invoiceeType}="개인" 경우 주민등록번호
- {invoiceeType}="외국인" 경우 "9999999999999"
invoiceeType str 3 공급받는자 유형
사업자
개인
외국인
invoiceeTaxRegID str 4 공급받는자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
invoiceeCorpName str 200 공급받는자 상호
invoiceeCEOName str 100 공급받는자 대표자 성명
invoiceeEmail1 str 100 공급받는자 담당자 이메일
invoiceeEmail2 str 70 공급받는자 ASP 연계사업자 메일
trusteeCorpNum str 10 수탁자 사업자번호
trusteeTaxRegID str 4 수탁자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
trusteeCorpName str 200 수탁자 상호
trusteeCEOName str 100 수탁자 대표자 성명
trusteeEmail str 100 수탁자 담당자 이메일

HTTaxinvoiceSummary

순번변수명타입길이설명
count int - 수집 건수
supplyCostTotal int 18 공급가액 합계
taxTotal int 18 세액 합계
amountTotal int 18 총계 (공급가액 합계+세액 합계)

HTTaxinvoiceXMLResponse

순번변수명타입길이설명
ResultCode int - API 처리에 대한 응답코드
1성공
Message str 24 API 처리에 대한 응답메시지
retObject str - 전자세금계산서 XML 문서