SAP 차입금 실효금리 History — 금리가 언제 어떻게 바뀌었나
변동금리 차입의 금리 변경 이력을 시점별로 펼쳐, 구간마다 적용된 이자율을 확인하는 화면입니다.
변동금리 차입은 금리가 계속 바뀝니다. 지금 금리만 보면 그동안 얼마를 냈는지는 알 수 없습니다.
이자 비용을 검증하거나 앞으로의 부담을 추정하려면 구간마다 어떤 금리가 적용됐는지 알아야 합니다. 변경 이력을 시점별로 펼쳐 보도록 OpenUI5 화면으로 확장한 것이 이 앱입니다. 실제 구동 화면 2종을 함께 공개합니다.
SAP 표준 기능을 그대로 이어받은 부분
- 차입 거래 — 금융기관과 거래번호
- 금리 유형 — 고정·변동 구분
- 적용 시점 — 금리 변경 기준일
- 금리 — 구간별 표면 금리와 실효금리
- 기준금리 — 연동 지표와 가산 금리
| 항목 | 내용 |
|---|---|
| 업무 영역 | 자금(TR) · 금리 관리 |
| Namespace | zui5.loanratehist |
| 셸 구조 | 조회조건 영역(우측 조회·초기화) + 금리 이력 테이블 |
| 화면 수 | 조회 화면 1개 + 상세 |
| 데이터 | 금리 이력 192건 |
| 성격 | 조회형(Read-Only) — 금리 등록은 표준이 담당 |
| UI 테마 | sap_horizon 단일 적용 |
실제 화면 2종 둘러보기
회사코드·거래번호·기간으로 조회하면 금리 이력이 나옵니다 → 구간별 적용 금리를 따라가고 → 변동 폭이 큰 시점을 확인합니다.
아래는 실제로 앱을 실행해 기능을 눌러 가며 캡처한 화면입니다. 이미지를 클릭하면 원본 크기로 확대됩니다.
조작 방법
- 회사코드를 고릅니다.
- 거래번호로 특정 차입 건의 이력을 봅니다.
- 기간으로 조회 범위를 지정합니다.
- 조회조건 입력필드에서 값을 바꾸거나 Enter 를 누르면 즉시 조회됩니다.
- 적용 구간을 시점순으로 따라갑니다.
- 변동 폭이 큰 시점을 확인합니다. 기준금리 변동 시기입니다.
- 실효금리가 구간마다 어떻게 달라졌는지 봅니다.
- 결과는 CSV 다운로드로 내려받아 이자 검증에 씁니다.
이력 관리 규칙
금리는 적용 구간 단위로 관리됩니다.
적용 금리 = 기준금리 + 가산금리
구간 적용 시작일 ~ 다음 변경일 직전
구간이 끊기거나 겹치면 이력 오류
변동 폭 = 당 구간 금리 − 직전 구간 금리
구간별 이자 = 원금 × 적용 금리 × 구간 일수 ÷ 365
총 이자 = Σ(구간별 이자)
구간이 끊기거나 겹치면 안 되는 이유
구간 사이에 공백이 있으면 그 기간의 금리가 정해지지 않아 이자를 계산할 수 없습니다. 겹치면 같은 날에 두 금리가 적용돼 이자가 중복됩니다. 이력 검증에서 이 두 가지를 먼저 확인해야 합니다.
금리가 바뀌는 네 가지 경우
| 경우 | 내용 | 변경 시점 |
|---|---|---|
| 기준금리 변동 | CD·COFIX 등 지표 변경 | 주기적 재산정 |
| 가산금리 조정 | 신용등급 변화 반영 | 재약정 시점 |
| 우대 적용 | 조건 충족 시 금리 인하 | 조건 심사 후 |
| 연체 전환 | 만기 경과 시 연체금리 | 만기일 다음 날 |
조회조건
| 필드 | 필수 | 설명 |
|---|---|---|
| 회사코드 | 필수 | 대상 법인 |
| 거래번호 | 선택 | 특정 차입 건 |
| 기간 | 필수 | 조회 범위 |
| 금융기관 | 선택 | 차입처 |
| 금리유형 | 선택 | 고정 / 변동 |
결과 컬럼
| 컬럼 | 의미 · 표시 |
|---|---|
| 금융기관 · 거래번호 | 차입 건 식별 |
| 금융상품 | 상품 유형 |
| 적용 시작일 · 종료일 | 금리 적용 구간 |
| 구간 일수 | 적용 기간 |
| 기준금리 | 연동 지표 금리 |
| 가산금리 | 스프레드 |
| 표면 금리 | 기준 + 가산 |
| 실효금리 | 부대비용 반영 금리 |
| 변동 폭 | 직전 구간 대비. 부호 색 |
| 구간 이자 | 구간별 발생 이자 |
SAP 표준 기능 매핑
| 표준 | 역할 | 이 화면에서의 확장 |
|---|---|---|
TPM10 | 금융거래 조회 | 차입 정보 |
VTBFHAPO | 거래 조건 | 금리 이력 |
JBRREFRATE | 기준금리 마스터 | 지표 금리 |
BNKA | 은행 마스터 | 금융기관 명칭 |
도입 시 확인이 필요한 부분
기준금리를 시스템에서 관리하는지 수동 입력하는지에 따라 이력의 정확도가 달라집니다. 수동이면 변경 시점을 놓쳐 이력에 공백이 생기기 쉽습니다. 기준금리 마스터를 주기적으로 갱신하는 절차가 함께 있어야 합니다.
참고 CDS 뷰
@AbapCatalog.sqlViewName: 'ZCLOANRATEH'
@EndUserText.label: '차입금 실효금리 이력 (Z)'
define view Z_C_LOAN_RATE_HISTORY
as select from vtbfhapo as Cond
inner join vtbfha as Deal on Cond.rfha = Deal.rfha
and Cond.bukrs = Deal.bukrs
left outer join bnka as Bank on Deal.hbkid = Bank.bankl
{
key Cond.bukrs,
key Cond.rfha as DealNo,
key Cond.dbereit as ValidFrom,
Bank.banka as BankName,
Deal.sfhaart as ProductType,
Cond.pkond as NominalRate,
Cond.sreferenz as ReferenceRate,
Cond.pkond_spread as Spread
// 적용 종료일 = 다음 구간 시작일 − 1
// 변동 폭 = 당 구간 − 직전 구간 (소비 뷰에서 계산)
// 실효금리는 부대비용 반영해 산출
}
매핑 이해를 돕기 위한 참고용 설계입니다. 실제 도입 시에는 운영 환경 설정과 릴리즈에 맞춰 조정합니다.
OpenUI5 구성
| 기능 | 사용 컨트롤 |
|---|---|
| 화면 골격 | sap.m.Page + 조회조건 영역 · 이력 테이블 |
| 조회조건 | sap.m.Select · sap.m.DatePicker · sap.m.Input — 우측 끝에 조회·초기화 |
| 이벤트 | 모든 버튼이 onPAI 단일 진입점, fcCode 로 분기 |
| 이력 테이블 | sap.ui.table.Table — 거래 그룹, 시점순 정렬 |
| 변동 표시 | sap.m.ObjectStatus — 인상·인하 색 |
| 금리 표시 | sap.m.ObjectNumber — 소수점 둘째 자리 |
기준금리와 가산금리를 나눠 보여 주는 이유
금리가 올랐을 때 시장 탓인지 우리 신용 탓인지 구분해야 대응이 정해집니다. 기준금리가 올랐으면 시장 전체 상황이고, 가산금리가 올랐으면 우리 조건이 나빠진 것입니다. 협상 여지도 후자에 있습니다.
파일 구성
| 경로 | 역할 |
|---|---|
manifest.json | 앱 디스크립터 — 앱 ID(zui5.loanratehist) · ko 로케일 |
view/Main.view.xml | 조회조건과 이력 테이블 |
controller/Main.controller.js | 조회 · 구간 계산 · 변동 폭 · CSV |
model/ModelMock.js | localdata JSON 읽기(Promise) |
js/formatter.js | 금리 · 일자 · 변동 색 포맷터 |
localdata/loanratehist.json | 금리 이력 192건 |
검증 결과
| 검증 항목 | 결과 |
|---|---|
| 구간이 끊기거나 겹치지 않음 | 통과 |
| 표면 금리 = 기준금리 + 가산금리 | 통과 |
| 변동 폭 = 당 구간 − 직전 구간 | 통과 |
| 구간 일수 = 종료일 − 시작일 + 1 | 통과 |
| 금융기관 코드가 있으면 명칭도 존재 | 통과 |
| XML · JSON 전체 파싱 | 오류 0건 |
| 화면 렌더링 — 실브라우저 조회 후 캡처 | 2/2 |
| 테마 런타임 확인 | sap_horizon |
자주 묻는 질문
고정금리 차입도 이력이 있나요?
한 구간만 있습니다. 차입일부터 만기까지 같은 금리가 적용되므로 이력이 단순합니다. 재약정이 있으면 구간이 나뉩니다.
이력에 공백이 생기면요?
그 기간 이자를 계산할 수 없습니다. 기준금리 갱신이 누락된 경우가 많으므로 마스터를 확인하고 소급 등록해야 합니다.
과거 이자를 재검증할 수 있나요?
구간별 금리와 일수가 있으면 가능합니다. 은행 청구 금액과 대조해 과다 청구가 없었는지 확인하는 용도로 씁니다.
SAP 표준 기능과 어떻게 이어지나요?
금리 조건은 표준 TR 의 거래 조건으로 관리됩니다. 이 화면은 그 이력을 구간별로 펼치고 변동 폭과 기준·가산 구분을 붙인 확장입니다.