수출 대리점 수수료 다차원 분석 — 지급 계획 대비 차이를 여섯 요인으로 가르고 정산 문서 라인까지 내려가는 수출 솔루션 한 화면
큐브 집계 · 끌어 놓는 축 구성 · 칸에서 정산 문서 라인까지의 드릴스루 · 기준 대비 차이와 요인분해 · 행에 남는 변동 사유 · 숫자를 모델에 맡기지 않는 인공지능 분석 · 하루 한 번 도는 에이전트 — 소개 영상과 실제 화면 32종, 그리고 CDS 코드까지
소개 영상블로그 목차 순서대로 · 자막 포함
도입 포인트 — 이 앱을 사용해야 하는 이유
수출 담당자와 재경·자금 담당자가 분기 회의에서 받는 질문은 비슷합니다. 대리점에 나간 수수료가 계획보다 얼마나 늘었나, 늘어난 몫이 물량인지 요율인지 환율인지 인센티브인지, 계획에 없던 대리점 계약은 얼마나 되나. 지금은 이 답이 판매 오더·청구 문서와 수수료 정산 자료, 지급 전표에 흩어져 있어서 숫자 하나를 설명하려면 문서를 여러 번 열어 맞춰야 합니다.
이 화면은 수수료 정산 문서 라인을 기간·지역·국가·대리점·제품그룹·인코텀즈·수수료 기준·지급 방식 축으로 한 번에 돌려 보고, 수수료 지급 계획과의 차이를 여섯 요인으로 나눈 뒤 칸에서 원천 문서 라인까지 내려가 합계를 스스로 검산하는 점검 조회 도구입니다. 표준 실행은 SAP 표준 T-code 가 담당하고, 이 화면은 조회·검증 관점을 더해 확장합니다. 최종 판단은 회사와 감사인이 합니다.
핵심 포인트 일곱 가지
| 핵심 포인트 | 고객이 얻는 것 | 지금 방식이라면 |
|---|---|---|
| ① 축을 바꿔도 합계가 갈라지지 않는 피벗 | 지역·국가·대리점·수수료 기준·지급 방식 등 차원을 끌어 놓아 행 3단계·열 2단계로 봅니다. 모두 같은 큐브에서 나오므로 합계가 어긋날 자리가 없습니다. | 대리점별·국가별·기준별 리포트를 따로 만들고, 합계가 다르면 리포트를 맞추느라 시간을 씁니다. |
| ② 칸에서 문서 라인까지 한 번에 | 칸을 누르면 그 금액을 만든 정산 문서 라인이 열리고, 칸 값과 원천 합계가 같은지 그 자리에서 보입니다. | 표준 화면을 따로 열어 조건을 손으로 다시 맞춥니다. |
| ③ 계획 대비 차이를 여섯 요인으로 | 총 차이를 물량·기본 수수료 단가·환율·성과 인센티브·정산비·미계획으로 가르고, 요인 합계가 총 차이와 같은지 검사합니다. | 엑셀로 차이를 나누고 합계를 다시 손으로 맞춥니다. |
| ④ 변동 사유가 행에 남는다 | 사유는 조회 범위와 행 경로에 묶여 저장되어 축을 바꿔도 다음 조회에서 그 행에 따라옵니다. | 같은 질문을 분기마다 다시 하고 지난번 답은 메일에서 찾습니다. |
| ⑤ 하루 한 번 도는 감시 | 규칙마다 기준값과 받을 역할(CEO·CFO·영업·자금)이 있어 걸린 항목이 역할별 받은 보고로 올라옵니다. | 숫자가 나빠진 날 아무도 화면을 열지 않으면 그대로 지나갑니다. |
| ⑥ 숫자는 모델에 맡기지 않는 분석 | 금액과 비율은 서비스가 계산하고 해설은 그 숫자를 읽어 쓰며, 원인은 단정하지 않고 점검 필요 항목만 제시합니다. | AI 가 만든 숫자를 보고서에 써도 되는지부터 따져야 합니다. |
| ⑦ 보고서와 저장 배치 | 보고 있는 범위로 PowerPoint 보고서가 브라우저에서 만들어지고, 자주 쓰는 배치는 이름을 붙여 저장합니다. | 화면을 캡처해 보고서를 다시 만들고 배치를 매번 다시 잡습니다. |
사례로 보는 효과 — 3,591백만원 차이는 어디서 났나
검증용 샘플 데이터 2026-01~2026-09 범위에서 총 수수료는 21,863백만원, 수수료 지급 계획은 18,271백만원이어서 총 차이는 +3,591백만원(+19.7%)입니다. 표만 보면 "계획보다 많이 나갔다"에서 멈춥니다.
요인으로 가르면 계획에 없던 대리점 계약(미계획)이 +1,736백만원으로 가장 크고, 물량 +1,170백만원, 기본 수수료 단가 +474백만원, 환율 +144백만원, 성과 인센티브 +67백만원, 정산비는 거의 0입니다. 여섯 요인을 모두 더하면 3,591백만원으로 총 차이와 같고, 대사 항목 13건은 모두 차이 0건입니다. 어디부터 확인할지가 한 화면에서 정해집니다.
도입하면 달라지는 것
- 분기 점검 준비 — 차이 표·요인분해·사유·보고서가 한 화면에서 나와 엑셀 취합과 화면 캡처가 줄어듭니다.
- 회의의 주제 — "어느 숫자가 맞나"보다 "어느 대리점·요인부터 확인할까"를 이야기합니다.
- 다음 분기로 이어지는 기록 — 사유와 배치가 남아 같은 설명을 다시 하지 않습니다.
- 놓치지 않는 점검 — 화면을 열지 않아도 감시 규칙에 걸린 항목이 역할별 받은 보고로 올라옵니다.
이런 회사에 맞습니다
SAP S/4HANA 에서 수출 판매 오더·청구 문서 흐름을 운영하고, 해외 대리점에 판매 수수료를 지급하며 그 수수료를 엑셀로 모아 계획과 견주는 회사에 맞습니다. 대리점이 여럿이고 통화·수수료 기준·지급 방식이 계약마다 달라 정산 부담이 건마다 다른 수출 비중이 큰 제조·유통 회사, 영업·자금·재경이 같은 숫자를 서로 다른 눈으로 보아야 하는 조직에서 효과가 큽니다.
실행 화면
사용 방법
- 조회 조건 — 회사코드(필수), 시작 기간·종료 기간(필수)을 정합니다. 비교 기준은 수수료 지급 계획으로 고정되어 있고 저장된 레이아웃은 선택입니다.
- 조회 — 조회조건 영역 오른쪽 끝의 파란 조회 버튼을 누르거나 입력 칸에서 Enter 키를 누릅니다. 자동 조회를 지정한 레이아웃은 화면을 열 때 한 번 조회까지 끝낸 채 시작합니다.
- 요약 확인 — 역할별 요약(CEO·CFO·영업 책임자·자금 책임자)에서 총 수수료, 기본 수수료, 부대 수수료, 수수료율을 먼저 봅니다.
- 축·탭 이동 — 차원 칩을 사용 안 함·행·열로 옮기고 보기 방식(차원 보기·단계 보기), 분석 항목, 표시 행 수를 고릅니다.
- 행·칸 클릭 — 행을 누르면 오른쪽 차트가 그 행 기준으로 바뀌고, 칸을 누르면 원천 정산 문서 라인이 열립니다.
- 기준 대비·분석 — 기준 대비를 켜 차이를 보고, AI 분석과 AI 에이전트, 기간별 요약, 보고서를 위쪽 버튼에서 엽니다.
- 내보내기 — CSV 버튼으로 현재 표를 파일로 저장합니다.
무엇으로 만들었나
| 자리 | 무엇 | 왜 그렇게 두었나 |
|---|---|---|
| 화면 컨트롤 | OpenUI5 표준 컨트롤(sap.ui.table 트리 표·sap.m 대화상자)과 직접 그린 SVG 차트 | 외부 차트 라이브러리를 반입하지 않아 보안 검토 부담이 없습니다. |
| 집계·판정 로직 | 큐브 집계·차트·보고서·레이아웃 모듈 | 축을 바꿔도 서비스를 다시 부르지 않고 이미 받은 큐브에서 다시 집계합니다. |
| 서비스 구성 | OData V2 서비스를 manifest 에 상대 경로로 선언하고 큐브·계획·차원·원천 라인 셋을 읽습니다 | 금액 계산은 서비스가 하고 화면과 AI 해설은 읽기만 합니다. 경로를 코드에 박지 않아 운영 서비스로 바꾸기 쉽습니다. |
| 오류 처리 | 연결 실패·빈 결과·한도 초과를 사용자 문장으로 안내 | 빈 화면이나 콘솔 오류로 끝나지 않게 했습니다. |
| 테마 | sap_horizon | 표준 화면과 같은 시각 언어로 오가는 부담을 줄입니다. |
| 항목 | 내용 |
|---|---|
| 솔루션 | 수출 |
| 업무 영역 | 영업(SD) · 수출 대리점 수수료 |
| 관련 기준서 | - (대상 영역 : 수출) |
| SAP 표준 T-code | VA03 · VF03 · FB03 · FBL1N · KE30 |
| Namespace | zui5.expcomm |
| 화면 성격 | 다차원 분석 리포트 |
| 테마 | sap_horizon |
처음 열었을 때
조회 전의 빈 틀과 조회 직후의 표·차트를 먼저 확인합니다. 행·열 영역에 차원 칩이 놓이는 모습도 여기서 봅니다.

