POPBill Developers
가이드

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

API Reference

서비스에 대한 정확한 이해로
최적의 구현방식을 적용합니다.

SDK

다수 개발자에게 검증받은
SDK Example을 제공합니다.

추가 개발언어는 신청주시면
검토 후 지원합니다.
Webhook(웹훅)

팝빌에서 발생한 이벤트 정보를
고객사 서버로 즉시 전송합니다.

API Reference
전자세금계산서
Node.js
API Reference 전자세금계산서 Node.js 객체정보

A. 객체정보

Response

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

IssueResponse

순번변수명타입길이설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
ntsConfirmNum string 24 국세청승인번호
세금계산서 발행 시점에 팝빌에서 자동으로 할당

PopbillException

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

MgtKeyType

순번변수명타입길이설명
SELL enum - 매출
BUY enum - 매입
TRUSTEE enum - 수탁

Taxinvoice - 입력부

순번변수명타입길이필수설명
issueType string 3 Y 발행형태 (택 1)
정발행
역발행
위수탁
taxType string 2 Y 과세형태 (택 1)
과세
영세
면세
chargeDirection string 3 Y 과금방향 (택 1)
정과금 공급자 과금
역과금 공급받는자 과금
-{issueType}="정발행", "역발행", "위수탁" 경우 정과금 가능
-{issueType}="역발행" 경우 역과금 가능
serialNum string 30 N 일련번호
kwon number 4 N 책번호 "권" 항목
정수만 입력 가능
ho number 4 N 책번호 "호" 항목
정수만 입력 가능
writeDate string 8 Y 작성일자
형식 : yyyyMMdd
purposeType string 2 Y 영수/청구 (택 1)
영수
청구
없음
supplyCostTotal string 18 Y 공급가액 합계
정수만 입력 가능(소수점 자동 절사)
taxTotal string 18 Y 세액 합계
정수만 입력 가능(소수점 자동 절사)
totalAmount string 18 Y 합계금액
정수만 입력 가능(소수점 자동 절사)
cash string 18 N 현금
chkBill string 18 N 수표
credit string 18 N 외상
note string 18 N 어음
remark1 string 150 조건부 비고1
{invoiceeType}="외국인" 경우
외국인등록번호 또는 여권번호 필수 입력
remark2 string 150 N 비고2
remark3 string 150 N 비고3
invoicerMgtKey string 24 조건부 공급자 문서번호
문서 관리를 위해 파트너가 할당하는 고유 식별번호
영문 대소문자, 숫자, 특수문자('-', '_')만 입력 가능
{issueType}="정발행" 경우 필수
invoicerCorpNum string 10 Y 공급자 사업자번호 ('-' 제외)
invoicerTaxRegID string 4 N 공급자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
invoicerCorpName string 200 Y 공급자 상호
invoicerCEOName string 100 Y 공급자 대표자 성명
invoicerAddr string 300 N 공급자 주소
invoicerBizType string 100 N 공급자 업태
invoicerBizClass string 100 N 공급자 종목
invoicerContactName string 100 N 공급자 담당자 성명
invoicerDeptName string 100 N 공급자 담당자 부서명
invoicerTEL string 20 N 공급자 담당자 연락처
invoicerHP string 20 N 공급자 담당자 휴대폰
invoicerEmail string 100 N 공급자 담당자 이메일
invoicerSMSSendYN boolean - N 공급자 알림문자 전송 여부
true전송
false미전송 : 기본값
수신자 : 공급받는자 휴대폰번호 {invoiceeHP1}
문자 전송 포인트가 차감(단, 전송실패 건은 환불)
{issueType}="정발행" 경우
세금계산서 발행시점에 알림문자 전송
invoiceeMgtKey string 24 조건부 공급받는자 문서번호
문서 관리를 위해 파트너가 할당하는 고유 식별번호
영문 대소문자, 숫자, 특수문자('-', '_')만 입력 가능
{issueType}="역발행" 경우 필수
invoiceeType string - Y 공급받는자 구분 (택 1)
사업자
개인
외국인
invoiceeCorpNum string 13 Y 공급받는자 등록번호 ('-' 제외)
- {invoiceeType}="사업자" 경우 사업자번호
- {invoiceeType}="개인" 경우 주민등록번호
- {invoiceeType}="외국인" 경우 "9999999999999"
invoiceeTaxRegID string 4 N 공급받는자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
invoiceeCorpName string 200 Y 공급받는자 상호
invoiceeCEOName string 100 Y 공급받는자 대표자 성명
invoiceeAddr string 300 N 공급받는자 주소
invoiceeBizType string 100 N 공급받는자 업태
invoiceeBizClass string 100 N 공급받는자 종목
invoiceeContactName1 string 100 N 공급받는자 담당자 성명
invoiceeDeptName1 string 100 N 공급받는자 담당자 부서명
invoiceeTEL1 string 20 N 공급받는자 담당자 연락처
invoiceeHP1 string 20 N 공급받는자 담당자 휴대폰
invoiceeEmail1 string 100 N 공급받는자 담당자 이메일
invoiceeSMSSendYN boolean - N 공급받는자 알림문자 전송 여부
true전송
false미전송 : 기본값
수신자 : 공급자 휴대폰번호 {invoicerHP}
문자 전송 포인트가 차감(단, 전송실패 건은 환불)
{issueType}="역발행" 경우
세금계산서 역발행 요청시점에 알림문자 전송
trusteeMgtKey string 24 조건부 수탁자 문서번호
문서 관리를 위해 파트너가 할당하는 고유 식별번호
영문 대소문자, 숫자, 특수문자('-', '_')만 입력 가능
{issueType}="위수탁" 경우 필수
trusteeCorpNum string 10 조건부 수탁자 사업자번호 ('-' 제외)
{issueType}="위수탁" 경우 필수
trusteeTaxRegID string 4 N 수탁자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
trusteeCorpName string 200 조건부 수탁자 상호
{issueType}="위수탁" 경우 필수
trusteeCEOName string 100 조건부 수탁자 대표자 성명
{issueType}="위수탁" 경우 필수
trusteeAddr string 300 N 수탁자 주소
trusteeBizType string 100 N 수탁자 업태
trusteeBizClass string 100 N 수탁자 종목
trusteeContactName string 100 N 수탁자 담당자 성명
trusteeDeptName string 100 N 수탁자 담당자 부서명
trusteeTEL string 20 N 수탁자 담당자 연락처
trusteeHP string 20 N 수탁자 담당자 휴대폰
trusteeEmail string 100 N 수탁자 담당자 이메일
trusteeSMSSendYN boolean - N 수탁자 알림문자 전송여부
true전송
false미전송 : 기본값
수신자 : 공급받는자 휴대폰번호 {invoiceeHP1}
문자 전송 포인트가 차감(단, 전송실패 건은 환불)
{issueType}="위수탁" 경우
세금계산서 발행시점에 알림문자 전송
modifyCode number 1 조건부 수정 사유코드
수정세금계산서 작성시 필수 [참고] 수정세금계산서
orgNTSConfirmNum string 24 조건부 당초승인번호
수정세금계산서 작성시 필수
businessLicenseYN boolean - N 팝빌에 등록된 사업자등록증 첨부 여부
true첨부
false미첨부 : 기본값
팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록
bankBookYN boolean - N 팝빌에 등록된 통장사본 첨부 여부
true첨부
false미첨부 : 기본값
팝빌 사이트 또는 [GetSealURL - 인감 및 첨부문서 등록 팝업 URL]을 이용하여 등록
detailList List<TaxinvoiceDetail> N 품목 상세정보
최대 : 99개
addContactList List<TaxinvoiceAddContact> N 공급받는자 추가담당자 정보
여러 담당자에게 발행 안내 메일을 보내야할 경우 사용
최대 : 5명
memo string 200 N 세금계산서 상태 이력을 관리하기 위한 메모
대량(Bulk)발행 경우 사용
emailSubject string 300 N 세금계산서 발행 안내메일 제목
기본값 : 팝빌에서 설정한 안내메일 제목

