Files
sam-docs/sam/docs/rules/billing-policy.md
김보곤 24a542cb95 docs: [과금정책] 과금정책 통합 문서 작성
- 본사 지출 과금정책 (바로빌, AI/클라우드)
- 고객 안내용 과금정책 (가입비, 구독료, 추가 옵션)
- 내부 정산 정책 (영업 수당, 마진 구조)
- INDEX.md에 과금정책 문서 등록
2026-02-21 19:03:12 +09:00

9.0 KiB
Raw Blame History

SAM 과금정책 통합 문서

작성일: 2026-02-21 상태: 설계 확정


1. 개요

1.1 목적

SAM 프로젝트의 과금정책을 본사 지출고객 안내 두 관점으로 통합 정리한다.

1.2 적용범위

  • 외부 서비스 이용 비용 (바로빌, Google, Anthropic)
  • 고객 계약 요금표 (가입비, 구독료, 추가 옵션)
  • 내부 정산 (영업 수당, 마진 구조)

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 포함) 코드브릿지엑스 지원 → 본사 부담 (무료)
홈택스 매출 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. 고객 안내용 과금정책 (Company → Customer)

고객 계약서에 명시되는 서비스 요금이다.

3.1 기본 서비스 요금

제조업 기본 패키지

  • 포함: 품목관리 → 견적 → 수주 → 생산 → 출하 (ERP 인사/회계 무료 포함)
  • 가입비: 2,000만원
  • 구독료: 50만원/월

개별 모듈

모듈명 가입비 구독료 (월)
QR코드 관리 1,020만원 5만원
사진/출하 관리 1,920만원 10만원
검사/토큰 적용 1,020만원 5만원
이카운트 연동 1,920만원 10만원

통합 패키지

패키지명 가입비 구독료 (월)
공사관리 패키지 4,000만원 20만원
공정/정부지원사업 8,000만원 40만원

3.2 추가 옵션 요금

옵션명 가입비 추가 구독료 추가 (월)
생산공정 1개 추가 500만원 10만원
품질관리 (인정검사) 2,000만원 50만원
사진 등록 - 10만원
챗봇/녹음/업무일지 - 각 20만원
연구소 연구노트 - 5만원
장비점검, 사무소 정비 - 5만원

참고: 품질관리(인정검사)에는 '장비점검, 사무소 정비' 기능이 기본 포함된다.

3.3 사용량 기반 추가 과금

수당 제외 항목이며, 기본 제공 한도 초과 시 실비 과금한다.

항목 기본 제공 추가 과금 기준
파일 저장 공간 100GB 100GB당 10만원/월
AI 토큰 월 100만 토큰 1,000토큰 단위 실비 과금

AI 토큰 사용량 체감 (100만 토큰 기준)

활용 시나리오 예상 처리량
음성 회의 요약 약 520분 (8.6시간)
문서 자료 정리 (A4) 약 300~400매
이메일/노트 분류 약 1,500~2,000건
  • 미사용 잔여 토큰은 이월되지 않는다 (매월 1일 갱신)
  • 기본 제공량 80%, 100% 소진 시 자동 알림 발송

3.4 바로빌 부가 서비스 요금

고객이 선택적으로 이용하는 바로빌 연동 서비스이다.

서비스 과금 방식 기본 제공 추가 과금 부담 주체
계좌조회 월정액 10,000원 1계좌 추가 1계좌당 10,000원 고객
카드내역 월정액 10,000원 5장 추가 1장당 5,000원 고객
홈택스 매입/매출 월 33,000원 × 2 - - 본사 (무료)
세금계산서 발행 건별 100건 추가 50건당 5,000원 고객

과금 계산 예시:

  • 법인카드 8장 등록 → (8-5) × 5,000 = 15,000원 추가
  • 세금계산서 151건 → ceil((151-100)/50) × 5,000 = 10,000원 추가

4. 내부 정산 정책

4.1 영업 수당 체계

수당은 가입비에 대해서만 지급한다. 구독료는 수당 대상이 아니다.

구분 지급 비율 대상
판매자 수당 가입비의 20% 직접 영업 및 계약 성사 담당자
관리자 수당 가입비의 5% 판매자의 직속 상위 관리자
협업 수당 별도 산정 메뉴 제작 및 기술 지원 협업자

수당 산정 예시 (기본 패키지 2,000만원)

항목 금액
판매자 수당 (20%) 400만원
관리자 수당 (5%) 100만원
회사 운영비 (~75%) 1,500만원
  • 지급 시점: 가입비 입금 완료 확인 후 익월 정산일
  • 회사 마진: 가입비의 약 70~75% (인프라 유지, 마케팅 등)

4.2 가격 책정 배경

  • 내부 총 개발비 산정: 약 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. 관련 문서


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