Reason Code

발행
업데이트

Reason Code란 무엇인가

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

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

현재 계약이 왜 적격, 조건부적격, 부적격, 판단불가와 같은 상태로 분류되었는지 설명할 수 있어야 합니다.

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

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

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

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


Reason Code의 구성 요소

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

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

Reason Code 구성 요소
구성 요소의미
코드명내부적으로 사유를 식별하는 고유 코드
공개 사유명사용자가 이해할 수 있는 사유명
설명 문구왜 해당 사유가 중요한지 설명
심각도경고, 주의, 치명 등 위험 수준
결과 영향적격, 조건부적격, 부적격, 판단불가에 미치는 영향
연결 Action Code필요한 후속 조치
데이터 근거어떤 데이터에서 발생한 사유인지
버전판단 기준의 관리 버전

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


심각도와 결과 영향

모든 Reason Code가 같은 수준의 위험을 의미하지는 않습니다.

어떤 Reason Code는 단순 확인 요청일 수 있고, 어떤 Reason 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_RESULT_NOT_EVALUATED_PREREQUISITES_MISSING평가에 필요한 최소 정보 부족필수 정보 보완 후 재평가
보증보험 확인 요소RC_INSURANCE_RENTAL_GUARANTEE_ELIGIBILITY_UNCONFIRMED보증보험 관련 확인 요소가 충분하지 않음보증보험 가입 전 추가 기준 확인

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

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


대표 Action Code 예시

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

대표 Action Code 예시 — 코드, 의미, 연결 상황
대표 Action Code의미연결되는 상황 예시
ACT_REVIEW_DEPOSIT_AND_TERMS보증금 및 계약 조건 재검토보증금이 시세 대비 높거나 회수 위험이 있는 경우
ACT_ADJUST_DEPOSIT보증금 조정 검토일부 보증금 회수 위험이 있는 경우
ACT_RECHECK_PRICE_LATER시세 자료 재확인핵심 시세 정보가 부족한 경우
ACT_VERIFY_TAX_CLEARANCE세금완납증명서 확인임대인 세금완납 확인이 필요한 경우
ACT_UPLOAD_OWNER_PROOF소유자 증빙 확인소유자 또는 계약 상대방 확인이 필요한 경우
ACT_REQUEST_TRUST_DOCUMENTS신탁 관련 서류 확인신탁 등기 구조가 확인된 경우
ACT_REVIEW_PROPERTY_USE건축물 용도 확인주거용 건물 여부가 불명확한 경우
ACT_COMPLETE_REQUIRED_INPUTS필수 정보 보완평가에 필요한 최소 정보가 부족한 경우

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

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


공개 범위와 제한 공개

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

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

공개하는 정보

  • 대표 Reason Code
  • 대표 Action Code
  • 코드의 의미와 역할
  • 심각도와 결과 영향 기준
  • Contract Decision OS와의 관계
  • 사용자 이해를 위한 공개 문구

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

  • 전체 내부 로직
  • 악용 가능성이 있는 탐지 기준
  • 내부 가중치와 세부 스코어링
  • 제휴기관별 세부 데이터
  • 개인정보 또는 민감 정보
  • 보안상 공개하기 어려운 운영 구조

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의 역할
적격주요 위험 신호가 낮다는 판단 근거를 설명
조건부적격추가 확인이 필요한 사유를 설명
부적격중대한 위험 신호의 사유를 설명
판단불가어떤 데이터가 부족해 판단이 제한되었는지 설명

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

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


자주 묻는 질문

Reason Code란 무엇인가요?

Reason Code는 Contract Decision OS에서 계약 전 판단 결과가 왜 나왔는지 설명하는 사유 코드입니다. 현재 계약 상태가 어떤 이유로 적격, 조건부적격, 부적격, 판단불가로 분류되었는지 설명합니다.

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

Reason Code는 '왜 이런 판단이 나왔는가'를 설명합니다. Action Code는 '다음에 무엇을 확인해야 하는가'를 안내합니다. Reason Code가 사유라면, Action 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가 존재한다고 해서 계약의 법적 안전성, 대출 가능 여부, 보증보험 가입 가능 여부, 보증금 반환 가능성이 확정되는 것은 아닙니다.

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


판단 근거 및 출처