사업자등록상태조회

1. Checkcorpnum - 단건 조회

사업자번호 1건에 대해 실시간으로 사업자등록상태를 확인합니다.

• 팝빌 서비스의 안정적인 제공을 위하여 동시호출이 제한될 수 있습니다.
  동시에 100건 이상 요청하는 경우 대량 조회를 이용하시는 것을 권장합니다.

function corpstate checkcorpnum(string userCorpnum, string checkCorpNum) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	userCorpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	CheckCorpNum	String	10	Y	조회할 사업자번호

응답

CorpState

순번	변수명	타입	길이	설명
1	corpnum	string	10	조회한 사업자번호
2	taxType	string	2	사업자 과세유형 null 확인실패 10 일반과세자 20 면세사업자 30 간이과세자 31 간이과세자 세금계산서 발급사업자 40 비영리법인 또는 국가기관, 고유번호가 할당된 단체
3	typeDate	string	10	과세유형 전환일자 → 형식 : yyyy-MM-dd
4	state	string	1	휴폐업상태 null 확인실패 0 미등록 - 등록되지 않은 사업자번호 1 사업중 2 폐업 3 휴업
5	stateDate	string	10	휴폐업일자 → 형식 : yyyy-MM-dd
6	checkDate	string	10	국세청 확인일자 → 형식 : yyyy-MM-dd

예외

PopbillException

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

2. Checkcorpnums - 대량 조회

다수건의 사업자번호에 대해 실시간으로 사업자등록상태를 확인합니다. (최대 1,000건)

subroutine checkcorpnums(string corpnum, ref string corpnumlist[ ], ref corpstate ref_returnlist[ ]) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	corpnumlist	string[ ]	-	Y	사업자번호 목록 → 최대 : 1,000건
3	ref_returnlist	ref CorpState[ ]	-	Y	서브루틴 반환 결과값
ref CorpState[ ] 순번 변수명 타입 길이 필수 설명 1 corpnum string 10 N 조회한 사업자번호 2 taxType string 2 N 사업자 과세유형 null 확인실패 10 일반과세자 20 면세사업자 30 간이과세자 31 간이과세자 세금계산서 발급사업자 40 비영리법인 또는 국가기관, 고유번호가 할당된 단체 3 typeDate string 10 N 과세유형 전환일자 → 형식 : yyyy-MM-dd 4 state string 1 N 휴폐업상태 null 확인실패 0 미등록 - 등록되지 않은 사업자번호 1 사업중 2 폐업 3 휴업 5 stateDate string 10 N 휴폐업일자 → 형식 : yyyy-MM-dd 6 checkDate string 10 N 국세청 확인일자 → 형식 : yyyy-MM-dd

응답

corpstate[ ] - 요청 파라미터의 ref_returnlist 확인

예외

PopbillException

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