홈

Reason Code

발행
업데이트

Reason Code란 무엇인가

Reason Code는 Contract Decision OS에서 계약 전 판단 결과가 왜 나왔는지 설명하는 사유 코드입니다.

계약 전 판단에서 중요한 것은 결과만 보여주는 것이 아닙니다.

현재 계약이 왜 진행 가능, 조치 후 진행, 진행 제한, 추가 확인 필요와 같은 상태로 분류되었는지 설명할 수 있어야 합니다.

Reason Code는 이 "이유"를 기록합니다.

Contract Decision OS는 Reason Code를 통해 계약 전 판단을 단순한 결과값이 아니라, 설명 가능한 판단 구조로 관리합니다.

Contract Decision OS는 부동산 계약 조건을 Reason Code 기준으로 분석합니다. Reason Code Registry는 Core Reason Code를 기반으로 계약 유형과 적용 정책에 따라 확장됩니다. Reason Code 평가는 Evidence, 모델 산출값, 적용 Policy / Rule을 함께 참조해 이루어지며, 그 결과를 종합해 State를 산출하고 필요한 경우 Action Code가 연결됩니다. 보증금 회수 관련 판단에서는 금융형 AVM이 산출한 q10·예상 경매낙찰가·Safe Exit Price 같은 분석값도 Evidence로 참조합니다.

RC가 동작하는 전체 시스템 구조는 Contract Decision OS 아키텍처, 판단에 사용되는 출처는 데이터 소스 문서에서 확인할 수 있습니다.

#ReasonCode #ActionCode #안심등기 #ContractDecisionOS #계약전판단사유 #State

왜 Reason Code가 필요한가

부동산 계약 판단에서 "위험하다" 또는 "괜찮다"라는 말만으로는 충분하지 않습니다.

계약 전 판단은 여러 데이터와 조건이 함께 작동합니다.

등기부등본, 보증금, 시세, 선순위 채권, 임대인, 건축물, 보증보험 확인 요소, 회수 가능성 중 어떤 항목이 판단에 영향을 주었는지 설명할 수 있어야 합니다.

예를 들어 같은 조치 후 진행이라도 이유는 다를 수 있습니다.

조치 후 진행 사유 예시
상태가능한 사유
조치 후 진행핵심 시세 정보 부족
조치 후 진행선순위 채권 구조 추가 확인 필요
조치 후 진행임대인 서류 확인 필요
조치 후 진행신탁등기 관련 계약 권한 확인 필요
조치 후 진행보증금 일부 회수 위험 가능성

Reason Code가 없다면 사용자는 결과만 보게 됩니다.

Reason Code가 있으면 왜 그런 결과가 나왔는지, 무엇을 추가로 확인해야 하는지 이해할 수 있습니다.


Reason Code란 무엇인가

Reason Code는 계약 전 판단 결과에 영향을 준 사유를 구조화한 코드입니다.

Reason Code는 다음 질문에 답합니다.

왜 이 계약이 현재 상태로 분류되었는가?

예를 들어 계약 결과가 추가 확인 필요라면 그 이유가 주소 매칭 실패인지, 보증금 정보 부족인지, 핵심 시세 정보 부족인지 구분되어야 합니다.

계약 결과가 진행 제한이라면 그 이유가 보증금 과다인지, 권리 제한인지, 전체 채권 구조의 위험인지 설명되어야 합니다.

Reason Code는 이 판단 사유를 일관된 기준으로 기록합니다.


Reason Code와 State의 관계

State는 현재 계약 상태를 의미합니다.

Reason Code는 그 상태가 나온 이유를 설명합니다.

State와 Reason Code의 역할
구분역할
State현재 계약이 어떤 상태인지 표현합니다.
Reason Code왜 그런 상태가 나왔는지 설명합니다.

예를 들어 State가 "조치 후 진행"이라면 Reason Code는 그 조건이 무엇인지 설명합니다.

State가 "추가 확인 필요"라면 Reason Code는 어떤 데이터가 부족해 판단이 제한되었는지 설명합니다.

State가 "진행 제한"이라면 Reason Code는 어떤 위험 사유가 중대하게 작용했는지 설명합니다.

즉, State는 결론이고 Reason Code는 이유입니다.

