Files

김보곤 98b01bf633 fix: [과금정책] 홈택스 매입/매출 조회 단일 서비스 33,000원으로 수정

- 홈택스 매입/매출은 하나의 서비스 (월 33,000원 × 2 → 월 33,000원)
- billing-policy.md: 매입/매출 2행 → 1행 통합
- customer-pricing.md: × 2 제거
- 서비스이용계약서 DOCX/Markdown: × 2 제거
- 슬라이드 HTML 2종: × 2 제거, 2행 → 1행 통합

2026-02-22 18:55:58 +09:00

6.8 KiB

Raw Blame History

SAM 과금정책 — 내부용 (CONFIDENTIAL)

작성일: 2026-02-21 상태: 설계 확정 열람 범위: 내부 개발팀/관리층 전용 — 대외 공유 금지

문서 분리 안내

과금정책이 대상 독자별 3개 문서로 분리되었다.

문서	대상	내용
고객 요금 안내	고객	서비스 가격표, 과금 기준
영업파트너 수당 체계	영업파트너	수당률, 정산 프로세스
본 문서 (billing-policy.md)	내부 개발팀/관리층	본사 원가, 마진율, 코드 참조

1. 개요

1.1 목적

SAM 프로젝트의 과금정책 중 본사 지출 원가, 마진 구조, 코드 참조를 정리한다. 고객 공개용 요금과 영업파트너 수당 체계는 별도 문서로 분리되었다.

1.2 적용범위

외부 서비스 이용 비용 (바로빌, Google, Anthropic)
마진 구조 및 가격 책정 배경
코드 참조 (모델, 서비스, DB 테이블)

1.3 용어 정의

용어	설명
개발비	서비스 도입 시 1회 납부하는 초기 비용
구독료	서비스 유지를 위한 월 정기 비용
토큰	AI가 언어를 처리하는 최소 단위 (한글 ~1.5자 = 1토큰)
MRR	Monthly Recurring Revenue (월간 반복 매출)

2. 본사 지출 과금정책 (Company → Service Provider)

본사가 외부 서비스 제공자에게 납입하는 비용이다.

2.1 바로빌 API 비용

월정액 서비스

서비스	월정액	비고
계좌조회	10,000원	고객 부담
카드내역	10,000원	고객 부담
홈택스 매입/매출	33,000원 (VAT 포함)	코드브릿지엑스 지원 → 본사 부담 (무료)

참고: 계좌조회/카드내역 월정액은 고객에게 전가한다. 홈택스는 본사가 흡수한다.

건별 과금

서비스	단가	비고
전자세금계산서 발행	100원/건	원가 기준

2.2 AI/클라우드 서비스 비용

토큰 기반 과금 (LLM)

제공자	모델	입력 단가 (USD/1M)	출력 단가 (USD/1M)	입력 (KRW/1M)	출력 (KRW/1M)
Google	Gemini 2.0 Flash	$0.10	$0.40	140원	560원
Anthropic	Claude 3 Haiku	$0.25	$1.25	350원	1,750원

시간/작업 기반 과금

서비스	단가 (USD)	단위	KRW 환산
Google STT	$0.009	15초당	12.6원/15초 (약 50원/분)
Google GCS	$0.005	1,000건당	7원/1,000건
Google FCM	무료	-	-

환율 기준

기본 환율: 1,400원/USD
ai_pricing_configs 테이블에서 동적 관리
캐시 TTL: 1시간

2.3 본사 지출 월간 예상 (테넌트 1개 기준)

항목	최소	최대	비고
바로빌 홈택스	0원	0원	코드브릿지엑스 지원
세금계산서 원가	~5,000원	~10,000원	50~100건 기준
AI 토큰 (Gemini)	~100원	~5,000원	사용량 비례
GCS/STT	~50원	~2,000원	사용량 비례

3. 고객 안내용 과금정책

고객 요금 상세는 고객 요금 안내 문서를 참조한다.

4. 내부 정산 정책

4.1 영업 수당 체계

수당률 및 정산 프로세스는 영업파트너 수당 체계 문서를 참조한다.

4.2 마진 구조

회사 마진: 개발비의 약 67~75% (가입 유형에 따라 변동)
- 개인 가입: 개발비의 약 72~~75% (수당 25~~28% 차감 후)
- 단체 가입: 개발비의 약 67% (수당 33% 차감 후)

4.3 가격 책정 배경

내부 총 개발비 산정: 약 7,600만원
구성: 개발비 2,000만원 + 장기 구독(약 7년) 및 금융 비용(4.6%)
중소기업 초기 투자 부담 분산 구조

5. 코드 참조 (개발자용)

5.1 바로빌 과금

파일	내용
`mng/app/Models/Barobill/BarobillSubscription.php`	`DEFAULT_MONTHLY_FEES` 월정액 상수
`mng/app/Models/Barobill/BarobillBillingRecord.php`	`USAGE_UNIT_PRICES` 건별 단가 상수
`mng/app/Models/Barobill/BarobillPricingPolicy.php`	과금 정책 모델 + `calculateBilling()`
`mng/app/Services/Barobill/BarobillBillingService.php`	월정액/건별 과금 처리 서비스
`mng/app/Services/Barobill/BarobillUsageService.php`	사용량 집계 및 과금 계산
`mng/database/seeders/BarobillPricingPolicySeeder.php`	과금 정책 시더 (5개 정책)

5.2 AI 가격/토큰

파일	내용
`api/app/Models/Tenants/AiPricingConfig.php`	AI 단가 모델 + `getActivePricing()`
`api/app/Models/Tenants/AiTokenUsage.php`	토큰 사용량 기록 모델
`api/app/Services/AiReportService.php`	토큰 비용 계산 로직 (`saveTokenUsage()`)
`api/database/migrations/2026_02_09_*_ai_pricing_configs.php`	AI 단가 테이블 + 시드 데이터
`api/database/migrations/2026_02_07_*_ai_token_usages.php`	토큰 사용량 테이블

5.3 정산 관련

파일	내용
`mng` 또는 `api` 정산 컨트롤러/서비스	영업수수료, 구독료, 컨설팅비 정산

5.4 DB 테이블 참조

테이블	설명
`barobill_subscriptions`	바로빌 월정액 구독 현황
`barobill_billing_records`	바로빌 월별 과금 내역
`barobill_pricing_policies`	바로빌 과금 정책 (무료 제공량, 추가 단가)
`ai_pricing_configs`	AI 제공자별 단가 설정
`ai_token_usages`	AI 토큰 사용량 기록
`ai_voice_recordings`	AI 음성 녹음 (STT 비용 발생)
`sales_commissions`	영업수수료 정산

6. 관련 문서

고객 요금 안내 - 서비스 가격표 (고객 공개용)
영업파트너 수당 체계 - 수당률 및 정산 (파트너용)
단가 정책 (품목) - 품목 단가/원가 계산
영업수수료정산
구독료정산
컨설팅비용정산
고객사정산
sales/price/수당지급체계.md - 수당 지급 체계 상세
sales/policy/SAM_영업정책문서.md - 영업 정책 상세
sales/price/ref/토큰정책.md - AI 토큰 고객 안내 가이드

공통 안내: 본 문서에 명시된 모든 개발비 및 구독료는 부가가치세(VAT) 별도 금액이다.

최종 업데이트: 2026-02-21

6.8 KiB Raw Blame History