SAP 유산스 만기·이자 점검 — 기한부 신용장의 만기일과 이자를 다시 계산해 은행 통지와 장부 발생 이자에 맞춰 보는 수입 대금 화면

개발 배경 — 이 앱을 사용해야 하는 이유

수입 담당자와 자금 담당자는 월말마다 같은 질문을 받습니다. 기한부 신용장(유산스)으로 들여온 물건 대금이 언제 얼마나 나가는가, 은행이 통지한 만기일이 계산한 만기일과 같은가, 청구된 이자가 약정대로 구한 이자와 맞는가, 그 이자가 장부에 달마다 알맞게 발생했는가. 이 답은 공급업체 개별 항목(FBL1N), 자동 지급(F110), 외화 평가(FAGL_FCV), 구매오더(ME23N), 송장 검증(MIRO), 그리고 은행이 보내는 인수·정산 통지서에 나뉘어 있습니다.

이 앱은 그 사이를 이어 붙입니다. 유산스 한 건을 기준으로 외화 금액을 원화로 옮기고, 기준일에 유산스 기간을 더해 계산 만기일을 다시 구한 뒤 은행 통지 만기와 견주고, 연이율과 일수 기준으로 예상 이자를 다시 구해 청구 이자와 견주며, 이자 기간의 달마다 나눈 월별 예상 발생을 장부 발생 이자와 나란히 놓습니다. 표준 실행은 SAP 표준 T-code 가 담당하고, 이 화면은 조회·검증 관점을 더해 확장합니다.

이 앱은 특정 기준서의 요구사항을 직접 구현하는 화면이 아니라 수입 대금 결제용 업무 분석 앱입니다. 그래서 관련 기준서 칸은 ‘-’ 로 두고 대상 영역(수입)을 표기합니다. 외화 채무의 기말 환산이나 이자 비용의 회계 처리 같은 판단은 회사와 감사인이 하며, 이 화면은 그 판단에 필요한 사실(만기, 이자, 금액, 차이)을 모아 보여 줍니다.

만기는 기준일에서 시작한다

유산스의 만기는 인수일이 아니라 약정에서 정한 기준일(선하증권일·송장일·인수일 가운데 하나)에 기간을 더해 구합니다. 기준일이 어긋나면 만기도 어긋납니다. 이 앱은 유산스마다 기준일 + 유산스 기간 = 계산 만기일을 다시 구해 은행 통지 만기와 나란히 놓습니다. 검증용 샘플(기준일 2026-10-31) 36건 가운데 통지 만기가 계산 만기보다 1~3일 늦은 건이 4건이며, 휴일 이월인지 통지 오류인지는 통지서로 확인해야 합니다.

이자는 일수 기준에 따라 달라진다

같은 금액과 같은 연이율이라도 일수 기준이 360일이냐 365일이냐에 따라 이자가 달라집니다. 이 앱은 외화 금액 × 연이율 × 이자 일수 ÷ 일수 기준으로 예상 이자를 구하고 청구 이자와의 차이가 허용 오차(샘플 1,000원, 가정값) 이상이면 점검 필요로 올립니다. 샘플에서는 이자 차이가 4건이며 청구 이자와 재계산 이자의 차이는 5,594원에서 23,100원 사이입니다. 약정 이율을 확인하기 전에는 어느 쪽이 맞는지 단정하지 않습니다.

이자는 달마다 장부에 쌓인다

이자 기간이 여러 달에 걸치면 월별로 나누어 발생시켜야 합니다. 이 앱은 월별 예상 발생을 구해 장부 발생 이자와 나란히 놓고 차이가 있는 달을 가립니다. 월 간 이동이면 누계가 같으므로 귀속 월만 전표로 확인하면 되고, 한 달 장부 발생이 모자란 건은 따로 확인이 필요합니다.

만기가 가까운 돈을 미리 본다

