에이픽은 조회·인증·문서 정보를 업무 시스템에 연결하는 API 플랫폼입니다. 사업자등록증명 발급 API는 대표자 본인 인증을 거쳐 증명 자료와 문서확인번호, 상호, 사업자등록번호 등을 받는 기능입니다. 도매몰은 인증 요청 20P와 최초 결과 60P의 공개 기본 단가를 바탕으로 회원 접수 화면에 사업자 자료 확인 단계를 연결할 수 있습니다.
에이픽으로 무엇을 할 수 있나요
에이픽은 조회·인증·문서 정보를 업무 시스템에 연결하는 API 플랫폼입니다. 사업자등록증명 발급 API는 대표자 본인 인증을 거쳐 증명 자료와 문서확인번호, 상호, 사업자등록번호 등을 받는 기능입니다. 도매몰은 인증 요청 20P와 최초 결과 60P의 공개 기본 단가를 바탕으로 회원 접수 화면에 사업자 자료 확인 단계를 연결할 수 있습니다.
실제 입력과 반환 결과
개인사업자 대표자의 간편인증 흐름에서는 name·birthDate·phone·authProvider, 사업자등록번호 business_no, 사용용도 use_purpose, 제출처 submit_to, 교부방법 delivery를 준비합니다. 처음에는 agreed=true를 함께 보내 대표자 본인 확인에 동의합니다. 결과의 businessRegistrationCert에서 문서확인번호·상호·사업자등록번호·개업일자·업태·종목을 읽고, format에 따라 PDF 문서나 PDF에서 읽은 JSON 자료를 받습니다.
회원 등록에서 필요한 자료를 먼저 보여주기
도매몰의 사업자 회원 가입 화면에는 주문 담당자 연락처와 사업자 증명 확인을 각각 배치할 수 있습니다. 주문 담당자는 물품 발주와 배송 연락을 맡고, 대표자는 본인 자료 확인을 승인합니다. 접수 안내에는 확인할 자료를 상호, 사업자등록번호, 개업일자, 업태와 종목으로 구체적으로 적으세요. 사용자는 어떤 정보가 회원 등록에 쓰이는지 이해한 뒤 인증 단계로 이동할 수 있습니다. 운영팀은 반환된 항목을 회원 신청서와 대응시키고 필요한 검토를 이어 갑니다. 이 연결은 팀이 구축할 도매몰 적용 흐름이며, API의 증명 자료 제공 기능을 접수 과정에 활용하는 방법입니다.
대표자와 주문 담당자의 입력을 분리하기
처음 입력하는 이름·생년월일·휴대전화는 실제로 인증을 승인할 대표자의 정보로 준비합니다. 도매몰 담당자의 연락처는 별도 회원 연락 정보로 보관하면 각 값의 역할이 선명해집니다. 사업자등록번호는 10자리 문자열로 입력하고 회원 신청서에 적힌 번호와 대조합니다. PASS를 고르면 공식 요청 규격의 통신사 코드 telco도 함께 받습니다. 화면에는 선택한 인증 수단과 승인할 사람, 확인할 사업자번호를 마지막으로 보여줄 수 있습니다. 이렇게 입력을 정리하면 대표자는 자신에게 도착할 승인 요청을 알아보기 쉽고 운영자는 신청 건과 인증 거래를 같은 접수번호에 연결할 수 있습니다.
사용용도와 제출처를 접수 목적에 맞추기
사업자등록증명에는 사용용도와 제출처가 요청 항목으로 들어갑니다. 공식 가이드는 각각 두 자리 코드를 요구하며 정해진 용도가 없을 때 기타 코드 99를 안내합니다. 팀은 도매몰 회원 자료 접수라는 실제 목적에 맞는 코드를 확인해 화면 선택값과 연결할 수 있습니다. 문서를 응답으로 받는 흐름에서는 일반적으로 교부방법 06을 사용합니다. 요청 목적, 제출처, 신청한 사업자번호를 함께 남기면 나중에 같은 증명을 어느 가입 건에 사용했는지 찾기 좋습니다. 사용자가 읽는 안내에는 코드 자체보다 접수 목적을 먼저 보여주고 서버 요청에는 명세의 정확한 코드값을 전달하는 구성이 유용합니다.
승인 대기와 자료 준비를 화면에서 구분하기
인증 요청에 성공하면 transactionId를 저장하고 그 거래로 결과를 확인합니다. 대표자가 승인하는 시간과 기관 자료를 준비하는 시간은 화면에서 구분해 표시할 수 있습니다. 승인 대기에는 인증 앱에서 확인할 내용을 안내하고, COLLECTING에는 증명 자료를 준비 중이라는 설명을 보여줍니다. 공식 안내의 승인 유효시간은 5분이며, 자료 준비에는 1분 넘게 걸릴 수도 있습니다. 결과조회 간격은 5초, 10초, 20초, 30초 순서의 권장값을 활용할 수 있습니다. resultAvailable이 true가 되면 받은 자료를 저장하고 해당 거래의 반복 조회를 마무리해 다음 접수 단계로 이어갑니다.
PDF와 구조화된 값을 함께 활용하기
서류 보관이 필요한 접수에는 format=both를 선택해 문서와 읽어 낸 값을 함께 받을 수 있습니다. pdf 형식은 base64로 인코딩한 발급문서와 파일명·문서해시·문서크기를 제공하고, json 형식은 PDF에서 읽은 PDF데이터를 제공합니다. 운영 화면에는 상호와 번호처럼 빠르게 대조할 항목을 표시하고 첨부 영역에는 받은 문서의 식별 정보를 연결하는 구성이 가능합니다. 문서확인번호는 증명 자료를 찾는 키로, 회원번호는 도매몰 내부 업무의 키로 구분해 두세요. 한 접수 화면에서 핵심 값과 관련 문서를 함께 찾도록 설계하면 자료를 다시 열어 확인하는 흐름이 간결해집니다.
상호와 업태를 신청 내용에 맞춰 읽기
결과에서 받은 상호와 업태·종목은 도매몰 신청서의 사업 소개를 대조하는 자료가 됩니다. 예를 들어 신청서에 생활용품 매장을 운영한다고 적었다면 반환된 종목과 실제 취급 상품 설명을 나란히 놓고 담당자가 확인할 수 있습니다. 사업자등록번호는 정확한 문자열 일치로 연결하고 상호 표기는 원문 그대로 보존한 뒤 화면용 표기를 별도로 정리하는 방식이 좋습니다. 개업일자는 해당 자료의 날짜로 표시하고 가입 신청일과 구분합니다. 이 화면은 자료 확인을 돕는 업무 설계입니다. 최종 회원 등급과 거래 조건은 도매몰의 운영 기준을 적용해 담당자가 결정하도록 연결하면 각 정보의 역할이 또렷해집니다.
수신 시각과 문서 연결을 접수 이력으로 남기기
checkedAt은 실제 정보를 확인한 시각이고 resultExpiresAt은 결과 재조회 만료 시각입니다. 운영팀은 두 시간을 분리해 접수 기록에 남길 수 있습니다. 자료를 받은 즉시 권한 있는 저장소에 보존하고 회원 신청번호, 문서확인번호, 확인 담당자를 함께 연결하세요. 같은 거래의 자료를 다시 열 때에는 이미 저장한 문서와 응답값을 활용할 수 있으며, 공식 재조회 기간 안에는 transactionId로 결과를 확인할 수 있습니다. 화면에는 언제 확인한 사업자 자료인지 표시하면 다음 담당자가 접수 맥락을 이해하기 쉽습니다. 자료 접근 권한도 회원 처리 업무에 필요한 사람으로 정해 보관과 열람 흐름을 함께 설계합니다.
작은 접수 범위부터 비용과 활용을 읽기
도매몰 전체 가입 절차 중 사업자 증명 확인 한 단계부터 연결하면 에이픽의 역할을 바로 체감할 수 있습니다. 팀이 살펴볼 항목은 인증 요청 건수, 실제 자료 수신 건수, 수신 후 담당자가 확인한 항목, 두 단계의 실제 차감액입니다. 예산표에서는 발송된 인증 요청과 최초 결과 제공을 각각 집계하고 대기 응답은 별도 상태로 기록합니다. 접수 화면이 준비되면 대표자 안내 문장, 필수값 형식, 반환값과 문서 연결을 차례로 점검하세요. 명확한 입력과 구조화된 결과, 공개된 단계별 단가를 한 흐름으로 묶는 것이 에이픽을 업무에 채택할 때 얻는 실질적인 장점입니다.
공개 단가와 이용 조건
인증 요청이 실제 발송되면 20P, 결과가 처음 제공되면 건당 60P입니다. 두 단계가 각각 한 번 정상 진행된 예산 예시는 80P입니다. 승인 대기·수집 중 결과조회와 결과 수신 뒤 24시간 안의 같은 거래 재조회는 무료입니다. 발송된 인증 비용과 결과 비용은 별도로 확인하며 실제 차감은 charged·api.cost로 읽습니다. 최소 1회 결제 후 이용할 수 있고 1P=1원, 부가세 별도입니다.
우리 업무에 연결하는 시작점
에이픽 공식 개발가이드의 입력 예제와 응답 항목을 확인하고 이번 업무에서 필요한 값을 선택하세요. 이 글의 사례는 실제 기능에 기반한 업무 적용 기획입니다. 우리 조직의 자료를 어떤 값으로 입력하고 어떤 반환 항목을 화면이나 문서에 연결할지 정하면 첫 적용 범위가 구체적으로 드러납니다. 결과의 확인 시점과 판단 근거를 함께 남겨 다음 담당자도 같은 흐름으로 활용할 수 있게 구성하세요.
첫 작업을 시작해 보세요
에이픽의 공식 화면에서 이 글에서 확인한 항목을 직접 비교해 보세요.
댓글 없음:
댓글 쓰기