korean-invoice

한국형 견적서/세금계산서 생성기 — 한국 표준 양식으로 견적서와 세금계산서를 자동 생성. 사업자등록번호, 공급가액, 부가세 자동 계산 지원.

언제 사용하나요?

• 고객에게 견적서 발송
• 세금계산서 발행
• 거래처 정보 관리
• 자주 쓰는 품목 DB 관리
• PDF/HTML 형식으로 출력

빠른 시작

# 견적서 생성 (대화형)
korean-invoice quote

# 거래처 저장된 경우
korean-invoice quote --client "무펭이즘"

# 세금계산서 생성
korean-invoice tax --client "무펭이즘"

# 거래처 추가
korean-invoice client add "무펭이즘" --business-number "123-45-67890" --ceo "김형님"

# 품목 추가
korean-invoice item add "포토부스 대여" --price 500000 --unit "일"

# 거래처 목록
korean-invoice client list

# 품목 목록
korean-invoice item list

견적서 필드

필드	설명	필수
client	거래처명 (저장된 거래처 ID)	✅
items	품목 리스트 (품목명, 수량, 단가)	✅
issueDate	작성일자 (기본: 오늘)	❌
validUntil	유효기간 (기본: +30일)	❌
notes	비고	❌
includeVAT	부가세 포함 여부 (기본: true)	❌

세금계산서 필드

필드	설명	필수
client	공급받는자 (거래처 ID)	✅
items	품목 리스트	✅
issueDate	작성일자	✅
type	영수/청구 (기본: 영수)	❌
notes	비고	❌

자동 계산

공급가액:     500,000 원
부가세(10%):   50,000 원
합계:         550,000 원

• 공급가액 입력 시 부가세 10% 자동 계산
• 총액 입력 시 역산 (총액 ÷ 1.1)
• 품목별 소계 자동 합산

거래처 관리

# 거래처 추가
korean-invoice client add "무펭이즘" \
  --business-number "123-45-67890" \
  --ceo "김형님" \
  --address "서울시 강남구..." \
  --phone "010-1234-5678" \
  --email "contact@mufism.com"

# 거래처 수정
korean-invoice client edit "무펭이즘" --phone "010-9999-9999"

# 거래처 삭제
korean-invoice client remove "무펭이즘"

# 거래처 상세 조회
korean-invoice client view "무펭이즘"

거래처 데이터는 data/clients.json에 저장됩니다.

품목 관리

# 품목 추가
korean-invoice item add "포토부스 대여" --price 500000 --unit "일"

# 품목 수정
korean-invoice item edit "포토부스 대여" --price 600000

# 품목 삭제
korean-invoice item remove "포토부스 대여"

# 품목 목록
korean-invoice item list

품목 데이터는 data/items.json에 저장됩니다.

템플릿

견적서 템플릿

• 공급자 정보 (사업자등록번호, 상호, 대표자, 주소, 연락처)
• 공급받는자 정보
• 작성일자, 유효기간
• 품목 테이블 (품명, 규격, 수량, 단가, 공급가액)
• 합계 (공급가액, 부가세, 총액)
• 비고

세금계산서 템플릿

• 승인번호 (임의 생성)
• 공급자/공급받는자 정보 (사업자등록번호, 상호, 성명, 주소)
• 작성일자
• 품목 테이블
• 합계 (공급가액, 세액)
• 영수/청구 구분

출력 형식

• HTML: 브라우저에서 바로 확인
• PDF: HTML → PDF 변환 (puppeteer 사용)
• 저장 경로: output/YYYY-MM-DD-{type}-{client}.pdf

내 정보 설정

내 사업자 정보는 data/my-info.json에 저장:

{
  "businessNumber": "123-45-67890",
  "companyName": "무펭이즘",
  "ceo": "김무펭",
  "address": "서울시 강남구...",
  "phone": "010-1234-5678",
  "email": "contact@mufism.com",
  "bankAccount": "우리은행 1002-123-456789"
}

사용 예시

1. 간단한 견적서 생성

korean-invoice quote \
  --client "무펭이즘" \
  --items "포토부스 대여,2,500000" \
  --notes "부가세 별도"

2. 저장된 품목 사용

# 품목 미리 저장
korean-invoice item add "포토부스 대여" --price 500000 --unit "일"
korean-invoice item add "출장비" --price 100000 --unit "회"

# 품목 ID로 견적서 생성
korean-invoice quote --client "무펭이즘" --item-ids "포토부스 대여,출장비"

3. 세금계산서 발행

korean-invoice tax --client "무펭이즘" --items "포토부스 대여,1,500000" --type 영수

통합

• message 스킬과 연동하여 이메일/Discord로 전송
• daily-report에서 작업 시간 → 견적서 변환
• calendar 스킬로 유효기간 알림 설정

주의사항

• 사업자등록번호는 123-45-67890 형식으로 입력
• 금액은 원 단위로 입력 (콤마 없이 숫자만)
• PDF 생성은 OpenClaw 브라우저가 실행중이어야 함