POPBill Developers
API Reference

A. 객체정보

TResponse

순번변수명타입길이비고
code LongInt - API 처리에 대한 응답코드
message String - API 처리에 대한 응답메시지

EPopbillException

순번변수명타입길이비고
code LongInt - API 처리 실패에 대한 오류코드("-"로 시작하는 8자리 숫자값)
[참고] 오류코드
message String - API 처리 실패에 대한 오류메시지

TBizCheckInfo

순번변수명타입길이비고
corpNum String 10 사업자번호
companyRegNum String 13 법인등록번호
checkDT String 14 기업정보조회일시 (형식 : yyyyMMddHHmmss)
corpName String 256 상호
ceoname String 128 대표자명
corpCode String 3 기업형태코드
  • 100일반회사
  • 101신설회사
  • 102외감
  • 103피합병
  • 110거래소(상장)
  • 111거래소(관리)
  • 112코스닥(등록)
  • 113코스닥(관리)
  • 114코넥스
  • 200폐업
  • 201부도
  • 300휴업
  • 900미정의
  • 999기타
corpScaleCode String 2 기업규모코드
  • 10대기업
  • 11대기업(금융)
  • 20중견기업
  • 21중견기업(하)
  • 30중소기업
  • 90기타(비영리법인)
  • 99기타
personCorpCode String 2 개인/법인코드 : 1 / 2 / 3 중 반환
└ 1 : 법인
└ 2 : 개인
└ 99 : 기타
headOfficeCode String 2 본점/지점코드 1 / 2 / 3 중 반환
└ 1 : 본점
└ 2 : 지점
└ 99 : 기타
industryCode String 6 산업코드
※ 한국표준산업분류(10차) 기준
establishDate String 8 설립일자 (형식 : yyyyMMdd)
establishCode String 2 설립코드
  • 1주식
  • 2합자
  • 3합명
  • 4유한
  • 5조합
  • 6정부투자기관
  • 7개인
  • 8학교
  • 9병원
  • 10단체 또는 협회
  • 11미정의
  • 99기타
workPlaceCode String 2 사업장코드
  • 10본사
  • 20공장
  • 30서울사무소
  • 31사무소
  • 32영업소
  • 33지점
  • 34출장소
  • 40연구소
  • 50건설공장
  • 60창고
  • 99기타
addrCode String 2 주소코드 : 1 / 2 / 3 / 99 중 반환
└ 1 : 도로명
└ 2 : 지번
└ 3 : 입력(입수)
└ 99 : 기타
zipCode String 6 우편번호
addr String 256 주소
addrDetail String 256 상세주소
enAddr String 256 영문주소
bizClass String 4096 업종
bizType String 4096 업태
result String 3 결과코드
[참고] 기업정보조회 결과코드
resultMessage String 4096 결과메시지
closeDownState String 1 휴폐업상태 : 0 / 1 / 2 / 3 / 9 중 반환
└ 0 : 미등록
└ 1 : 사업중
└ 2 : 폐업
└ 3 : 휴업
└ 9 : 미확인
closeDownStateDate String 8 휴폐업일자 (형식 : yyyyMMdd)
closeDownTaxType String 2 과세유형
  • null미등록
  • 10일반과세자
  • 20면세과세자
  • 30간이과세자
  • 31간이과세자 세금계산서 발급사업자
  • 40비영리법인 또는 국가기관, 고유번호가 부여된 단체
  • 99미확인
closeDownTaxTypeDate String 8 과세유형 전환일자 (형식 : yyyyMMdd)

TBizInfoCheckChargeInfo

순번변수명타입길이비고
unitCost String 12 조회단가
chargeMethod String 3 과금유형 : "연동" / "파트너" 중 반환
rateSystem String 3 과금제도 : "종량제" 반환

TJoinForm

순번변수명타입길이필수비고
ID String 50 Y 아이디
└ 6자 이상 50자 이하
Password String 20 Y 비밀번호
└ 8자 이상 20자 이하
└ 영문, 숫자, 특수문자 조합
LinkID String 20 Y 파트너 링크아이디
└ 연동신청시 팝빌에서 발급받은 링크아이디
CorpNum String 10 Y 사업자번호
└ 하이픈 '-' 제외 10자리 숫자값
CEOName String 200 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 담당자 휴대폰

TCorpInfo

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

TJoinContact

순번변수명타입길이필수비고
id String 50 Y 아이디
└ 6자 이상 50자 이하
Password String 20 조건부 비밀번호
└ 8자 이상 20자 이하
└ 영문, 숫자, 특수문자 조합
personName String 100 Y 담당자 성명
tel String 20 Y 담당자 휴대폰
email String 100 Y 담당자 이메일
searchRole String 1 N 담당자 권한 : "1" / "2" / "3" 중 반환
└ "1" : 개인권한
└ "2" : 읽기권한
└ "3" : 회사권한

TContactInfo

순번변수명타입길이필수비고
id String 50 Y 아이디
└ 6자 이상 50자 이하
personName String 100 Y 담당자 성명
tel String 20 Y 담당자 휴대폰
email String 100 Y 담당자 이메일
regDT String 14 X 등록일시 (형식 : yyyyMMddHHmmss)
searchRole String - N 담당자 권한 : "1" / "2" / "3" 중 반환
└ "1" : 개인권한
└ "2" : 읽기권한
└ "3" : 회사권한
mgrYN Boolean - X 관리자 여부 : True / False 중 반환
└ True : 관리자
└ False : 담당자
└ 팝빌 사이트 [마이페이지] > [회사정보] > [담당자 관리]에서 수정 가능
state integer 1 X 상태
└ 0 : (승인대기 - 관리자의 승인 후 이용가능)
└ 1 : (사용중) 중 반환