Taxinvoice - 출력부

순번변수명타입길이설명
ntsconfirmNum string 24 국세청승인번호
세금계산서 발행 시점에 팝빌에서 자동으로 할당
issueType string 3 발행형태
정발행
역발행
위수탁
taxType string 2 과세형태
과세
영세
면세
chargeDirection string 3 과금방향
정과금 공급자 과금
역과금 공급받는자 과금
serialNum string 30 일련번호
kwon number 4 책번호 "권" 항목
ho number 4 책번호 "호" 항목
writeDate string 8 작성일자
형식 : yyyyMMdd
purposeType string 2 영수/청구
영수
청구
없음
supplyCostTotal string 18 공급가액 합계
taxTotal string 18 세액 합계
totalAmount string 18 합계금액
cash string 18 현금
chkBill string 18 수표
credit string 18 외상
note string 18 어음
remark1 string 150 비고1
{invoiceeType}="외국인" 경우
외국인등록번호 또는 여권번호 반환
remark2 string 150 비고2
remark3 string 150 비고3
invoicerMgtKey string 24 공급자 문서번호
문서 관리를 위해 파트너가 할당하는 고유 식별번호
invoicerCorpNum string 10 공급자 사업자번호 ('-' 제외)
invoicerTaxRegID string 4 공급자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
invoicerCorpName string 200 공급자 상호
invoicerCEOName string 100 공급자 대표자 성명
invoicerAddr string 300 공급자 주소
invoicerBizType string 100 공급자 업태
invoicerBizClass string 100 공급자 종목
invoicerContactName string 100 공급자 담당자 성명
invoicerDeptName string 100 공급자 담당자 부서명
invoicerTEL string 20 공급자 담당자 연락처
invoicerHP string 20 공급자 담당자 휴대폰
invoicerEmail string 100 공급자 담당자 이메일
invoicerSMSSendYN boolean - 공급자 알림문자 전송 여부
true전송
false미전송
수신자 : 공급받는자 휴대폰번호 {invoiceeHP1}
invoiceeMgtKey string 24 공급받는자 문서번호
문서 관리를 위해 파트너가 할당하는 고유 식별번호
invoiceeType string 3 공급받는자 구분
사업자
개인
외국인
invoiceeCorpNum string 13 공급받는자 등록번호 ('-' 제외)
- {invoiceeType}="사업자" 경우 사업자번호
- {invoiceeType}="개인" 경우 주민등록번호
- {invoiceeType}="외국인" 경우 "9999999999999"
invoiceeTaxRegID string 4 공급받는자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
invoiceeCorpName string 200 공급받는자 상호
invoiceeCEOName string 100 공급받는자 대표자 성명
invoiceeAddr string 300 공급받는자 주소
invoiceeBizType string 100 공급받는자 업태
invoiceeBizClass string 100 공급받는자 종목
closeDownState number 1 공급받는자 휴폐업상태
  • null미확인
  • 0미등록
  • 1사업중
  • 2폐업
  • 3휴업
  • 4확인실패
