사업자등록상태조회

1. CheckCorpNum - 단건 조회

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

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

function checkCorpNum(CorpNum : String; UserCorpNum : String; UserID : String = '') : TCorpState;

요청

Parameters

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

응답

TCorpState

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

예외

EPopbillException

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

2. CheckCorpNums - 대량 조회

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

function checkCorpNums(CorpNumList : Array Of String; UserCorpNum : String; UserID : String = '') : TTCorpStateList;

요청

Parameters

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

응답

TCorpState

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

예외

EPopbillException

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