화면을 처음 엽니다. 조회조건과 행·열 영역의 틀, 조회 전 안내가 보입니다. 조회를 누르기 전에는 숫자가 없는 것이 정상입니다.

조회를 누르거나 Enter 키를 누릅니다. 역할별 요약 카드와 기간 표, 비교 차트가 함께 나타납니다. 전체 수수료와 계획 대비 증감을 먼저 확인합니다.

차원 칩을 행과 열 영역으로 옮깁니다. 사용 안 함 · 행 · 열 세 영역과 옮겨진 칩이 보입니다. 칩을 옮기면 표의 모양이 바뀝니다.

조회조건 머리를 접습니다. 조건 영역이 한 줄로 줄고 표 영역이 넓어집니다. 표를 크게 보며 작업할 때 사용합니다.
경영 요약 — 역할마다 같은 데이터를 다른 눈으로
CEO · CFO · 영업 책임자 · 자금 책임자 네 역할의 요약 카드를 바꿔 봅니다.

역할을 CFO 로 바꿉니다. 총 수수료, 기본 수수료, 부대 수수료, 수수료율과 계획 대비가 요약됩니다. 기본 수수료와 부대 수수료 중 어디서 차이가 나는지 봅니다.

역할을 영업 책임자로 바꿉니다. 국가·대리점 단위의 수수료와 미계획 수수료가 요약됩니다. 계획에 없던 대리점 계약이 어느 국가에 있는지 점검합니다.