세금계산서 발행시 거래처 사업자등록상태조회 하여 결과값 반환
closeDownStateDate string 8 공급받는자 휴폐업일자
형식 : yyyyMMdd
{closeDownState}=2 or 3 경우 반환
invoiceeContactName1 string 100 공급받는자 담당자 성명
invoiceeDeptName1 string 100 공급받는자 담당자 부서명
invoiceeTEL1 string 20 공급받는자 담당자 연락처
invoiceeHP1 string 20 공급받는자 담당자 휴대폰
invoiceeEmail1 string 100 공급받는자 담당자 이메일
invoiceeSMSSendYN boolean - 공급받는자 알림문자 전송 여부
true전송
false미전송
수신자 : 공급자 휴대폰번호 {invoicerHP}
trusteeMgtKey string 24 수탁자 문서번호
수탁자의 문서 관리를 위해 파트너가 할당하는 식별번호
trusteeCorpNum string 10 수탁자 사업자번호 ('-' 제외)
trusteeTaxRegID string 4 수탁자 종사업장 식별번호
종사업장 식별번호는 4자리 숫자로만 구성
trusteeCorpName string 200 수탁자 상호
trusteeCEOName string 100 수탁자 대표자 성명
trusteeAddr string 300 수탁자 주소
trusteeBizType string 100 수탁자 업태
trusteeBizClass string 100 수탁자 종목
trusteeContactName string 100 수탁자 담당자 성명
trusteeDeptName string 100 수탁자 담당자 부서명
trusteeTEL string 20 수탁자 담당자 연락처
trusteeHP string 20 수탁자 담당자 휴대폰
trusteeEmail string 100 수탁자 담당자 이메일
trusteeSMSSendYN boolean - 수탁자 알림문자 전송여부
true전송
false미전송
수신자 : 공급받는자 휴대폰번호 {invoiceeHP1}
modifyCode number 1 수정 사유코드
수정세금계산서 작성시 반환 [참고] 수정세금계산서
orgNTSConfirmNum string 24 당초승인번호
수정세금계산서 작성시 반환
businessLicenseYN boolean - 팝빌에 등록된 사업자등록증 첨부 여부
true첨부
false미첨부
bankBookYN boolean - 팝빌에 등록된 통장사본 첨부 여부
true첨부
false미첨부
detailList List<TaxinvoiceDetail> 품목 상세정보
최대 : 99개
addContactList List<TaxinvoiceAddContact> 공급받는자 추가담당자 정보
최대 : 5명