미결제 유산스는 16건, 원화 환산 3,048,597,416원이고 이 가운데 7일 이내 만기가 3건, 이미 만기를 지난 건이 2건입니다. 만기 구간 탭은 통화별로 이 금액을 나누어 자금 계획에 쓰도록 돕습니다. 만기를 지난 건이 실제로 연체인지는 은행과 자금 담당에게 확인해야 합니다.

기능 요약

점검 판정 규칙

산출·대사식

계산 만기일 = 기준일 + 유산스 기간(일)
이자 일수 = 계산 만기일 − 인수일
예상 이자(외화) = 외화 금액 × 연이율(%) ÷ 100 × 이자 일수 ÷ 일수 기준(360 또는 365, 가정값)
예상 이자(원) = 예상 이자(외화) × 인식 환율 — 소수점 이하 반올림
월별 예상 발생(원) = 예상 이자(외화) × 그달 일수 ÷ 이자 일수 × 인식 환율
이자 차이(원) = 청구 이자(원) − 예상 이자(원)

검증 결과

검증용 샘플 36건(미결제 16 · 결제 완료 20)과 월별 발생 148행으로 대사 10종을 전수로 돌렸고 차이 건수는 10개 식 모두 0건입니다. 화면 요약 숫자는 독립으로 계산한 검증 스크립트 값과 같았습니다. 의도적 예외는 차이 건수와 따로 세어 점검 대상으로 둡니다.

무엇으로 만들었나

OpenUI5 1.120 과 Horizon 테마, OData V2 서비스로 만들었습니다. 화면은 서비스가 돌려준 값만 보여 주고 조회 조건은 표준 필터로 보내며, 별도 제품이나 외부 라이브러리가 필요하지 않습니다. 운영 데이터를 연결할 때는 서비스 주소만 바꾸면 됩니다.

실행 화면

실제로 돌아가는 화면 7종을 사용 순서대로 싣습니다. 그림을 누르면 크게 볼 수 있고, 화면마다 무엇을 보는 자리이고 숫자를 어떻게 읽는지를 아래에 적었습니다. 숫자는 모두 같은 검증용 샘플 데이터에서 나온 것이라 화면끼리 맞춰 보셔도 됩니다.

처음 연 화면

기준 연월이 기본으로 들어간 상태에서 조회조건, 요약 숫자, 첫 번째 탭이 한 화면에 쌓입니다. 조회 버튼은 조건 줄의 가장 오른쪽에 있습니다.

요약은 미결제 16건, 미결제 금액 3,048,597,416원(원화 환산), 7일 이내 만기 3건, 만기 경과 2건, 점검 필요 10건, 이자 차이 합계 +29,827원입니다. 상태 칸이 ‘점검 필요’ 인 행부터 열어 보면 됩니다.

점검 필요 건만 보기

점검 상태를 ‘점검 필요’ 로 두고 조회하면 먼저 열어 볼 건만 남고 요약도 같은 조건으로 다시 계산됩니다.

10건의 사유가 서로 다릅니다. 미결제인데 계산 만기가 월말보다 앞선 만기 경과, 통지 만기와 계산 만기가 다른 만기일 차이, 청구 이자와 재계산 이자가 허용 오차 이상 벌어진 이자 차이, 월별 장부 발생이 다른 발생 차이가 섞여 있습니다.

월별 이자 발생

이자를 이자 기간의 달마다 나눈 예상 발생과 장부 발생을 나란히 놓고 차이가 있는 달을 가립니다.

샘플에는 월 발생 차이가 3행(2건)입니다. 한 건은 두 달 사이에 금액이 옮겨 갔고 한 건은 한 달 장부 발생이 모자랍니다. 월 간 이동은 누계가 같으므로 월 귀속이 맞는지만 전표로 확인하면 됩니다.

만기 구간

미결제 잔액을 만기 경과·7일 이내·8~30일·31~60일·61일 이후 다섯 구간과 통화로 모읍니다.