역할을 자금 책임자로 바꿉니다. 지급 방식·통화별 정산비와 인센티브 비중이 요약됩니다. 송금 · 상계 · 이연 · 보류의 지급 부담을 확인합니다.
축 전환과 범위 — 끌어다 놓으면 표가 다시 짜인다
차원을 행과 열로 옮기고, 값 도움말로 범위를 좁히고, 손잡이로 차트 너비를 조절합니다. 모두 브라우저에서 다시 집계합니다.

열에 차원을 두 개 올립니다. 열 머리가 두 단계로 묶여 표시됩니다. 차원을 늘려도 총합은 변하지 않습니다.

차원 칩의 필터 단추를 누릅니다. 값 목록과 각 값의 문서 줄 수, 검색 칸이 열립니다. 여러 값을 골라 범위를 좁힙니다.

값을 고른 뒤 표를 봅니다. 선택한 값만 남은 표와 합계가 보입니다. 필터 후 합계는 선택 값의 큐브 합과 같아야 합니다.

손잡이를 끌어 표와 차트의 너비를 바꿉니다. 같은 범위의 막대 차트가 표 옆에 놓입니다. 차트도 서버 호출 없이 갱신됩니다.
칸에서 원천 문서까지
금액 칸을 누르면 그 칸을 이루는 정산 문서 라인이 열리고, 라인 합계가 칸 금액과 맞는지 바로 확인합니다.

금액 칸을 누릅니다. 그 칸을 이루는 정산 문서 라인 목록과 위쪽 일치 안내가 열립니다. 라인 합계와 칸 금액이 일치하는지 안내 줄을 봅니다.

다른 금액 칸을 눌러 봅니다. 칸마다 해당하는 문서 라인으로 목록이 바뀝니다. 어느 칸이든 같은 방식으로 합계를 대조합니다.

상단의 기간별 요약을 엽니다. 월별 문서 줄 수, 청구 금액, 수수료, 계획, 요인이 표로 나옵니다. 특정 월에 쏠린 증감이 있는지 점검합니다.
계산항목과 단계 보기
부대 수수료 · 수수료율 같은 계산항목을 단계 보기로 확인합니다.

보기 방식을 단계 보기로 바꿉니다. 총 수수료에서 수수료율까지 계산 단계가 위에서 아래로 나옵니다. 단계별 값이 식과 맞는지 확인합니다.
기준 대비 차이 — 계획과 견주고 사유를 남긴다
수수료 지급 계획과 실적의 차이를 칸마다 보고, 차이를 요인으로 분해하고, 변동 사유를 저장합니다.

기준 대비 스위치를 켭니다. 칸마다 기준 금액과 차이가 작은 글씨로 함께 나옵니다. 금액과 비율이 둘 다 기준을 넘는 칸이 색으로 강조됩니다.

행을 지역 › 국가 › 대리점으로 펼칩니다. 단계마다 계획 대비 차이와 증감률이 보입니다. 차이가 큰 대리점을 찾아 사유 단추를 누릅니다.