TaxinvoiceDetail

순번변수명타입길이필수설명
serialNum number 2 Y 일련번호
1부터 순차적으로 입력
최대 : 99
purchaseDT string 8 N 거래일자
형식 : yyyyMMdd
itemName string 100 N 품명
spec string 60 N 규격
qty string 12 N 수량
-99999999.99 ~ 999999999.99
소수점 아래 2번째 자리까지 입력 가능
unitCost string 18 N 단가
-99999999999999.99 ~ 999999999999999.99
소수점 아래 2번째 자리까지 입력 가능
supplyCost string 18 N 공급가액
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 자동 절사
tax string 18 N 세액
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 자동 절사
remark string 100 N 비고

TaxinvoiceXML

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

TaxinvoiceAddContact

순번변수명타입길이필수설명
serialNum number 1 Y 일련번호
1부터 순차적으로 입력
최대 : 5
contactName string 100 N 담당자 성명
email string 100 Y 이메일

BulkResponse

순번변수명타입길이설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
receiptID string 24 접수아이디
접수 시점에 팝빌에서 자동으로 할당

BulkTaxinvoiceResult

순번변수명타입길이설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
submitID string 36 접수 시점에 고객사에서 할당한 제출아이디
submitCount number - 세금계산서 접수 건수
successCount number - 세금계산서 발행 성공 건수
failCount number - 세금계산서 발행 실패 건수
txState number 1 접수상태
0접수
1처리중
2처리완료
txResultCode number - 접수 결과코드
- 성공 : 1
- 실패 : 음의 정수 8자리 숫자값 [참고] 오류코드
txStartDT string 14 발행처리 시작일시
형식 : yyyyMMddHHmmss
txEndDT string 14 발행처리 완료일시
형식 : yyyyMMddHHmmss
receiptDT string 14 접수일시
형식 : yyyyMMddHHmmss
issueResult BulkTaxinvoiceIssueResult[] 발행결과
receiptID string 36 접수아이디
접수 시점에 팝빌에서 자동으로 할당

BulkTaxinvoiceIssueResult

순번변수명타입길이설명
invoicerMgtKey string 24 공급자 문서번호
공급자의 문서 관리를 위해 파트너가 할당한 식별번호
trusteeMgtKey string 24 수탁자 문서번호
파트너가 할당한 문서번호
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
ntsconfirmNum string 24 국세청승인번호
세금계산서 발행 시점에 팝빌에서 자동으로 할당
issueDT string 14 발행일시
형식 : yyyyMMddHHmmss

TISearchResult

순번변수명타입길이설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
total string - 총 검색결과 건수
perPage string - 페이지당 목록 건수
pageNum string - 페이지 번호
pageCount string - 페이지 개수
list TaxinvoiceInfo[] 세금계산서 상태/요약정보
함수 [GetInfo – 상태 확인]의 리턴값 구성과 동일
최대 : 1,000건

TaxinvoiceInfo