Reason Code → State 연결

  1. Evidence · 모델 산출값 · 적용 Policy / Rule 참조
  2. Reason Code 평가
  3. Reason Code 평가 결과를 종합해 State 산출: 진행 가능 / 조치 후 진행 / 추가 확인 필요 / 진행 제한
  4. State와 Reason Code에 따라 필요한 경우 Action Code 연결
  • Reason Code별 평가 결과를 종합해 Overall State를 산출합니다.
  • 평가 가능 여부, 선행조건, 적용 여부는 Policy / Rule에 따라 관리될 수 있습니다.
  • 내부 시스템 상태와 상세 코드는 평가·운영을 위해 별도로 관리될 수 있으며, 공개 문서에서는 다루지 않습니다.

Reason Code와 Action Code의 관계

Reason Code가 "왜 그런 판단이 나왔는가"를 설명한다면, Action Code는 "이제 무엇을 확인해야 하는가"를 안내합니다.

구분질문역할
Reason Code왜 이런 결과가 나왔는가?판단 사유 설명
Action Code다음에 무엇을 해야 하는가?후속 조치 안내

예를 들어 핵심 시세 정보가 부족하다는 Reason Code가 발생하면, 시세 자료를 재확인하거나 추가 가격 근거를 확인하는 Action Code가 연결될 수 있습니다.

신탁등기가 확인되었다는 Reason Code가 발생하면, 신탁원부와 수탁자 동의 여부를 확인하는 Action Code가 연결될 수 있습니다.

Reason Code와 Action Code가 함께 있어야 계약 전 판단이 단순 경고에서 실제 확인 행동으로 이어질 수 있습니다.


Reason Code가 다루는 주요 영역

Reason Code는 전월세계약 전 판단에 필요한 여러 영역을 다룹니다.

Reason Code 주요 영역
영역주요 판단 사유
입력 정보주소, 보증금, 계약 조건 등 필수 입력값 부족
건축물주거용 여부, 위반건축물, 건축물 정보 확인 제한
시세핵심 시세 정보 부족, 보조 시세만 존재, 가격 신뢰도 제한
보증금보증금 과다, 선순위 채권, 일부 회수 위험
최우선변제최우선변제 가능성, 지역·금액 기준 확인
임대인소유자 확인, 계약 상대방 확인, 세금완납 확인 필요
등기·권리근저당권, 압류, 가압류, 가등기, 신탁, 경매개시결정 등
보증보험보증보험 가입 전 확인이 필요한 조건
결과 판단필수 데이터 부족, 평가 제한, 추가 확인 필요
증빙 서류계약 전 제출·확인해야 할 서류 부족

이 영역들은 독립적으로 존재하는 것이 아니라 하나의 계약 상태를 판단하기 위해 함께 연결됩니다.

주거용 RC 섹션 분류

Reason Code Registry는 Core Reason Code를 기반으로 계약 유형과 적용 정책에 따라 확장됩니다. 아래는 주거용 판단에서 사용하는 섹션 분류입니다.

섹션 번호섹션 명칭
01입력 (Input)
02건축물 (Building)
03시세 (Price)
04보증금 (Deposit)
05최우선변제 (Priority)
06임대인 (Landlord)
07등기·권리 (Legal Property)
08이력 신호 (History)
09교차검증 (Cross Check)
10결과 (Result)
11증빙 서류 (Evidence)
12보증보험 (Insurance Extension)

상업용 영업가능성 RC (별도 체계)

상업용 영업가능성 RC는 위 주거용 섹션과 별도로 관리됩니다. 입지·용도·인허가·시설 등 영업가능성 판단 항목으로 구성됩니다.

계약 유형별 적용 범위

범위설명
주거용 전·월세주거 임대차 계약에 적용. 보증금 회수 관련 판단, 임대인, 등기·권리, 건축물 확인 요소로 구성됩니다.
상가·오피스상업용 임대차의 영업가능성(입지·용도·인허가·시설) 판단에 사용하는 별도 RC 체계입니다.
부동산 매매부동산매매 AI진단기는 공통 RC를 사용합니다. 고객에게 노출되는 RC 항목·화면 템플릿은 서비스별로 다를 수 있습니다.

Reason Code의 구성 요소

Reason Code는 단순한 내부 코드명이 아닙니다.

계약 전 판단에서 실제로 사용되려면 사람이 이해할 수 있는 설명과 후속 조치가 함께 있어야 합니다.

Reason Code 구성 요소
구성 요소의미
코드명내부적으로 사유를 식별하는 고유 코드
공개 사유명사용자가 이해할 수 있는 사유명
설명 문구왜 해당 사유가 중요한지 설명
평가 상태Evidence 확보 여부에 따른 평가 가능·제한 여부
State 반영진행 가능, 조치 후 진행, 추가 확인 필요, 진행 제한 산출에 반영되는 방식
연결 Action Code필요한 후속 조치
데이터 근거어떤 Evidence에서 발생한 사유인지
버전판단 기준의 관리 버전

