사업자등록 확인

사업자등록번호의 형식·검증 숫자를 먼저 거르고 국세청 상태를 조회한다. 번호·개업일자·대표자명의 진위도 확인한다

npm install @duolabs-deux/unit-biz-registry

직접 넣어 보기

가짜 어댑터를 이 브라우저에서 실행합니다. 실제 국세청 조회가 아니며 입력은 서버로 보내지 않습니다.

예시 번호는 개업일 2000-01-01, 대표자명 가상대표이면 일치합니다. 이름이나 날짜를 바꿔 불일치도 확인하세요.

이름		설명
`DATA_GO_KR_SERVICE_KEY`	필수	공공데이터포털 일반 인증키(Decoding). 「국세청_사업자등록정보 진위확인 및 상태조회 서비스」 활용신청이 필요하다. 계정 하나에 키 하나라 다른 공공데이터 유닛과 같은 키를 쓴다

id	종류	설명
`nts`	실제	국세청 상태조회·진위확인. 한 번에 100건
`fake`	가짜	키 없이 결정적으로 답한다. 진위확인은 가상 개업일·대표자명으로 시험한다

종류	언제	할 일
`invalid-input`	번호의 형식·검증 숫자, 개업일자·대표자명 입력이 잘못됐거나 어댑터가 진위확인을 지원하지 않을 때	입력과 어댑터 지원 기능을 확인한다
`auth`	인증키가 없거나 Encoding 키를 넘겼을 때	운영자에게 알린다. 가입을 막을지 보류로 받을지는 소비 앱이 정한다
`timeout`	국세청이 5초 안에 답하지 않을 때(1회 재시도 뒤)	보류로 받아 두고 나중에 다시 조회한다
`upstream-down`	국세청 서버 오류(INTERNAL_ERROR·HTTP_ERROR, 5xx)	timeout 과 같다
`quota`	호출 한도를 넘었을 때	상태조회는 캐시를 활용하고, 진위확인은 호출 빈도를 줄이거나 묶음으로 조회한다
`unexpected`	응답 형식이 명세와 다를 때	명세가 바뀌었는지 확인한다. 사람이 봐야 한다