SAP 전표 LineItem 조회 — 한 줄에 53개 항목을 담는 이유

전표를 확인해 달라는 요청은 한 가지 모양으로 오지 않습니다. 어느 거래처인지, 어느 팀 비용인지, 세금계산서는 붙었는지, 취소된 건 아닌지가 그때그때 다르게 섞여 옵니다.

표준 화면은 질문마다 다른 조회 화면을 열어야 합니다. 그래서 이 앱은 방향을 반대로 잡았습니다. 라인 한 줄에 붙을 수 있는 정보를 모두 한 줄에 담고, 화면을 바꾸는 대신 열을 보는 방식입니다. SAP 표준 전표 구조를 그대로 이어받아 53개 항목을 한 줄로 펼치도록 OpenUI5 화면으로 확장했습니다. 실제 구동 화면 2종을 함께 공개합니다.

실제 화면 1종 둘러보기

회사코드·기간·계정 등으로 조회하면 라인이 한 줄씩 펼쳐집니다 → 필요한 관점의 열을 골라 읽고 → 전표구분과 원전표/취소전표 열로 정상 전표인지 확인합니다.

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

Main.view.xml

조작 방법

1. 회사코드와 회계연도를 넣고 기간을 지정합니다.
2. 계정·거래처·코스트센터·세금코드 등 보조 조건으로 범위를 좁힙니다. 조건을 많이 걸수록 읽을 줄이 줄어듭니다.
3. 조회조건 입력필드에서 값을 바꾸거나 Enter 를 누르면 즉시 조회됩니다.
4. 전표구분 열로 정상·역분개·취소 전표를 구분합니다. 상태 색으로 먼저 눈에 들어옵니다.
5. 원전표/취소전표 열로 짝이 되는 전표를 확인합니다.
6. 결과는 CSV 다운로드로 내려받습니다. 53개 열이 그대로 담기고 UTF-8 BOM 이 붙어 엑셀에서 한글이 깨지지 않습니다.

전표구분 판정 규칙

같은 라인이라도 그것이 정상 전기인지, 무언가를 되돌린 것인지에 따라 읽는 방법이 달라집니다.

취소전표(stblg) 가 비어 있고 취소 표시도 없으면   →  정상
취소전표(stblg) 에 값이 있으면                    →  역분개됨 (이 전표가 취소당함)
xreversal 표시가 있으면                           →  취소전표 (다른 전표를 취소한 전표)

원화환산 검증  dmbtr = wrbtr × kursf

53개 항목의 여섯 묶음

열이 많아 보이지만 성격은 여섯 갈래뿐입니다. 어떤 질문이 오느냐에 따라 보는 묶음이 달라집니다.

조회조건

조회조건은 결과 열과 같은 축으로 구성해, 보고 싶은 관점을 그대로 조건으로 넣을 수 있게 했습니다.

결과 컬럼

SAP 표준 기능 매핑

전표는 표준 전기가 만듭니다. 이 화면은 헤더와 라인, 마스터 텍스트를 한 줄로 합쳐 보여 주는 조회 전용 확장입니다.

참고 CDS 뷰

운영 서비스로 연결할 때는 헤더·라인에 마스터 명칭을 붙이고 역분개 구분을 계산한 뷰를 제안합니다.

@AbapCatalog.sqlViewName: 'ZCLINEITEM'
@EndUserText.label: '전표 LineItem 통합 조회 (Z)'
define view Z_C_DOCUMENT_LINE_ITEM
  as select from bseg as Line
    inner join      bkpf as Header   on  Line.bukrs = Header.bukrs
                                     and Line.belnr = Header.belnr
                                     and Line.gjahr = Header.gjahr
    left outer join lfa1 as Vendor   on  Line.lifnr = Vendor.lifnr
    left outer join kna1 as Customer on  Line.kunnr = Customer.kunnr
    left outer join cskt as CCtrText on  Line.kostl = CCtrText.kostl
                                     and CCtrText.spras = 'K'
{
  key Line.bukrs, key Line.gjahr, key Line.belnr, key Line.buzei,
      Header.blart, Header.bldat, Header.budat, Header.usnam, Header.bktxt,
      Header.stblg, Header.stjah,
      Line.hkont, Line.shkzg, Line.waers, Line.wrbtr, Line.dmbtr, Line.sgtxt,
      Line.kostl, CCtrText.ktext as KostlTx,
      Line.aufnr, Line.mwskz, Line.gsber, Line.bupla, Line.matnr, Line.werks,
      Vendor.name1  as LifnrTx,
      Customer.name1 as KunnrTx,
      // 전표구분 — 취소전표 유무로 판정
      case when Header.stblg <> '' then 'REVERSED' else 'NORMAL' end as DocStatus
}

매핑 이해를 돕기 위한 참고용 설계입니다. 실제 도입 시에는 릴리즈와 사용 필드 범위에 맞춰 조정합니다.

OpenUI5 구성

파일 구성

운영 전환 시에는 ModelMock 내부만 실제 서비스 호출로 바꾸면 화면 로직은 그대로 씁니다.

검증 결과

회사코드·거래처·금액은 모두 검증용 데이터입니다.

자주 묻는 질문