순번변수명타입길이설명
itemKey string 18 팝빌에서 세금계산서 관리 목적으로 할당한 식별번호
taxType string 2 과세형태
과세
영세
면세
writeDate string 8 작성일자
형식 : yyyyMMdd
regDT string 14 임시저장 일시
형식 : yyyyMMddHHmmss
issueType string 3 발행형태
정발행
역발행
위수탁
supplyCostTotal string 18 공급가액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
taxTotal string 18 세액 합계
정수만 입력 가능
마이너스 금액 입력 가능, 소수점 아래 자동 절사
purposeType string 2 영수/청구
영수
청구
없음
issueDT string 14 발행일시
형식 : yyyyMMddHHmmss
lateIssueYN string - 지연발행 여부
true지연발행
false정상발행
openYN boolean - 개봉 여부
true개봉
false미개봉
{issueType}="정발행" or "위수탁" 경우 공급받는자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리
{issueType}="역발행" 경우 공급자가 세금계산서 보기 버튼을 클릭한 경우 개봉 처리
openDT string 14 개봉일시
형식 : yyyyMMddHHmmss
stateMemo string 200 상태메모
stateCode number 3 상태코드
[참고] 팝빌 상태코드
stateDT string 14 상태 변경일시
형식 : yyyyMMddHHmmss
ntsconfirmNum string 24 국세청승인번호
세금계산서 발행 시점에 팝빌에서 자동으로 할당
ntsresult string 6 국세청 전송결과
ntssendDT string 14 국세청 전송일시
형식 : yyyyMMddHHmmss
ntsresultDT string 14 국세청 결과 수신일시
형식 : yyyyMMddHHmmss
ntssendErrCode string 6 결과코드
[참고] 국세청 결과코드
modifyCode number 1 수정세금계산서 발행시 입력한 사유코드
[참고] 수정세금계산서
interOPYN boolean - 연동문서 여부
trueAPI를 통해 발행한 연동문서
false팝빌 사이트를 통해 발행한 문서
invoicerCorpName string 200 공급자 상호
invoicerCorpNum string 10 공급자 사업자번호
invoicerMgtKey string 24 공급자 문서번호
공급자의 문서 관리를 위해 파트너가 할당한 식별번호
invoicerPrintYN boolean - 공급자 인쇄여부
true인쇄
false미인쇄
invoiceeCorpName string 200 공급받는자 상호
invoiceeCorpNum string 10 공급받는자 사업자번호
invoiceeMgtKey string 24 공급받는자 문서번호
파트너가 할당한 문서번호
invoiceePrintYN boolean - 공급받는자 인쇄여부
true인쇄
false미인쇄
closeDownState number 1 공급받는자 휴폐업상태
  • null미확인
  • 0미등록
  • 1사업중
  • 2폐업
  • 3휴업
  • 4확인실패
closeDownStateDate string 8 공급받는자 휴폐업일자
형식 : yyyyMMdd
trusteeCorpName string 200 수탁자 상호
trusteeCorpNum string 10 수탁자 사업자번호
trusteeMgtKey string 24 수탁자 문서번호
파트너가 할당한 문서번호
trusteePrintYN boolean - 수탁자 인쇄여부
true인쇄
false미인쇄

TaxinvoiceLog

순번변수명타입길이설명
docLogType number 3 로그타입
  • 100임시저장
  • 101수정
  • 102개봉
  • 103수신확인
  • 111메일 재전송
  • 112문자 재전송
  • 113팩스 재전송
  • 122문자 전송결과
  • 123팩스 전송결과
  • 124사업자등록상태 확인
  • 125문서번호 할당
  • 220역발행요청
  • 221역발행요청 거부
  • 222역발행요청 취소
  • 230발행
  • 240발행취소
  • 250국세청전송 요청
  • 251국세청전송 대기중
  • 252국세청전송 진행중
  • 253국세청전송 접수
  • 254국세청전송 성공
  • 255국세청전송 실패
log string 2000 이력정보
procType string 3 처리형태
연동API를 통해 처리함
일반팝빌 사이트를 통해 처리함
시스템팝빌이 처리함
procCorpName string 70 처리회사명
procContactName string 30 처리담당자
procMemo string 200 처리메모
regDT string 14 등록일시
형식 : yyyyMMddHHmmss
ip string 39 아이피

AttachedFile

순번변수명타입길이설명
serialNum number 1 첨부파일 일련번호
attachedFile string 255 파일아이디
팝빌이 첨부파일 관리를 위해 할당한 식별번호
함수 [DeleteFile – 첨부파일 삭제]호출을 위한 필수값
displayName string 255 첨부파일명
regDT string 14 첨부일시
형식 : yyyyMMddHHmmss

EmailSendConfig