차이가 큰 행의 사유 단추를 누릅니다. 사유 코드와 설명을 적는 창이 열립니다. 저장하면 새로 고침 뒤에도 남습니다.

사유를 저장합니다. 저장된 행에 사유 표시가 붙습니다. 같은 행을 다시 열면 적은 내용을 고칠 수 있습니다.

표에서 행을 고르고 차이 분해를 봅니다. 계획에서 실적까지 여섯 요인이 폭포 차트로 이어집니다. 요인 합이 총 차이와 맞는지 아래 안내로 확인합니다.

전체 합계 행을 고릅니다. 요인 합계 3,591 / 총 차이 3,591 (오차 0) 안내가 보입니다. 요인 합 = 실적 − 계획 이 성립합니다.
AI 분석과 보고서
현재 범위를 읽은 해설과 근거 표, 그리고 브라우저에서 만든 파워포인트 보고서를 확인합니다.

AI 분석을 엽니다. 현재 범위의 요약과 핵심 발견이 규칙 기반으로 작성됩니다. 숫자는 화면 집계 값을 그대로 씁니다.

근거 보기를 펼칩니다. 해설에 쓴 숫자의 근거 표가 보입니다. 해설의 숫자를 근거 표와 견줘 확인합니다.

보고서 단추를 누릅니다. 현재 범위의 표와 차트가 담긴 파워포인트 파일이 내려받아집니다. 외부 라이브러리 없이 브라우저에서 만듭니다.
AI 에이전트 — 점검할 곳을 먼저 알려 준다
감시 규칙, 역할별 대기함, 활동 기록을 확인합니다. 실행은 하루 한 번만 허용됩니다.

AI 에이전트의 규칙 탭을 봅니다. 규칙, 지표, 기준값, 받을 역할, 사용 여부가 나옵니다. 기준값은 점검 목적에 맞게 조정합니다.

대기함 탭을 봅니다. 규칙에 걸린 항목이 역할별 보고로 쌓여 있습니다. 보고의 근거 금액을 확인하고 점검 대상을 정합니다.

활동 기록 탭을 봅니다. 실행 시각, 호출 주체, 결과, 걸린 건수가 나옵니다. 두 번째 호출은 하루 한 번 제한으로 건너뜁니다.
레이아웃 저장과 복원
자주 쓰는 배치를 이름 붙여 저장하고, 기본 레이아웃으로 지정하면 다음에 열 때 조회까지 끝낸 채 시작합니다.

레이아웃 메뉴에서 저장을 누릅니다. 이름과 기본 지정, 열 때 자동 조회 선택이 나옵니다. 자주 쓰는 배치만 저장해 둡니다.

레이아웃 관리를 엽니다. 저장된 목록과 기본 · 자동 조회 표시가 나옵니다. 이름 변경과 삭제도 여기서 합니다.

저장 후 화면을 새로 고칩니다. 축 배치와 항목이 저장했던 모양으로 돌아오고 조회까지 끝나 있습니다. 기본+자동 조회이면 열자마자 조회된 상태입니다.
좁은 화면과 한계
390px 폭의 세로 배치와, 행·열 조합 상한에 걸렸을 때의 안내를 확인합니다.

행이나 열 차원을 너무 많이 올립니다. 상한을 넘으면 표를 그리지 않거나 안내가 나옵니다. 차원을 줄이거나 필터를 겁니다.

