사업자등록상태조회

1. CheckCorpNum - 단건 조회

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

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

Function CheckCorpNum(MemberCorpNum As String, CorpNum As String) As PBCorpState

요청

Parameters

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

응답

PBCorpState

순번	변수명	타입	길이	설명
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

예외

Err

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

2. CheckCorpNums - 대량 조회

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

Function CheckCorpNums(MemberCorpNum As String, CorpNumList As Collection) As Collection

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	MemberCorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	CorpNumList	Collection	-	Y	사업자번호 목록 → 최대 : 1,000건

응답

PBCorpState

순번	변수명	타입	길이	설명
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

예외

Err

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