순번변수명타입길이설명
emailType string 32 발송 메일 유형
정발행
TAX_ISSUE
공급받는자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_ISSUE_INVOICER
공급자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_CHECK
공급자에게 세금계산서가 수신확인 되었음을 알려주는 메일
TAX_CANCEL_ISSUE
공급받는자에게 세금계산서가 발행취소 되었음을 알려주는 메일
역발행
TAX_REQUEST
공급자에게 세금계산서를 전자서명 하여 발행을 요청하는 메일
TAX_CANCEL_REQUEST
공급받는자에게 세금계산서가 취소 되었음을 알려주는 메일
TAX_REFUSE
공급받는자에게 세금계산서가 거부 되었음을 알려주는 메일
위수탁 발행
TAX_TRUST_ISSUE
공급받는자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_TRUST_ISSUE_TRUSTEE
수탁자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_TRUST_ISSUE_INVOICER
공급자에게 세금계산서가 발행 되었음을 알려주는 메일
TAX_TRUST_CANCEL_ISSUE
공급받는자에게 세금계산서가 발행취소 되었음을 알려주는 메일
TAX_TRUST_CANCEL_ISSUE_INVOICER
공급자에게 세금계산서가 발행취소 되었음을 알려주는 메일
처리결과
TAX_CLOSEDOWN
거래처의 휴폐업 여부를 확인하여 안내하는 메일
TAX_NTSFAIL_INVOICER
세금계산서 국세청 전송실패를 안내하는 메일
정기발송
ETC_CERT_EXPIRATION
팝빌에 등록된 인증서의 만료예정을 안내하는 메일
sendYN boolean - 전송여부
true전송
false미전송

TaxinvoiceCertificate

순번변수명타입길이설명
regDT string 14 등록일시
형식 : yyyyMMddHHmmss
인증서를 팝빌 인증서버에 등록한 시간
expireDT string 14 만료일시
형식 : yyyyMMddHHmmss
팝빌 인증서버에 등록된 인증서의 만료일시
issuerDN string 200 인증서 발급자 DN
subjectDN string 200 등록된 인증서 DN
issuerName string 12 인증서 종류
전자세금용 공동인증서
팝빌 특목용 공동인증서
기타
oid string 30 OID
regContactName string 100 등록 담당자 성명
팝빌 인증서버에 인증서를 등록한 담당자 성명
regContactID string 50 등록 담당자 아이디
팝빌 인증서버에 인증서를 등록한 담당자 팝빌회원 아이디

UseHistoryResult

순번변수명타입길이설명
code number - API 처리에 대한 응답코드
1성공
total number - 총 검색결과 건수
perPage number - 페이지당 목록 건수
pageNum number - 페이지 번호
pageCount number - 페이지 개수
list UseHistory[] 사용내역

UseHistory

순번변수명타입길이설명
itemCode string 3 서비스 코드
  • 110세금계산서
  • 111홈택스수집(세금)
  • 121거래명세서
  • 122청구서
  • 123견적서
  • 124발주서
  • 125입금표
  • 126영수증
  • 140현금영수증
  • 141홈택스수집(현금)
  • 150문자(SMS)
  • 151문자(LMS)
  • 152문자(MMS)
  • 153알림톡
  • 154친구톡(텍스트)
  • 155친구톡(이미지)
  • 160팩스(일반망)
  • 161팩스(지능망)
  • 170사업자등록상태조회
  • 171기업정보조회
  • 180계좌조회
  • 182계좌성명조회
  • 183계좌실명조회
txType string 2 포인트 증감 유형
포인트 증가
  • 11포인트 충전
  • 12조정
  • 13조정
  • 19분배
  • 31환불
  • 32정액제 해지
포인트 감소
  • 21서비스 사용
  • 22조정
  • 23조정
  • 24포인트 결제
  • 25미수금 결제
  • 26포인트 환불
  • 29회수
  • 41후불누적조정
txPoint string 18 증감 포인트
balance string 18 잔여포인트
txDT string 14 포인트 증감 일시
형식 : yyyyMMddHHmmss
userID string 50 담당자 아이디
userName string 100 담당자명

PaymentHistoryResult

순번변수명타입길이설명
code number - API 처리에 대한 응답코드
1성공
total number - 총 검색결과 건수
perPage number - 페이지당 목록 건수
pageNum number - 페이지 번호
pageCount number - 페이지 개수
list PaymentHistory[] 결제내역

PaymentHistory

순번변수명타입길이설명
productType string 3 결제 내용
포인트
정액제
미수금
productName string 30 결제 상품명
settleType string 7 결제유형
무통장
신용카드
실시간계좌이체
settlerName string 100 담당자명
settlerEmail string 100 담당자메일
settleCost string 18 결제금액
settlePoint string 18 충전포인트
settleState number 1 결제상태
  • 1대기
  • 2승인
  • 3실패
  • 45취소
