unified-invoice（统一发票）

Unified Invoice Generator 📄🐧

통합됨: 기존 invoice-gen, korean-invoice 스킬을 통합

한국형 견적서/세금계산서 + 프리랜서 인보이스를 하나로.

주요 기능

• 📋 한국형 견적서: 사업자등록번호, 공급가액, 부가세 자동 계산
• 🧾 세금계산서: 영수/청구 구분, 승인번호 생성
• 💼 프리랜서 인보이스: Markdown/PDF, 다국어 지원 (KRW/USD/EUR)
• 🏢 거래처 관리: 사업자 정보, 연락처 DB
• 📦 품목 관리: 자주 쓰는 품목 저장 및 재사용
• 📄 PDF 출력: HTML → PDF 자동 변환
• 🔢 자동 계산: 공급가액, 부가세, 총액 자동 계산

빠른 시작

한국형 견적서 생성

node scripts/generate.js quote \
  --client "무펭이즘" \
  --items "포토부스 대여,2,500000" \
  --notes "부가세 별도"

세금계산서 생성

node scripts/generate.js tax \
  --client "무펭이즘" \
  --items "포토부스 대여,1,500000" \
  --type 영수

프리랜서 인보이스 (영문)

node scripts/generate.js invoice \
  --client "Acme Corp" \
  --items "Web development,40h,50" \
  --currency USD \
  --lang en

문서 타입

견적서 필드

세금계산서 필드

자동 계산

한국형 (부가세 10%)

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

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

프리랜서 (VAT + Withholding)

Subtotal:      $2,000
VAT (10%):       $200
Withholding:    -$66  (3.3% for Korean freelance)
Total:        $2,134

• 국가별 세율 커스터마이징 가능
• 원천징수세 자동 계산 (한국 프리랜서 3.3%)

거래처 관리

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

# 거래처 목록
node scripts/manage-clients.js list

# 거래처 상세 조회
node scripts/manage-clients.js view "무펭이즘"

# 거래처 수정
node scripts/manage-clients.js edit "무펭이즘" --phone "010-9999-9999"

# 거래처 삭제
node scripts/manage-clients.js remove "무펭이즘"

거래처 데이터: data/clients.json

품목 관리

# 품목 추가
node scripts/manage-items.js add "포토부스 대여" \
  --price 500000 \
  --unit "일"

# 품목 목록
node scripts/manage-items.js list

# 품목 수정
node scripts/manage-items.js edit "포토부스 대여" --price 600000

# 품목 삭제
node scripts/manage-items.js remove "포토부스 대여"

품목 데이터: data/items.json

저장된 품목 사용:

node scripts/generate.js quote \
  --client "무펭이즘" \
  --item-ids "포토부스 대여,출장비"

템플릿

한국형 견적서 (templates/quote.html)

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

세금계산서 (templates/tax-invoice.html)

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

프리랜서 인보이스 (Markdown)

• Professional layout
• Sender/receiver info
• Itemized table with subtotals
• Tax calculation
• Payment terms and bank details
• Auto-incremented invoice number (INV-YYYY-NNN)

커스텀 템플릿 생성:

cp templates/quote.html templates/my-custom.html
# 수정 후
node scripts/generate.js quote --template my-custom ...

출력 형식

• HTML: 브라우저에서 바로 확인
• PDF: HTML → PDF 변환 (OpenClaw 브라우저 필요)
• Markdown: 프리랜서 인보이스 (편집 가능)

저장 경로: output/YYYY-MM-DD-{type}-{client}.{html|pdf|md}

내 정보 설정

data/my-info.json:

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

프리랜서 정보 (영문):

{
  "name": "John Doe",
  "email": "john@freelancer.com",
  "address": "123 Main St, New York, NY 10001",
  "phone": "+1-555-1234",
  "bankAccount": "Bank of America, Account #12345678"
}

사용 예시

1. 한국 고객에게 견적서

# 거래처 미리 저장
node scripts/manage-clients.js add "무펭이즘" \
  --business-number "123-45-67890" \
  --ceo "김형님"

# 품목 미리 저장
node scripts/manage-items.js add "포토부스 대여" --price 500000 --unit "일"
node scripts/manage-items.js add "출장비" --price 100000 --unit "회"

# 견적서 생성
node scripts/generate.js quote \
  --client "무펭이즘" \
  --item-ids "포토부스 대여,출장비" \
  --notes "부가세 별도"

2. 세금계산서 발행

node scripts/generate.js tax \
  --client "무펭이즘" \
  --items "포토부스 대여,1,500000" \
  --type 영수 \
  --issue-date 2026-02-18

3. 해외 고객 인보이스

node scripts/generate.js invoice \
  --client "Acme Corp" \
  --items "Web development,40h,50" \
  --currency USD \
  --lang en \
  --notes "Payment due within 30 days"

통합 기능

• message 스킬: 이메일/Discord로 견적서 전송
• daily-report: 작업 시간 → 인보이스 자동 변환
• calendar: 유효기간/납기일 알림 설정
• trello/notion: 견적서 발행 → 태스크 자동 생성

설치

cd skills/unified-invoice
npm install

주의사항

• 사업자등록번호: 123-45-67890 형식 (하이픈 포함)
• 금액: 원 단위 숫자만 입력 (콤마 없이)
• PDF 생성: OpenClaw 브라우저 실행 필요 (포트 18800)
• 템플릿 수정: HTML 파일 직접 편집 가능
• 다국어: --lang en 옵션으로 영문 출력

트러블슈팅

PDF 생성 실패:

• OpenClaw 브라우저 실행 확인 (openclaw gateway status)
• 포트 18800 접근 가능 확인

거래처/품목 로드 안 됨:

• data/clients.json, data/items.json 파일 존재 확인
• JSON 문법 오류 확인

부가세 계산 오류:

• --include-vat false 옵션으로 부가세 제외 가능
• 수동 계산 필요 시 --items "품명,수량,공급가액" 입력

디렉토리 구조

unified-invoice/
├── SKILL.md                      # 이 파일
├── package.json
├── scripts/
│   ├── generate.js               # 견적서/세금계산서/인보이스 생성
│   ├── manage-clients.js         # 거래처 관리
│   └── manage-items.js           # 품목 관리
├── templates/
│   ├── quote.html                # 한국형 견적서
│   ├── tax-invoice.html          # 세금계산서
│   └── freelance-invoice.md      # 프리랜서 인보이스 (Markdown)
├── data/
│   ├── clients.json              # 거래처 DB
│   ├── items.json                # 품목 DB
│   └── my-info.json              # 내 사업자 정보
└── output/                       # 생성된 문서 저장

통합 히스토리

🐧 Built by 무펭이 — 무펭이즘(Mupengism) 생태계 스킬