사업자등록상태조회

1. CheckCorpNum - 단건 조회

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

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

CorpState checkCorpNum(string MemberCorpNum, string CheckCorpNum, string UserID = null)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	MemberCorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	CheckCorpNum	string	10	Y	조회할 사업자번호
3	UserID	string	50	N	팝빌회원 아이디

응답

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건)

List<CorpState> checkCorpNums(string MemberCorpNum, List<string> CorpNumList, string UserID = null)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	MemberCorpNum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	CorpNumList	List<string>	1,000	Y	사업자번호 목록 → 최대 : 1,000건
3	UserID	string	50	N	팝빌회원 아이디

응답

List<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 처리 실패에 대한 오류메시지