부동산 문서 일괄 발급에서 부분 성공을 보존하고 재시도 가능한 실패만 다시 처리하는 상태 설계를 설명합니다.
이국환 · SION.LAB 대표 · 예상 읽기 시간 6분
부동산 문서를 여러 건 발급할 때 가장 위험한 설계는 “전체 성공 아니면 전체 실패”로 처리하는 것입니다. 열 건 중 아홉 건이 완료됐는데 한 건 때문에 전체를 다시 실행하면 중복 발급과 비용, 감사 기록 혼선이 생길 수 있습니다.
이 글은 부동산 문서 발급·재시도 운영 시스템에 공개된 상태 설계를 바탕으로 설명합니다. 공개 Works는 구현·테스트 범위를 보여주며 특정 고객의 비용 절감 성과를 의미하지 않습니다.
전체 흐름. 재시도 전에 기존 성공과 중복 가능성을 확인합니다.
요청과 문서 작업을 분리합니다
편집 도식: 본문 표의 문서 상태를 전이 관계로 배치했습니다. 성공한 문서는 재요청 대상에서 제외되고, 재시도 가능 실패만 다시 처리 대기로 돌아갑니다. 실제 상태명과 조건은 연동 대상에 따라 달라질 수 있습니다.
한 번의 일괄 요청 아래에 문서별 작업을 만듭니다. 요청 전체 상태와 각 문서 상태를 따로 관리해야 일부 완료를 보존할 수 있습니다.
문서 상태
의미
가능한 조치
대기
아직 처리 전
실행
처리 중
공급자 응답 대기
중복 실행 차단
성공
문서와 식별값 저장 완료
다운로드·검증
재시도 가능 실패
일시 오류·세션 만료 등
조건 확인 후 재시도
종단 실패
입력 오류·권한 부족 등
입력 수정 또는 종료
재시도 전에 확인할 네 가지
첫째, 이미 성공한 문서는 다시 요청하지 않습니다. 둘째, 같은 작업 ID로 중복 결제나 중복 저장이 일어나지 않는지 확인합니다. 셋째, 공급자 오류와 사용자 입력 오류를 구분합니다. 넷째, 누가 언제 다시 실행했는지 기록합니다.
주소 검색과 등기부 열람·발급의 기능 범위는 SION.LAB의 부동산등기부등본 열람·발급 상품에서 확인할 수 있습니다. 이 상품은 대법원 인터넷등기소 기반의 조회 유형으로 소개되어 있으므로 실제 적용 전에는 공식 서비스의 이용 조건, 인증, 수수료, 자동화 허용 범위를 별도로 확인해야 합니다.
부분 성공을 화면에 그대로 보여줍니다
운영자는 “전체 10건 중 성공 9건, 재시도 가능 1건”처럼 현재 상태를 봐야 합니다. 완료된 PDF, 공급자 시도, 오류 코드, 재시도 결과가 같은 작업 이력에 연결돼야 다음 담당자가 이어서 처리할 수 있습니다.
업무 자동화 운영 체크리스트의 알림·권한·감사 항목을 함께 적용하면 발급 기능이 운영 가능한 흐름으로 바뀝니다.