Reason Code는 내부 관리와 외부 설명을 동시에 고려해야 합니다.

Reason Code 단위 구조

하나의 Reason Code는 다음으로 구성됩니다.

구성 요소설명
rc_codeRC 식별자. 예: RC_TRUST_OWNERSHIP_REGISTERED
rc_name판단 항목의 한국어 명칭
section속하는 도메인 섹션
scoperesidential / commercial / both
evaluates이 RC가 평가하는 Knowledge Graph Entity
evidence_required판단에 필요한 데이터 유형 (등기부등본·API 데이터·수동 입력 등)
state_output분석 결과로 산출되는 State
linked_action_codesState에 따라 연결되는 Action Code 목록

Reason Code · State · 평가 상태의 구분

모든 Reason Code가 같은 방식으로 결과에 반영되지는 않습니다.

사유(Reason Code), 현재 진행 상태(State), 데이터 확보와 평가 가능 여부(Evidence Status)는 서로 다른 개념입니다.

Reason Code · State · 평가 상태 구분
구분의미
Reason Code왜 이런 판단이 나왔는가 — 판단 사유를 표준화한 평가 단위
State현재 진행 상태
Evidence Status / Evaluation Status데이터 확보 여부와 평가 가능 여부
Action Code다음에 확인하거나 조치해야 할 사항

Reason Code는 위험을 과장하기 위한 장치가 아닙니다.

오히려 판단 사유와 진행 상태, 평가 가능 여부를 구분해 설명하기 위한 구조입니다.


대표 Reason Code 예시

아래는 Contract Decision OS에서 사용될 수 있는 대표 Reason Code 예시입니다.

대표 Reason Code 예시 — 영역, 코드, 의미, 연결 조치
영역대표 Reason Code의미연결 조치 예시
보증금RC_DEPOSIT_OVER_MARKET보증금과 선순위 채권 합계가 시세를 초과할 수 있음보증금 및 계약 조건 재검토
보증금RC_DEPOSIT_PARTIAL_RISK일부 보증금 회수 위험이 있음보증금 조정 또는 추가 확인
보증금RC_DEPOSIT_INPUT_UNAVAILABLE보증금 정보가 입력되지 않음보증금 입력 후 재평가
권리RC_ACTIVE_RIGHTS_RESTRICTION압류·경매·가등기 등 권리 제한 확인등기부 권리관계 재확인
권리RC_TRUST_OWNERSHIP_REGISTERED신탁 등기 구조로 계약 권한 확인 필요신탁원부 및 동의 서류 확인
권리RC_JEONSE_RIGHT_REVIEW_REQUIRED_JIPHAB전세권 설정 여부 확인 필요전세권 구조 및 말소 조건 확인
건축물RC_BUILDING_VIOLATION_FLAGGED위반건축물 표기 확인 필요위반 내용 및 해소 가능성 확인
건축물RC_BUILDING_NOT_RESIDENTIAL주거용 건물 여부 확인 필요건축물대장 용도 확인
시세RC_PRICE_CORE_SOURCES_UNAVAILABLE핵심 시세 정보 확인 불가시세 자료 재확인
임대인RC_LANDLORD_TAX_CLEARANCE_REQUIRED임대인 세금완납 확인 필요국세·지방세 완납증명서 확인
임대인RC_LANDLORD_OWNER_IDENTITY_UNAVAILABLE소유자 정보 확인 필요소유자 및 계약 상대방 확인
최우선변제RC_PRIORITY_PROTECTION_EXCEEDED_AMOUNT최우선변제 보호 범위 초과 가능보호 가능 금액 확인
최우선변제RC_NONCOLLECTIVE_PRIORITY_STRUCTURE_REVIEW_REQUIRED다가구 등 비집합형 구조 추가 확인 필요선순위보증금 및 임차인 구조 확인
결과RC_INSUFFICIENT_DATA평가에 필요한 최소 정보 부족필수 정보 보완 후 재평가
보증보험 확인 요소RC_INSURANCE_RENTAL_GUARANTEE_ELIGIBILITY_UNCONFIRMED보증보험 관련 확인 요소가 충분하지 않음보증보험 가입 전 추가 기준 확인

대표 예시는 전체 Reason Code의 일부입니다.

세이프홈즈는 외부 이해와 신뢰 형성에 필요한 대표 코드와 관리 기준을 공개하고, 세부 내부 로직과 악용 가능성이 있는 탐지 기준은 제한적으로 관리합니다.