좁은 화면으로 엽니다. 조건, 표, 차트가 세로로 쌓이고 차트가 표 아래에 놓입니다. 폰 폭에서도 잘림 없이 읽혀야 합니다.
화면 뒤에서 일어나는 일
조회 한 번으로 큐브(실적)와 계획을 받아 오고, 표·차트·요약은 모두 브라우저에서 이 두 묶음으로 다시 집계합니다. 칸을 누를 때만 원천 문서 라인을 나눠 읽고, 차이 분해·AI 해설·에이전트 실행은 서비스의 펑션 세 개가 맡습니다.
판정 조건과 조치
| 판정 조건 | 결과 상태 | 사용자 조치 |
|---|---|---|
| 실적 − 계획 > 0 이고 금액·비율 기준을 모두 초과 | 점검 필요(칸 색 강조) | 사유를 적고 원천 문서 라인을 확인 |
| 계획에 없는 키(대리점·기준 조합)로 발생한 수수료 | 미계획 요인에 집계 | 영업 책임자가 대리점·국가별로 확인 |
| 요인 여섯 개의 합 ≠ 실적 − 계획 | 대사 항목이 비정상으로 표시 | 집계 로직과 원천 데이터를 점검 |
| 규칙 기준값 초과(R1~R5) | 대기함에 역할별 보고 생성 | 받을 역할이 근거 금액을 확인 |
| 같은 날 에이전트를 다시 실행 | 하루 한 번 제한으로 건너뜀 기록 | 다음 날 다시 실행 |
처리 단계와 대사식
| 단계 | 내용 | 대사식 |
|---|---|---|
| ① 집계 | 정산 문서 라인을 기간·대리점·제품그룹·인코텀즈·수수료 기준 키로 큐브에 모은다 | 큐브 합계 = 원천 라인 합계 |
| ② 계획 대조 | 같은 키의 수수료 지급 계획과 맞춘다 | 실적 − 계획 = 총 차이 |
| ③ 요인 분해 | 물량·기본 수수료 단가·환율·성과 인센티브·정산비·미계획으로 나눈다 | 여섯 요인 합 = 총 차이 |
| ④ 원천 확인 | 칸에서 정산 문서 라인으로 내려가 합계를 대조한다 | 라인 합계 = 칸 금액 |
| ⑤ 항등식 | 총 수수료는 기본 수수료에 성과 인센티브와 정산비를 더한 값이다 | 총 수수료 = 기본 + 인센티브 + 정산비 |
조회조건
| 조건 | 구분 | 설명 |
|---|---|---|
| 회사코드 | 필수 | 기본 1000 |
| 시작 기간·종료 기간 | 필수 | 수수료 전기월 2026-01 ~ 2026-09, 분기 표시 함께 |
| 비교 기준 | 읽기 전용 | 수수료 지급 계획(연초 확정) |
| 저장된 레이아웃 | 선택 | 기본 레이아웃과 자동 조회 지정 가능 |
| 차원 필터 | 선택 | 지역·국가·대리점·인코텀즈·제품그룹·통화·사업부·수수료 기준·지급 방식 — 값 도움말에서 다중 선택 |
결과 컬럼
| 컬럼 | 의미 | 단위 |
|---|---|---|
| 총 수수료 | 기본 수수료 + 성과 인센티브 + 정산·송금비 | 백만원 |
| 기본 수수료 | 수수료 기준별 요율 × 수수료 대상 청구 금액 | 백만원 |
| 성과 인센티브 | 목표 초과분에 대한 가산 수수료 | 백만원 |
| 정산·송금비 | 송금·상계·이연에 드는 비용 | 백만원 |
| 수수료율 | 총 수수료 ÷ 수수료 대상 청구 금액 × 100 | % |
| 요인 · 물량 / 단가 / 환율 / 인센티브 / 정산비 / 미계획 | 기준 대비를 켰을 때 차이를 나눈 여섯 요인 | 백만원 |
좁은 화면에서 달라지는 것
390px 폭에서는 조회조건, 표, 차트가 세로로 쌓이고 차트가 표 아래에 놓입니다.
파일 구성
<앱 폴더>/
index.html · Component.js · manifest.json
controller/ · view/ · model/ · css/ · i18n/
odata/expcomm_srv/ metadata.xml · service.js · engine.js · json/(엔티티셋별 15개)
media/ intro.mp4 · intro_poster.jpg · intro_chapters.vtt
test/ 검증 전용(운영 배포 대상이 아님)
readme.html
SAP 표준 기능 확장 포인트
표준 실행은 SAP 표준 T-code 가 담당하고, 이 화면은 조회·검증 관점을 더해 확장합니다. 표준을 없애지 않고 끊기는 자리만 이어 붙입니다.
표준으로 되는 것과 안 되는 것
| 하고 싶은 일 | SAP 표준 | 표준에서 걸리는 자리 | 이 앱이 하는 일 |
|---|---|---|---|
| 판매 조건 확인 | VA03 판매 오더 조회 | 건별로는 충분하지만 대리점·기간 단위로 모아 보려면 화면을 반복해 열어야 합니다 | 조건과 수량을 큐브 키로 올려 한 번에 견줍니다 |
| 수수료 산정 기준 청구 확인 | VF03 청구 문서 조회 | 문서 한 건씩 열어 합계를 맞춥니다 | 칸 합계와 원천 라인 합계를 자동으로 대조합니다 |
| 지급 전표 확인 | FB03 회계 문서 조회 | 전표 단위라 대리점·기준별로 모아 보기 어렵습니다(확인 필요) | 지급 방식별 정산 부담을 같은 표에 놓습니다 |
| 대리점 미결 항목 확인 | FBL1N 공급업체 개별 항목 | 공급업체 단위 항목에는 수수료 기준·인코텀즈 관점이 없습니다 | 대리점별 수수료를 같은 표에 놓아 대사 대상을 좁힙니다 |
| 수익성 비교 | KE30 수익성 분석 보고서 | 수익성 보고서는 수수료 지급 계획 대비 요인 분해를 하지 않습니다 | 같은 차원으로 수수료 영향을 따로 봅니다 |
| 차이의 요인 분해 | 없음 | 표준에는 수수료 차이를 여섯 요인으로 나누는 화면이 없습니다 | 여섯 요인으로 가르고 합계를 검산합니다 |
T-code 별 연계 지점
| T-code | 이어받는 데이터 | 넘기는 키 | 표준에 남길 일 |
|---|---|---|---|
| VA03 | 수수료 라인의 원 판매 오더 조건 | 문서 번호 | 조건 수정 |
| VF03 | 수수료 산정 기준 청구 | 청구 문서 | 청구 정정 |
| FB03 | 수수료 발생·지급 전표(확인 필요) | 회계 문서 | 전표 수정·역분개 |
| FBL1N | 대리점별 미결·정산 항목 | 대리점 코드 | 지급 처리 |
| KE30 | 같은 차원의 수익성 비교 | 대리점·제품그룹 | 수익성 보고 확정 |
확장 포인트 — 운영에서 실제로 손대는 자리
| 자리 | 하는 일 | 결정 주체 |
|---|---|---|
| 수수료 기준 매핑 | 정산 문서의 조건 유형을 표준 · 물량 구간 · 신규 시장 · 독점 · 프로젝트에 연결 | 영업관리 |
| 지급 방식 매핑 | 송금 · 상계 · 이연 · 선지급 · 보류 연결 | 자금 |
| 환율 유형 | 월 평균 환율 또는 전표 환율 선택 | 재경 |
| 규칙 기준값 | R1~R5 기준값과 받을 역할 조정 | 재경·영업관리 |
분석 지표 정의표
| 지표 | 산식·판정 기준 | 대응 기능 | 원천 데이터 |
|---|---|---|---|
| 총 수수료 | 기본 수수료 + 성과 인센티브 + 정산·송금비 | 표·KPI·차트 | 큐브 Comm |
| 수수료율 | 총 수수료 ÷ 수수료 대상 청구 금액 × 100 | KPI·규칙 R5 | 계산항목 |
| 물량 요인 | (실적 수량 − 계획 수량) × 계획 단가 × 계획 환율 | 차이 분해 | FQty |
| 기본 수수료 단가 요인 | 수량 × (실적 단가 − 계획 단가) × 계획 환율 | 차이 분해 | FPrice |
| 환율 요인 | 실적 외화 수수료 × (실적 환율 − 계획 환율) | 차이 분해 | FFx |
| 인센티브·정산비 요인 | 실적 − 계획 | 차이 분해 | FIncent · FSettle |
| 미계획 요인 | 계획에 없는 키의 실적 전액 | 차이 분해·규칙 R2 | FUnpl |
CDS 구성
실데이터로 옮길 때의 뷰 구성 스케치입니다. 이름 접두어와 원천 테이블은 회사의 명명 규칙과 SAP 환경에 맞춰 정합니다(수수료 조건 유형은 확인 필요).
뷰 레이어 구성
| 레이어 | 뷰 | 역할 |
|---|---|---|
| 매핑 | ZI_CommBasisMap | 조건 유형을 수수료 기준·지급 방식 코드에 연결 |
| 기준 | ZI_CommItemBase | 정산 문서 라인 한 줄 |
| 큐브 | ZC_CommCube | 월 단위 집계 |
| 계획 | ZI_CommPlan | 같은 키의 지급 계획 |
| 쿼리 | ZQ_CommQuery | 화면이 읽는 모양 |
| 권한 | ZR_CommAccess | 집계 단계 권한 |
| 서비스 | ZUI_ExpComm | 엔티티셋 게시 |
-- ① 수수료 기준 매핑 : 정산 문서의 수수료 조건을 화면의 수수료 기준 코드에 연결
@EndUserText.label: '수수료 기준 매핑'
define view entity ZI_CommBasisMap as select from ztcomm_basis
{ key cond_type as CondType,
basis_code as Basis, -- STD 표준 · VOL 물량 구간 · NEW 신규 시장 · EXC 독점 · PRJ 프로젝트
paymode_code as PayMode } -- REMT 월 송금 · OFFS 상계 · DEFR 이연 · ADVN 선지급 · HOLD 보류-- ② 정산 문서 라인 기준 뷰 : 금액 · 수량 · 환율을 한 줄로
define view entity ZI_CommItemBase as select from vbrp
association [1..1] to vbrk as _Head on _Head.vbeln = $projection.BillRef
association [0..1] to ZI_CommBasisMap as _Map on _Map.CondType = $projection.CondType
{ key vbeln as BillRef, key posnr as Item,
fkimg as Qty,
netwr as NetAmount,
_Head.waerk as Currency,
_Map.Basis, _Map.PayMode, _Head, _Map }-- ③ 큐브 뷰 : 월 단위로 수수료를 모은다 (화면의 합계는 모두 여기서 나온다)
@Analytics.dataCategory: #CUBE
define view entity ZC_CommCube as select from ZI_CommItemBase
{ key Period, key Agent, key ProdGroup, key Incoterms, key Basis,
@DefaultAggregation: #SUM Base,
@DefaultAggregation: #SUM Incent,
@DefaultAggregation: #SUM Settle,
@DefaultAggregation: #SUM Base + Incent + Settle as Comm }-- ④ 계획 뷰 : 같은 키의 수수료 지급 계획 (기준 대비는 키 대응으로 계산)
define view entity ZI_CommPlan as select from ztcomm_plan
{ key version as Version, key period as Period, key agent as Agent,
key prodgroup as ProdGroup, key incoterms as Incoterms, key basis as Basis,
qty as Qty, comm_amount as Comm }-- ⑤ 분석 쿼리 : 회사코드는 필수, 기간은 구간으로 받는다
@Analytics.query: true
define view entity ZQ_CommQuery as select from ZC_CommCube
{ @Consumption.filter: { mandatory: true } Bukrs,
@Consumption.filter: { selectionType: #INTERVAL } Period,
Agent, ProdGroup, Incoterms, Basis, Comm, Base, Incent, Settle }-- ⑥ 권한 : 집계 단계에 건다
define role ZR_CommAccess {
grant select on ZQ_CommQuery
where ( Bukrs ) = aspect pfcg_auth( F_BKPF_BUK, BUKRS, ACTVT = '03' ); }-- ⑦ 서비스 정의 : 화면이 읽는 엔티티셋을 한 곳에서 게시
define service ZUI_ExpComm {
expose ZQ_CommQuery as CubeSet;
expose ZI_CommPlan as PlanSet;
expose ZI_CommItemBase as ItemSet; }
운영 시점에 해야 할 일
개발보다 정하는 일이 많습니다.
| 정할 일 | 정하지 않으면 | 결정 주체 |
|---|---|---|
| 수수료 조건 유형·정산 문서 구조 | 수수료가 청구 금액과 어긋나 보임 | 재경·영업관리 |
| 수수료 기준 코드 매핑 | 요인 분해가 미계획으로 몰림 | 영업관리 |
| 환율 유형·환산 시점 | 환율 요인이 의미를 잃음 | 재경 |
| 지급 방식 정의 | 자금 요약이 의미를 잃음 | 자금 |
| 부호 규칙 | 합계가 어긋남 | 재경 |
숫자를 믿을 수 있는가 — 검증 결과
대사식별 검사 건수와 차이 건수입니다. 의도적 예외는 55개 키(미계획 1,736백만원)로 대사 차이와 분리해 기록했습니다.
| 대사식 | 검사 건수 | 차이 건수 |
|---|---|---|
| 총 수수료(큐브 = 원천) | 1 | 0 |
| 기본 수수료 | 1 | 0 |
| 성과 인센티브·정산비 | 2 | 0 |
| 청구 금액·수량 | 2 | 0 |
| 문서 줄 수 | 1 | 0 |
| 총 수수료 항등식 | 1 | 0 |
| 요인 합계 = 총 차이 | 1 | 0 |
| 통화별 외화 기본 수수료(CNY·EUR·JPY·USD) | 4 | 0 |
운영 데이터로 갈 때
실데이터에서는 문서 줄이 수천만 건까지 늘 수 있습니다. 조회 때 기간과 회사코드로 범위를 좁히고, 큐브는 월 단위로 미리 집계해 두는 구성을 권합니다.
자주 묻는 질문
숫자와 산식, 화면과 조작, 분석 기능, 도입과 운영 네 묶음으로 21문항을 정리했습니다.
숫자와 산식
총 수수료는 어떻게 계산합니까?
기본 수수료에 성과 인센티브와 정산·송금비를 더한 값입니다. 외화 금액은 통화별 환율로 원화 환산해 백만원 단위로 보여 줍니다. 계산은 서비스가 하고 화면은 읽어서 보여 줍니다. 샘플 환율은 가정값입니다.
계획과의 차이는 무엇입니까?
같은 키(기간·대리점·제품그룹·인코텀즈·수수료 기준)의 수수료 지급 계획과 실적의 차이입니다. 샘플 범위에서 계획 18,271백만원, 실적 21,863백만원으로 +3,591백만원입니다.
요인 합계가 총 차이와 정말 같습니까?
같습니다. 샘플 범위에서 요인 합계 3,591백만원이 총 차이와 일치하며, 화면이 매번 요인 합계와 총 차이를 나란히 보여 줍니다. 어긋나면 대사 항목이 확인 필요로 바뀝니다.
미계획은 무엇입니까?
계획에 없던 키에서 발생한 수수료 전액입니다. 샘플에서는 55개 키, 1,736백만원이며 일부러 넣은 점검용 예외라 대사 차이와 따로 기록합니다.
환율 요인은 어떻게 읽습니까?
계획 환율과 실적 환율의 차이로 생기는 금액입니다. 샘플에서는 +144백만원입니다. 통화가 많은 회사는 통화별로 나누어 보고 환율 유형은 재경과 정합니다.
원인을 확정해 주나요?
아닙니다. 요인은 계획과 실적을 비교한 분류이며 점검 필요 항목을 보여 줄 뿐입니다. 점검 도구이며 최종 판단은 회사와 감사인(세무 신고는 회사와 세무 대리인)이 합니다.
화면과 조작
행과 열에 몇 개까지 올릴 수 있습니까?
행에는 최대 3개, 열에는 최대 2개 차원을 올릴 수 있습니다. 열 조합이 36개를 넘으면 토스트로 막고, 표 행이 한도를 넘으면 표를 그리지 않고 줄이는 방법을 안내합니다.
축을 바꾸면 서비스를 다시 부릅니까?
부르지 않습니다. 조회 때 받은 큐브를 브라우저에서 다시 집계하므로 축을 바꿔도 즉시 반응하고 합계가 달라지지 않습니다.
칸 값과 원천 합계가 다르면 어떻게 됩니까?
대화상자 위쪽 안내가 확인 필요로 바뀝니다. 먼저 필터 범위와 표시 단위(백만원)를 확인한 뒤 원천 라인을 살펴봅니다.
변동 사유는 어디에 저장됩니까?
조회 범위와 행 경로에 묶여 서버에 저장됩니다. 축을 바꾸거나 새로 고쳐도 같은 행에 따라옵니다.
레이아웃은 무엇을 저장합니까?
축 배치, 분석 항목, 보기 방식을 이름 붙여 저장합니다. 기본 레이아웃과 자동 조회를 지정하면 다음에 열 때 조회까지 끝낸 채 시작합니다.
모바일이나 좁은 화면에서도 씁니까?
390px 폭에서 조회조건, 표, 차트가 세로로 쌓이도록 만들었습니다. 넓은 표는 행과 열을 줄여 보는 것을 권합니다.
분석 기능
AI 분석이 숫자를 만들어 내지 않나요?
만들지 않습니다. 해설의 모든 숫자는 화면 집계 값이며 근거 표를 펼쳐 확인할 수 있습니다. 모델 연결은 서비스 안 설정 하나로 켜고 기본은 꺼져 있으며, 키는 화면에 두지 않습니다.
PowerPoint 보고서는 어디서 만듭니까?
브라우저에서 만듭니다. 외부 라이브러리 없이 현재 범위의 표와 차트를 담아 내려받으며, 서버에 올리지 않습니다.
AI 에이전트는 무엇을 합니까?
감시 규칙(기준값·받을 역할)에 걸린 항목을 역할별 대기함에 보고로 올립니다. 실행은 하루 한 번으로 서버가 제한하고 걸린 것이 없어도 활동 기록을 남깁니다. 운영 배치 연결은 별도로 정합니다.
에이전트를 하루에 여러 번 돌리면 어떻게 됩니까?
두 번째부터는 하루 한 번 제한으로 건너뛰고 그 사실이 활동 기록에 남습니다.
규칙의 기준값은 바꿀 수 있습니까?
바꿀 수 있습니다. 규칙마다 지표·기준값·받을 역할·사용 여부가 있어 회사의 점검 기준에 맞춰 조정합니다.
도입과 운영
어떤 부서가 가장 먼저 쓰게 됩니까?
영업 관리, 자금, 재경이 같은 숫자를 서로 다른 눈으로 봅니다. 역할별 요약이 있어 각자 먼저 볼 숫자부터 시작할 수 있습니다.
적용 시기와 범위는 어떻게 정합니까?
이 글의 숫자는 가상의 검증용 샘플 데이터입니다. 실데이터 적용 시기와 범위는 고객사의 SAP 환경과 대리점 수수료 정산 구조를 확인한 뒤 정합니다.
SAP 표준 T-code 와의 관계는 무엇입니까?
표준을 대체하지 않습니다. 원천 확인은 VA03·VF03 에서, 지급 · 미결 대사는 FB03·FBL1N 에서 합니다. 수수료 조건 유형과 정산 문서 구조는 회사마다 달라 확인 필요입니다.
누가 최종 판단을 합니까?
이 화면은 분류·집계·대사를 돕는 점검 도구이며 최종 판단은 회사와 감사인(세무 신고는 회사와 세무 대리인)이 합니다.