본문 바로가기

개발자용 API

사업자 서류 판독 API

사업자등록증·통신판매업 신고증·법인 등기사항증명서·인감증명서 사진을 보내면 등록번호·상호·대표자·주소·발급일을 항목별로 나눠 주고, 등록번호 검증과 지금 영업 중인지(계속·휴업·폐업)까지 함께 알려줍니다.

  • 입점 서류 항목을 자동으로 채워 검토 시간을 줄임
  • 잘못 읽은 등록번호를 검증 숫자로 걸러냄
  • 휴업·폐업 사업자를 접수 단계에서 확인

서비스·시스템에 연동하는 기업·개발자를 위한 API입니다. 인증키로 호출하고 사용한 만큼 포인트가 차감됩니다.

이런 서비스에 연결합니다

  • 오픈마켓·배달앱 판매자 입점입점 서류 사진으로 사업자 정보 칸을 자동으로 채우고, 휴업·폐업 사업자는 접수 단계에서 걸러냅니다.
  • B2B 거래처·협력사 등록거래처가 보낸 사업자등록증을 항목별 데이터로 바꿔 거래처 원장에 바로 저장합니다.
  • 통신판매업 신고 확인온라인 판매자의 신고번호·도메인·취급품목을 받아 두고 표시 의무 확인에 씁니다.
  • 법인 계좌·법인 거래처 등록법인 등기사항증명서와 인감증명서에서 상호·본점·임원·법인등록번호를 읽어 대표자 일치를 확인합니다. 주민등록번호는 가려서 돌려줍니다.

가격과 이용 조건

  • 판독 1건당 20P · 사업자 상태 확인은 추가 요금 없음
  • 글자를 읽지 못했거나 사업자 서류가 아니면 차감하지 않습니다.
  • 최소 1회 포인트 충전(결제) 후 이용할 수 있는 API입니다.
  • 서비스·시스템에 연동하는 기업·개발자용 API입니다. 회원가입 후 발급되는 인증키로 호출합니다.
  • PNG·JPEG 이미지를 받습니다. 서류 전체가 밝고 반듯하게 나온 사진이 가장 정확합니다.
  • 보낸 사진은 판독이 끝나면 바로 지우며 저장하지 않습니다.
  • 판독 결과는 입력을 돕는 자료입니다. 중요한 거래는 사용자 확인 단계를 두세요.

요금 정책 · 처음 연동 가이드

1분 소개 영상

호출 흐름

사업자 서류 판독 API 호출 흐름: ① 서류 사진 업로드(사업자등록증·신고증) → ② 글자 판독(항목별로 읽기) → ③ 등록번호 검증(형식·검증 숫자) → ④ 사업자 상태 확인(계속·휴업·폐업). 결과로 입점 양식을 자동 입력
  1. 사업자등록증·통신판매업 신고증·법인 등기사항증명서·인감증명서 가운데 한 장의 사진을 image로 보냅니다.
  2. 서류의 글자를 읽어 문서 종류를 알아내고 항목별 값으로 나눕니다.
  3. 등록번호 검증 숫자로 잘못 읽은 번호를 걸러내고, 읽지 못한 항목을 알려줍니다.
  4. check_status=1이면 지금 영업 중인 사업자인지와 과세유형을 함께 확인합니다.

연동 예제

인증키는 Authorization: Bearer 헤더로 보냅니다. 서버에서만 호출하고 인증키를 브라우저·앱에 넣지 마세요.

cURL
curl -X POST "https://apick.app/rest/business_doc_ocr" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@./business_registration.jpg" \
  --form-string "check_status=1"
Node.js (18 이상)
import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("image", new Blob([await readFile("./business_registration.jpg")]), "business_registration.jpg");
form.append("check_status", "1");

const response = await fetch("https://apick.app/rest/business_doc_ocr", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
});
const { data, api } = await response.json();
if (data.error) throw new Error(data.error); // 실패는 과금되지 않습니다
console.log(data, api.cost);

응답 예시

{
  "data": {
    "doc_type": "사업자등록증",
    "fields": {
      "사업자등록번호": "123-45-67891",
      "과세유형": "일반과세자",
      "상호": "에이픽상회",
      "대표자": "홍길동",
      "개업연월일": "2021-06-01",
      "사업장소재지": "서울특별시 강남구 테헤란로 100, 5층",
      "업태": "도매 및 소매업",
      "종목": "전자상거래 소매업"
    },
    "checks": {
      "사업자등록번호_형식": true,
      "사업자등록번호_검증숫자": true,
      "문서종류_일치": true
    },
    "missing": [],
    "business_kind": "개인",
    "status": {
      "조회결과": "확인",
      "사업자상태": "계속사업자",
      "과세유형": "부가가치세 일반과세자",
      "폐업일": ""
    },
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 20,
    "ms": 2310
  }
}

예시 값은 가상의 사업자입니다. 항목 일부만 보였습니다. 전체 항목은 개발 문서에 있습니다.

오류 해결

HTTP 상태 → api.success → data.error → api.cost 순서로 확인하세요. 실패 응답은 과금되지 않습니다.

  • 이미지에서 글자를 읽지 못했습니다.HTTP 422

    서류 전체가 밝고 반듯하게 나오도록 다시 찍게 하세요. 과금되지 않습니다.

  • 사업자등록증·통신판매업 신고증·법인 등기사항증명서·인감증명서를 찾지 못했습니다.HTTP 422

    다른 서류이거나 일부만 찍힌 사진입니다. 과금되지 않습니다.

  • 무료 포인트로 사용할 수 없는 서비스입니다.HTTP 200

    최소 1회 충전(결제) 후 이용할 수 있는 API입니다. 충전 후 같은 요청을 다시 보내세요.

  • 유효하지 않은 API키 입니다.HTTP 401

    Authorization: Bearer 헤더의 인증키를 확인하세요. 인증키는 마이페이지에서 확인합니다.

  • 허용되지 않은 IP주소 입니다.HTTP 401

    마이페이지의 허용 IP 설정과 요청을 보내는 서버 IP를 확인하세요.

  • 사용 가능한 포인트이 부족합니다.HTTP 200

    HTTP 200이어도 data.error가 있으면 실패입니다. 포인트를 충전한 뒤 다시 요청하세요. 이 응답은 과금되지 않습니다.

전체 응답 항목과 오류 코드는 개발 문서에 있습니다.

키 발급 → 예제 실행 → 첫 성공까지 몇 분이면 됩니다.