docs: 수수료 레퍼런스에 갭보완 4종(§3-7) 반영 + 간이지급명세서 주민번호 화면 마스킹
- 수수료_계산공식_전체레퍼런스.md: §3-7 감사 보완 4종(A 지급보류/B 환수원천세역분개/ C 환수채권연체이자/D 간이지급명세서) 추가, schema v126 표기 - SimplifiedPaymentReport: 화면 표시용 주민번호 마스킹(생년월일+성별구분 이후 *). 엑셀 export는 국세청 제출용이라 원본 유지 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
+42
-1
@@ -121,6 +121,47 @@ net = gross − 소득세 − 지방세 + 부가세 − 공제(deduction)
|
||||
|
||||
---
|
||||
|
||||
## 3-7. 2026-06 감사 보완 4종 (V124~V126)
|
||||
|
||||
설계사 지급성 수수료 종류는 사실상 완비된 상태에서, 감사로 발견한 **실제 결함·규제 갭**만 보완.
|
||||
|
||||
### 3-7-A. 지급보류(HOLD) 지급배치 제외 — **버그 수정**
|
||||
```
|
||||
지급배치 대상 = settle_master WHERE payable_amount>0 AND status NOT IN ('PAID','HOLD')
|
||||
```
|
||||
- 종전엔 `status != 'PAID'` 만 검사 → 운영자가 지급보류(HOLD)한 설계사도 펌뱅킹 이체에 포함되던 결함.
|
||||
(`PaymentBatchItemMapper.insertFromSettleMaster`)
|
||||
|
||||
### 3-7-B. 환수 원천세 역분개 — 교차월 환수 시 기납부 원천세 보정
|
||||
```
|
||||
gross<0(상계되지 않은 환수분)인 월:
|
||||
역분개 기준액 = |gross|
|
||||
소득세 역분개 = −(|gross| × 소득세율) ← withholding_tax_adjustment (음수)
|
||||
지방세 역분개 = −(소득세 역분개액 × 10%)
|
||||
분기 원천세신고 = Σpayment(원천세) + Σadjustment(역분개, 음수) ← 과대신고 해소
|
||||
```
|
||||
- gross≥0(당월 환수가 양수분으로 상계)인 달은 당월 과세에 이미 반영 → **역분개 미발생**(이중계상 없음).
|
||||
- settle_master gross/net/carryover/payable 흐름은 **불변**(역분개는 신고보정용 별도 레코드).
|
||||
(`AggregateStep` gross<0 분기, `WithholdingTaxReportMapper.upsertQuarterlyAggregate`)
|
||||
|
||||
### 3-7-C. 환수채권 연체이자 — 미수채권 이월 시 월 단리 적립
|
||||
```
|
||||
당월 적립이자 = 채권잔액(balance) × 연체이자율(%) / 1200 (월 단리, scale 0)
|
||||
적립조건 = origin_settle_month ≤ 당월 − (거치기간+1)
|
||||
balance += 적립이자 (→ 기존 FIFO 상계가 이자까지 회수)
|
||||
```
|
||||
- 이자율 `CLAWBACK_OVERDUE_INTEREST_RATE`(기본 0=미적립 안전폴백), 거치기간 `CLAWBACK_INTEREST_GRACE_MONTHS`(기본 0).
|
||||
- 멱등: `clawback_interest` 이력으로 당월 적립분 reverse 후 재적립. (`AggregateStep.reverseAndAccrueClawbackInterest`)
|
||||
|
||||
### 3-7-D. 사업소득 간이지급명세서(월별) — 국세청 제출 대응
|
||||
```
|
||||
간이지급명세서 = commission_statement(MONTHLY) ⋈ agent
|
||||
(소득자·주민/사업자번호·지급액·소득세·지방소득세·차인지급액)
|
||||
```
|
||||
- 신규 데이터테이블 없음(읽기전용 리포트). 조회 + 엑셀 export. (`ReportMapper.selectSimplifiedPayment`)
|
||||
|
||||
---
|
||||
|
||||
## 4. 실지급 흐름 한 장 요약
|
||||
|
||||
```
|
||||
@@ -138,4 +179,4 @@ net = gross − 소득세 − 지방세 + 부가세 − 공제(deduction)
|
||||
|
||||
*기준 코드: CommissionCalculator, TaxCalculator, ChargebackCalculator, InstallmentPlanGenerator,
|
||||
RegulatoryLimitChecker, CalcRecruit/Maintain/OverrideStep, AggregateStep, AccountingEntryGenerateStep,
|
||||
P7/P8 12개 commission Service. schema v110. 2026-06 수수료 감사 수정 반영.*
|
||||
P7/P8 12개 commission Service. schema v126. 2026-06 수수료 감사 수정 + 갭보완 4종(§3-7) 반영.*
|
||||
|
||||
Reference in New Issue
Block a user