대표 Action Code 예시

Action Code는 Reason Code에 연결되는 후속 조치입니다.

대표 Action Code 예시 — 코드, 의미, 연결 상황
대표 Action Code의미연결되는 상황 예시
ACT_ADJUST_DEPOSIT_OR_SENIOR_RIGHT보증금 조정 또는 선순위 권리 정리 검토보증금과 선순위 채권 구조의 확인이 필요한 경우
ACT_REDUCE_DEPOSIT_OR_RELEASE_MORTGAGE보증금 감액 또는 근저당 말소 검토근저당 구조와 보증금 규모를 함께 확인해야 하는 경우
ACT_VERIFY_TAX_CLEARANCE세금완납증명서 확인임대인 세금완납 확인이 필요한 경우
ACT_RECHECK_REGISTRY_BEFORE_CONTRACT계약 전 등기부 재확인계약 시점의 권리관계를 다시 확인해야 하는 경우
ACT_RECHECK_REGISTRY_BEFORE_BALANCE잔금 전 등기부 재확인잔금 지급 전 권리 변동 여부를 확인해야 하는 경우
ACT_VERIFY_JEONSE_RIGHT_RELEASE전세권 말소 조건 확인전세권 설정이 확인된 경우
ACT_VERIFY_BUILDING_LEDGER건축물대장 확인건축물 용도·상태 확인이 필요한 경우
ACT_OBTAIN_SENIOR_DEPOSIT_RECORD선순위보증금 확인 자료 확보다가구 등 선순위 임차 구조 확인이 필요한 경우

Action Code는 계약을 강제하거나 결정을 대신하지 않습니다.

사용자, 중개사, 금융기관이 다음에 무엇을 확인해야 하는지 이해하도록 돕는 안내 구조입니다.


공개 범위와 제한 공개

세이프홈즈는 Reason Code의 구조와 대표 사례를 공개합니다.

다만 모든 원천 데이터, 내부 가중치, 세부 탐지 로직, 제휴 데이터, 악용 가능성이 있는 기준을 모두 공개하지는 않습니다.

공개하는 정보

  • 대표 Reason Code
  • 대표 Action Code
  • 코드의 의미와 역할
  • Reason Code · State · 평가 상태 구분 기준
  • Contract Decision OS와의 관계
  • 사용자 이해를 위한 공개 문구

제한 공개 또는 내부 관리 대상

  • 전체 내부 로직과 Policy Rule
  • 전체 threshold
  • 전체 Reason Code → Action Code 매핑
  • 내부 helper·상세 코드와 시스템 상태
  • 악용 가능성이 있는 탐지 기준
  • 내부 가중치와 세부 스코어링
  • 제휴기관별 세부 데이터
  • 개인정보 또는 민감 정보

Reason Code 공개의 목적은 투명성과 설명 가능성을 높이는 것입니다.

동시에 개인정보 보호, 보안, 서비스 악용 방지를 위해 필요한 범위는 제한적으로 관리합니다.


Reason Code와 데이터 출처

Reason Code는 데이터에서 발생합니다.

예를 들어 보증금 회수 위험은 보증금, 선순위 채권, 시세, 회수 가능성 데이터가 함께 검토되어야 발생할 수 있습니다.

Reason Code와 데이터 출처
Reason Code주요 데이터 출처
보증금 회수 위험보증금, 선순위 채권, 시세, 회수 가능성 기준
핵심 시세 정보 부족실거래가, 시장 참고가, 공시가격 등
권리 제한 확인 필요등기부등본
신탁 구조 확인 필요등기부등본, 신탁원부 등
건축물 용도 확인 필요건축물대장
임대인 확인 필요소유자 정보, 계약 상대방 정보, 세금완납 확인 자료

Data Sources가 판단의 근거라면, Reason Code는 그 근거가 계약 상태에 어떤 영향을 주었는지 설명하는 구조입니다.


Reason Code와 Audit Log

Reason Code는 판단 이력과도 연결됩니다.

계약 전 판단은 한 번으로 끝나지 않을 수 있습니다.

처음에는 시세 정보 부족으로 추가 확인 필요가 나왔지만, 추가 자료가 확인되면 조치 후 진행이나 진행 가능으로 바뀔 수 있습니다.

처음에는 권리 제한이 없었지만, 이후 등기 변동으로 추가 확인이 필요해질 수 있습니다.

Audit Log는 이런 Reason Code의 발생, 변경, 해소 과정을 기록합니다.