regDT string 14 등록일시
형식 : yyyyMMddHHmmss
stateDT string 14 상태일시
형식 : yyyyMMddHHmmss

RefundHistoryResult

순번변수명타입길이설명
code number - API 처리에 대한 응답코드
1성공
total number - 총 검색결과 건수
perPage number - 페이지당 목록 건수
pageNum number - 페이지 번호
pageCount number - 페이지 개수
list RefundHistory[] 환불내역

RefundHistory

순번변수명타입길이설명
reqDT string 14 신청일시
형식 : yyyyMMddHHmmss
requestPoint string 18 환불 신청포인트
accountBank string 10 환불계좌 은행명
accountNum string 50 환불계좌번호
accountName string 70 환불계좌 예금주명
state number 1 상태
  • 1 접수대기
  • 2 심사중
  • 3 입금대기
  • 4 환불완료
  • 5 취소
reason string 200 환불사유

RefundForm

순번변수명타입길이필수설명
ContactName string 100 Y 담당자명
tel string 20 Y 담당자 연락처
RequestPoint string 18 Y 환불 신청 포인트
AccountBank string 10 Y 은행명
AccountNum string 50 Y 계좌번호
AccountName string 70 Y 예금주명
Reason string 200 N 환불사유

PaymentForm

순번변수명타입길이필수설명
settlerName string 100 N 담당자명
settlerEmail string 100 N 담당자 이메일
notifyHP string 20 N 담당자 휴대폰
무통장 입금 승인 알림톡이 전송될 번호
paymentName string 70 Y 입금자명
settleCost string 18 Y 결제금액

PaymentResponse

순번변수명타입길이설명
code number - 응답코드
message string - 응답메시지
settleCode string 18 정산코드

ChargeInfo

순번변수명타입길이설명
unitCost string 12 발행단가
chargeMethod string 3 과금유형
연동
파트너
rateSystem string 3 과금제도
종량제

JoinForm

순번변수명타입길이필수설명
ID string 50 Y 아이디
6자 이상 50자 이하
Password string 20 Y 비밀번호
8자 이상 20자 이하
영문, 숫자, 특수문자(~!@#$%^&*()_+) 포함
LinkID string 20 Y 파트너 링크아이디
팝빌에서 발급한 링크아이디
CorpNum string 10 Y 사업자번호 ('-' 제외)
CEOName string 100 Y 대표자 성명
CorpName string 200 Y 회사명
Addr string 300 Y 사업장 주소
BizType string 100 Y 업태
BizClass string 100 Y 종목
ContactName string 100 Y 담당자 성명
ContactEmail string 100 Y 담당자 이메일
ContactTEL string 20 Y 담당자 휴대폰

CorpInfo

순번변수명타입길이필수설명
ceoname string 100 Y 대표자 성명
corpName string 200 Y 회사명
addr string 300 Y 주소
bizType string 100 Y 업태
bizClass string 100 Y 종목

ContactInfo - 입력부

순번변수명타입길이필수설명
id string 50 Y 아이디
6자 이상 50자 이하
password string 20 조건부 비밀번호
8자 이상 20자 이하
영문, 숫자, 특수문자(~!@#$%^&*()_+) 포함
함수 [RegistContact - 담당자 추가]호출을 위한 필수값
personName string 100 Y 담당자 성명
tel string 20 Y 담당자 휴대폰
email string 100 Y 담당자 이메일
searchRole number 1 N 담당자 권한
1개인권한
2읽기권한
3회사권한 : 기본값

ContactInfo - 출력부

순번변수명타입길이설명
id string 50 아이디
personName string 100 담당자 성명
tel string 20 담당자 휴대폰
email string 100 담당자 이메일
regDT string 14 등록일시
형식 : yyyyMMddHHmmss
searchRole number 1 담당자 권한
1개인권한
2읽기권한
3회사권한
mgrYN boolean - 관리자 여부
true관리자
false담당자
팝빌 사이트 [마이페이지] > [회사정보] > [담당자 관리]에서 수정 가능
state number 1 계정상태
1사용중

RefundResponse

순번변수명타입길이설명
code number - API 처리에 대한 응답코드
1성공
message string - API 처리에 대한 응답메시지
refundCode string 18 환불코드