만기 경과 구간에는 USD 2건 242,528,993원이 있고 7일 이내에는 USD 2건과 CNY 1건이 있습니다. 언제 얼마를 준비해야 하는지 자금 계획에 참고할 수 있습니다.

은행별 잔액

거래 은행과 통화별로 미결제 잔액, 예상 이자, 청구 이자와 그 차이를 견줍니다.

샘플의 은행은 가상 이름 네 곳입니다. 한 은행의 JPY 건에서 청구 이자가 재계산보다 23,100원 많게 나와 이자 차이로 올라오며, 다른 은행들은 차이가 없거나 수 원에서 수천 원입니다. 약정 이율을 확인하기 전에는 원인을 단정하지 않습니다.

건별 상세

행을 누르면 계산 만기와 통지 만기, 이자 일수, 연이율, 일수 기준, 외화·원화 이자, 월별 발생 내역이 한 창에 열립니다.

근거를 확인한 뒤 표준 화면(FBL1N 등)에서 원천 전표를 살펴봅니다. 창은 X 버튼이나 닫기로 돌아옵니다.

대사 결과

환산, 만기, 이자, 월별 일수, 구간·은행 집계, 건수를 열 가지 식으로 다시 맞춘 결과입니다.

10개 식 모두 차이 건수는 0입니다. 점검 화면이라 일부러 넣은 예외(만기일 차이 4건, 이자 차이 4건, 월 발생 차이 3행, 만기 경과 2건)는 차이 건수와 따로 세어 점검 대상 열에 보입니다.

SAP 표준 기능 확장 포인트

표준 실행은 SAP 표준 T-code 가 담당하고, 이 화면은 조회·검증 관점을 더해 확장합니다. 그래서 이 앱을 도입해도 기존 T-code 를 없애지 않습니다.

표준으로 되는 것과 안 되는 것

확장 자리

기준일 종류(선하증권일·송장일·인수일), 연이율, 일수 기준, 은행 통지 만기는 고객사마다 입력 방식이 달라 확인 필요로 표시했습니다. 합의가 끝나면 규칙 값과 매핑만 고치면 되고 화면 코드는 고치지 않습니다.

운영 시점에 합의할 일

위 여섯 가지는 코딩이 아니라 합의입니다. 합의가 끝나면 기술 작업은 CDS 뷰와 권한을 만들고 서비스를 게시하는 일입니다.

CDS 구성

이 절은 샘플 서비스가 읽는 값을 S/4HANA 의 CDS 뷰로 만들 때의 구성을 코드와 함께 보여 줍니다. 뷰 이름은 기능을 뜻하는 새 이름으로 스케치한 것이며, 표준 CDS 뷰의 필드 구성은 시스템 버전에 따라 달라질 수 있어 도입 시 확인 필요입니다. 은행 통지와 이자 비용 계정을 읽는 필드도 고객사마다 달라 확인 필요로 표시했습니다.

뷰 레이어 구성

① 규칙 값 — 일수 기준과 허용 오차

일수 기준과 이자 허용 오차는 코드가 아니라 값입니다. 운영에서 가장 먼저 합의하는 자리입니다.

@EndUserText.label: '유산스 점검 규칙'
define table zit_usn_rule {
  key mandt        : mandt not null;
  key rule_id      : abap.char(10) not null;   " 예: DAYBASIS, TOLERANCE
  rule_value       : abap.dec(15,2);           " 360 또는 365 / 1000 (확인 필요)
  rule_text        : abap.char(60);
}

② 기본 뷰 — 공급업체 미결제·결제 완료 항목

결제 상태를 청산일 유무로 나눕니다. 표준 뷰의 필드 구성은 시스템 버전에 따라 달라질 수 있어 도입 시 확인이 필요합니다.