Audit Log 기록 대상
기록 대상의미
Reason Code 발생어떤 사유가 판단에 영향을 주었는지 기록
Action Code 안내어떤 후속 조치가 연결되었는지 기록
데이터 보완어떤 자료가 추가되었는지 기록
재평가추가 자료 반영 후 다시 판단한 이력
상태 변경추가 확인 필요, 조치 후 진행, 진행 가능 등 상태 변화

Reason Code가 사유라면, Audit Log는 그 사유와 상태가 시간에 따라 어떻게 바뀌었는지 남기는 구조입니다.


안심등기에서의 적용

Contract Decision OS의 첫 시장 적용은 전월세였으며, 현재 안심등기는 전·월세 임대차, 상가·오피스 임대차, 부동산 매매 계약에 적용됩니다.

안심등기에서는 Reason Code를 통해 계약 유형별 계약 전 판단 사유를 설명할 수 있습니다.

예를 들어 다음과 같은 방식입니다.

안심등기에서의 Reason Code 적용
안심등기 결과Reason Code의 역할
진행 가능주요 위험 신호가 낮다는 판단 근거를 설명
조치 후 진행추가 확인이 필요한 사유를 설명
진행 제한중대한 위험 신호의 사유를 설명
추가 확인 필요어떤 데이터가 부족해 판단이 제한되었는지 설명

계약 상태를 변경하지 않고 이해를 돕기 위해 제공되는 보조 정보는 State와 별도 영역으로 표시합니다.

안심등기에서 중요한 것은 단순히 결과를 보여주는 것이 아닙니다.

왜 그런 결과가 나왔고, 무엇을 추가로 확인해야 하는지 설명하는 것입니다.


자주 묻는 질문

Reason Code란 무엇인가요?

Reason Code는 Contract Decision OS에서 계약 전 판단 결과가 왜 나왔는지 설명하는 사유 코드입니다. 현재 계약 상태가 어떤 이유로 진행 가능, 조치 후 진행, 진행 제한, 추가 확인 필요로 분류되었는지 설명합니다.

Reason Code와 Action Code는 무엇이 다른가요?

Reason Code는 '왜 이런 판단이 나왔는가'를 설명합니다. Action Code는 '다음에 무엇을 확인해야 하는가'를 안내합니다. State와 Reason Code에 따라 필요한 경우 Action Code가 연결됩니다.

Reason Code는 몇 개인가요?

Reason Code Registry는 Core Reason Code를 기반으로 계약 유형과 적용 정책에 따라 확장됩니다. 이 문서에서는 구조와 분류, 대표 Reason Code 예시를 공개합니다.

Reason Code가 있으면 무조건 위험한 계약인가요?

아닙니다. Reason Code는 판단 사유를 설명하는 구조입니다. 일부 Reason Code는 단순 정보 부족이나 추가 확인 요청일 수 있고, 일부는 중대한 위험 신호일 수 있습니다. 중요한 것은 사유의 내용과 그에 따라 필요한 확인 절차입니다.

모든 Reason Code를 공개하나요?

아닙니다. 세이프홈즈는 외부 이해와 신뢰 형성에 필요한 대표 Reason Code와 관리 기준을 공개합니다. 개인정보, 보안, 악용 가능성이 있는 탐지 로직, 내부 가중치 등은 제한적으로 관리합니다.

Reason Code는 어떻게 업데이트되나요?

Reason Code는 데이터 출처, 판단 기준, 서비스 운영 경험, 금융·보증 기준 변화에 따라 업데이트될 수 있습니다. 업데이트 시에는 코드의 의미, 결과 영향, 연결 Action Code, 공개 문구를 함께 관리해야 합니다.

안심등기 결과와 Reason Code는 어떤 관계인가요?

안심등기 결과가 State라면, Reason Code는 그 결과가 나온 이유입니다. 예를 들어 조치 후 진행이 나왔다면 Reason Code는 어떤 항목 때문에 추가 확인이 필요한지 설명합니다.


유의사항

Reason Code는 계약 전 판단 사유를 설명하기 위한 구조입니다.

Reason Code가 존재한다고 해서 계약의 법적 안전성, 대출 가능 여부, 보증보험 가입 가능 여부, 보증금 반환 가능성이 확정되는 것은 아닙니다.

세이프홈즈는 현재 확인 가능한 데이터와 기준을 바탕으로 계약 전 위험 신호와 판단 사유를 설명하며, 최종 계약·대출·보증 판단은 계약 당사자, 금융기관, 보증기관, 관련 법령 및 개별 심사 기준에 따라 달라질 수 있습니다.


판단 근거 및 출처