법인 임대인과 건물 서류를 혼동하지 않으려면: 두 등기 PDF를 계약별로 묶기
에이픽 서비스를 소개하는 홍보 글입니다. 현실적인 업무 문제를 바탕으로 만든 가상 시나리오이며 실제 고객사 후기·도입 성과·API 실측 결과가 아닙니다. 공식 명세 확인일은 2026-11-05입니다.
마감 때마다 다시 찾게 되는 자료
상가 계약을 준비하는 팀은 건물 등기와 법인 임대인 등기를 각각 받아 서로 다른 폴더에 넣습니다. 건물 주소와 법인명이 바뀐 파일을 복사하다 다른 계약의 서류가 섞이는 가상 상황입니다.
두 API를 연결하는 것은 자체 서버의 역할입니다
부동산 pin과 법인등록번호는 계약 담당자가 따로 확정합니다. 두 PDF를 한 계약 폴더에 넣는다고 소유권·대표권이 자동 검증되는 것은 아닙니다. APICK은 서류 수집에 쓰고 관계 확인은 원문을 읽을 권한이 있는 담당자가 수행합니다.
APICK이 아래 전체 업무를 하나의 기본 기능으로 제공한다는 뜻이 아닙니다. 자체 서버에서 연동하고 내부 작업 ID·접수 상태·권한 검사를 구현하는 설계입니다. 실제 키·개인정보·원본 응답은 글에 넣지 않습니다.
apick.app 연동 준비
apick.app에서 계정과 해당 상품 이용 조건을 확인하고 개발가이드에서 필수 입력을 점검합니다. 발급받은 키는 서버 환경변수 APICK_API_KEY로만 참조합니다. 브라우저 코드·공개 저장소·로그에 키를 넣지 말고 공개용 예시에는 실제 값을 대입하지 않습니다.
업무를 연결하는 순서
- 계약 ID 아래 대상 부동산 식별번호와 제출받은 법인 식별번호를 별도 필드로 관리합니다.
- 부동산 열람 요청과 법인 열람 요청의 idempotency_key를 서로 다른 작업 ID로 생성합니다.
- 두 응답을 서로 다른 파일 경로에 저장하고 MIME 형식을 각각 검증합니다. 예시처럼 property.pdf.bin과 corporate.pdf.bin으로 파일을 분리하고 두 요청의 작업 ID도 다르게 사용합니다.
- 임대인·대상 물건·작성일을 담당자가 확인한 뒤 검토 완료 표시를 합니다.
1. 부동산 등기 API 요청과 응답 형태
아래 cURL은 공식 명세 기반 미실행 예시입니다. 환경변수는 권한 있는 서버에서 준비해야 하고 대괄호 표식은 실제 값이 아닙니다. 응답은 공식 정적 예시의 필요한 구조만 발췌·비식별 처리했으며 생략된 필드가 있습니다. 상품별 성공·오류 판정을 별도로 구현하세요.
curl --request POST 'https://apick.app/rest/registry_realestate_jobs' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form-string "pin=${APICK_PROPERTY_PIN}" \
--form-string 'usage=view' \
--form-string "idempotency_key=${APICK_PROPERTY_REQUEST_ID}" \
--dump-header property.headers \
--output property.pdf.binContent-Type: application/pdf 본문: PDF 바이너리
열람 850P, 발급 1,250P. 예시는 확인된 pin의 열람이며 별도 검색 비용을 포함하지 않습니다. 무료포인트 불가, 최소 1회 결제 조건이 있습니다.
공식 명세: 부동산 등기 개발가이드
2. 법인 등기 API 요청과 응답 형태
아래 cURL은 공식 명세 기반 미실행 예시입니다. 환경변수는 권한 있는 서버에서 준비해야 하고 대괄호 표식은 실제 값이 아닙니다. 응답은 공식 정적 예시의 필요한 구조만 발췌·비식별 처리했으며 생략된 필드가 있습니다. 상품별 성공·오류 판정을 별도로 구현하세요.
curl --request POST 'https://apick.app/rest/registry_corporate_jobs' \
--header "Authorization: Bearer $APICK_API_KEY" \
--form-string "corp_reg_no=${APICK_CORP_REG_NO}" \
--form-string 'usage=view' \
--form-string "idempotency_key=${APICK_CORPORATE_REQUEST_ID}" \
--dump-header corporate.headers \
--output corporate.pdf.binContent-Type: application/pdf 본문: PDF 바이너리
열람 850P, 발급 1,250P. 예시는 usage=view입니다. 무료포인트 불가, 최소 1회 결제 조건이 있습니다.
공식 명세: 법인 등기 개발가이드
한 단계가 실패했을 때
한 PDF만 준비됐다고 계약서류 전체 완료로 표시하지 않습니다. 미수신 서류명과 마지막 처리 상태를 보여주되 재요청 전에 기존 작업 기록을 확인합니다.
등기 정상 결과는 PDF 바이너리이며 지연 시 JSON 예외가 있을 수 있습니다. Content-Type을 확인하기 전 .pdf로 단정하지 않습니다. 문서의 처리시간 안내는 보장이 아니며 최대 180초 안내와 429 제한, 연결 종료 후 처리·과금 지속 가능성을 고려합니다.
개선은 시간과 재작업으로 확인하세요
이 흐름의 목표는 밤마다 자료를 옮기는 일을 줄이고 누락·예외를 한곳에 모으는 것입니다. 측정할 항목은 잘못 연결된 첨부파일 건수, 계약별 누락 서류 수, 자료 다운로드에 쓰는 수작업 시간입니다. 자동화 후 몇 분에 끝났다고 말하려면 실제 처리량·대기시간·담당자 검토시간을 따로 재야 합니다. 이 글에서는 “5초 보장”이나 대량 작업의 확정 처리시간을 제시하지 않습니다.
각 API 비용은 포인트 기준이며 재시도·추가 조회에 따라 달라질 수 있습니다. 포인트를 결제액·매출·이익과 동일시하지 말고 적용 전 최신 요금과 이용 조건을 확인하세요. 원문 개인정보 대신 상태와 내부 비식별 작업 ID를 남기고 필요한 사람에게만 접근을 허용합니다.
반복 조회는 에이픽 API로 연결하고, 중요한 승인과 예외 검토는 업무에 맞게 설계해 보세요.
댓글 없음:
댓글 쓰기