@EndUserText.label: '유산스 미결제 항목'
define view entity ZI_UsanceBill as select from I_OperationalAcctgDocItem
{
  key CompanyCode, key AccountingDocument, key FiscalYear, key AccountingDocumentItem,
  Supplier, DocumentCurrency,
  @Semantics.amount.currencyCode: 'DocumentCurrency'
  AmountInTransactionCurrency,
  NetDueDate, ClearingDate,
  case when ClearingDate is initial then 'OPEN' else 'PAID' end as SettleStatus
}
where FinancialAccountType = 'K'

③ 기본 뷰 — 은행 통지와 이자 청구

은행 통지 만기와 청구 이자를 읽는 자리는 고객사마다 입력 방식이 달라 확인 필요로 둡니다.

@EndUserText.label: '유산스 은행 통지'
define view entity ZI_UsanceNotice as select from zit_usn_notice   " 확인 필요: 통지 원천
{
  key bill_key, bank_code, bank_due_date, bank_int_fx, bank_int_cur
}

④ 기본 뷰 — 월별 장부 발생 이자

통합 전표 항목에서 이자 비용 계정을 월별로 모읍니다. 계정 범위는 고객사별로 정합니다.

@EndUserText.label: '유산스 월별 장부 발생'
define view entity ZI_UsanceBookAccr as select from I_JournalEntryItem
{
  key CompanyCode, key FiscalYear, key PostingPeriod, key GLAccount,
  @Semantics.amount.currencyCode: 'CompanyCodeCurrency'
  sum( AmountInCompanyCodeCurrency ) as BookAccrKrw,
  CompanyCodeCurrency
}
where GLAccount between '0000000000' and '0000000000'   " 확인 필요: 이자 비용 계정 범위
group by CompanyCode, FiscalYear, PostingPeriod, GLAccount, CompanyCodeCurrency

⑤ 큐브 — 만기·이자 재계산

계산 만기일, 이자 일수, 예상 이자, 이자 차이를 한 곳에서 계산합니다.

@EndUserText.label: '유산스 점검 큐브'
define view entity ZI_UsanceCube as select from ZI_UsanceBill as b
  left outer join ZI_UsanceNotice as n on n.bill_key = b.AccountingDocument
{
  key b.AccountingDocument,
  dats_add_days( b.NetDueDate, 0, 'NULL' ) as CalcDueDate,   " 기준일 + 기간으로 대체 (확인 필요)
  n.bank_due_date                           as BankDueDate,
  b.SettleStatus
}

⑥ 쿼리와 권한

화면 컬럼·필터는 쿼리에, 회사 코드 권한은 큐브에 겁니다.

@EndUserText.label: '유산스 점검 쿼리'
define view entity ZC_UsanceQuery as projection on ZI_UsanceCube { key AccountingDocument, CalcDueDate, BankDueDate, SettleStatus }

@EndUserText.label: '유산스 큐브 권한'
@MappingRole: true
define role ZR_UsanceCube {
  grant select on ZI_UsanceCube where ( CompanyCode ) = aspect pfcg_auth( F_BKPF_BUK, BUKRS, ACTVT = '03' );   " 권한 객체 확인 필요
}

⑦ 서비스 정의

화면은 서비스만 봅니다. 조회 전용으로 노출합니다.

@EndUserText.label: '유산스 점검 서비스'
define service ZUI_USANCE_SRV {
  expose ZC_UsanceQuery as UsanceSet;
}
" 바인딩: OData V2 - UI 서비스. 서비스 이름은 소문자 usance_srv 로 게시

파일 구성

index.html · readme.html · Component.js · manifest.json
controller/ BaseController.js · Main.controller.js
view/ Main.view.xml · DetailDialog.fragment.xml
model/ formatter.js · ErrorHandler.js
css/ · i18n/
odata/ 서비스 정의(메타데이터 · 서비스 로직 · 엔티티셋별 데이터)
media/ 소개 영상

자주 묻는 질문

도입 상담과 데모에서 자주 받는 질문들을 네 묶음으로 적었습니다.

숫자와 산식

화면과 조작

분석 기능

도입과 운영