SAP FI 인터페이스 13종 — 화면 없는 프로그램이 하는 일

ERP 프로젝트 산출물 목록을 보면 화면 프로그램 사이에 화면이 없는 프로그램들이 섞여 있습니다.

Function 이나 Interface 로 분류된 것들입니다. 눈에 보이는 게 없으니 존재감도 없지만, 이것들이 멈추면 다음 날 아침 카드 사용내역이 안 올라오고 환율이 비어 있고 결재 결과가 반영되지 않습니다. 이번에는 재무 모듈의 인터페이스 13종을 방향별로 나눠 정리했습니다. 밖에서 받아 넣는 것, 주고받는 것, 안에서 꺼내 주는 것. 세 갈래로 보면 설계 의도가 드러납니다.

인터페이스 흐름도 5종

방향으로 갈래를 나누고 → 수신형은 원본 보존과 화면 잠금을, 제공형은 가공 규칙을 정합니다.

아래는 실제로 앱을 실행해 기능을 눌러 가며 캡처한 화면입니다. 이미지를 클릭하면 원본 크기로 확대됩니다.

FI 인터페이스 전체 구성

현대카드 I/F 4종

법인카드 경비 결재 연동

환율 I/F

제공형 I/F 3종

설계 시 점검 순서

1. 인터페이스를 방향으로 먼저 나눕니다. 받는 것, 주고받는 것, 주는 것.
2. 수신형은 백업 테이블을 먼저 두고 운영 테이블로 옮기는 구조인지 확인합니다.
3. 수신분을 화면에서 어디까지 고칠 수 있게 할지 정합니다. 카드사가 주는 항목은 잠그는 편이 안전합니다.
4. 결재 연동은 상태 코드 매핑과 되돌림 처리를 함께 설계합니다.
5. 제공형은 받는 쪽이 바로 쓸 수 있도록 집계·부호·키를 맞춰 넘깁니다.
6. 모든 인터페이스가 EV_RETURN · EV_MSG 같은 공통 반환 규약을 따르게 합니다.

13종 처리 로직 요약

열세 개 인터페이스가 각각 무엇을 받아 어디에 넣고 무엇을 돌려주는지 정리했습니다.

인터페이스 13종 — 방향별 분류

  【수신형 6종】 외부 → SAP
     ZFIA_HCARD_MASTER_IF        현대카드 마스터
     ZFIA_HCARD_APPR_IF          현대카드 승인내역
     ZFIA_HCARD_PROC_IF          현대카드 매입내역
     ZFIA_HCARD_BILL_IF          현대카드 청구내역 (월 단위)
     ZFIA_EXCHANGE_RATE_IF       하나은행 고시환율
     ZFIE_HR_WITHHOLDING_TAX_IF  인사시스템 원천세

  【양방향 2종】 Legacy ↔ SAP
     ZFIA_LEGACY_DOC_IF          전표 생성 요청 → 전표번호 회신
     ZFIA_LEGACY_CHECK_CANCEL    전표 취소여부 조회

  【결재 연동 2종】 SAP ↔ 그룹웨어
     ZFIA_DOCUMENT_REQUEST       법인카드 경비 상신
     ZFIA_DOCUMENT_FINAL         결재 완료 후 처리

  【제공형 3종】 SAP → 외부
     ZFIB_AR_STATUS              채권/입금 현황
     ZFIC_AP_COMMISSION          AP Commission 지급정보
     ZFIF_GET_DOC_INFO_FOR_DTI   이세로 대사 데이터

방향별 4갈래

이름은 비슷해 보여도 데이터가 흐르는 방향에 따라 설계가 달라집니다.

네 갈래로 나누면 각 인터페이스가 왜 그런 모양인지 설명이 됩니다.

공통 파라미터

상태 코드 체계

보조 기능

연결되는 화면 프로그램

인터페이스가 쌓은 데이터는 결국 화면 프로그램이 꺼내 씁니다.

운영 데이터 소스 매핑

참고 CDS 뷰

수신 결과를 원본과 대조할 때는 운영 테이블에 백업 테이블을 붙인 뷰가 편합니다.

@AbapCatalog.sqlViewName: 'ZCIFCARDLOG'
@EndUserText.label: '카드 I/F 수신 현황 (Z)'
define view Z_C_CARD_INTERFACE_LOG
  as select from ztfia0020 as Usage
    left outer join ztfia0050 as ApprBackup on  Usage.bukrs     = ApprBackup.bukrs
                                            and Usage.card_num  = ApprBackup.card_num
                                            and Usage.aqui_coll = ApprBackup.aqui_coll
    left outer join ztfia0060 as ProcBackup on  Usage.bukrs     = ProcBackup.bukrs
                                            and Usage.card_num  = ProcBackup.card_num
                                            and Usage.aqui_coll = ProcBackup.aqui_coll
{
  key Usage.bukrs        as Bukrs,
  key Usage.card_num     as CardNo,
  key Usage.aqui_coll    as AcquireNo,
      Usage.if_date      as InterfaceDate,
      Usage.ackdate      as ApprovalDate,
      Usage.ackamount    as ApprovalAmount,
      Usage.aqui_won     as AmountKrw,
      Usage.belnr        as AccountingDoc,
      // 어느 인터페이스로 들어왔는지
      case when ApprBackup.card_num is not null then 'APPR'
           when ProcBackup.card_num is not null then 'PROC'
           else 'MANUAL' end as SourceInterface,
      // 원본과 금액이 달라졌는지 — 수기 수정 흔적
      case when ApprBackup.ackamount is not null
            and ApprBackup.ackamount <> Usage.ackamount then 'X'
           else '' end as AmountChanged
}

수신 결과를 원본과 대조할 때 쓰는 참고용 설계입니다. 백업 테이블을 함께 조인하면 어느 인터페이스로 들어왔고 이후 값이 바뀌었는지 드러납니다.

화면 없는 프로그램 다루기

네임스페이스 구성

사양서 대조 결과

정리에 쓴 자료는 프로그램 사양서의 파라미터·처리 로직·연관 테이블입니다.

테이블명과 코드 체계는 사양서 기준입니다.

자주 묻는 질문