unified-invoice
by @mupengi-bot
통합 견적서/세금계산서 생성기. 한국형 견적서(사업자등록번호, 부가세) + 프리랜서 인보이스(다국어, VAT). 거래처/품목 DB, PDF 출력, 자동 계산.
clawhub install unified-invoice📖 About This Skill
name: unified-invoice description: 통합 견적서/세금계산서 생성기. 한국형 견적서(사업자등록번호, 부가세) + 프리랜서 인보이스(다국어, VAT). 거래처/품목 DB, PDF 출력, 자동 계산. version: 1.0.0 author: 무펭이 🐧
Unified Invoice Generator 📄🐧
> 통합됨: 기존 invoice-gen, korean-invoice 스킬을 통합
한국형 견적서/세금계산서 + 프리랜서 인보이스를 하나로.
주요 기능
빠른 시작
한국형 견적서 생성
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
문서 타입
| 타입 | 설명 | 용도 |
|------|------|------|
| quote | 한국형 견적서 | 고객에게 견적 제시 |
| tax | 세금계산서 | 부가세 신고용 정식 세금계산서 |
| invoice | 프리랜서 인보이스 | 국제 거래, 프리랜서 작업 |
견적서 필드
| 필드 | 설명 | 필수 | 기본값 |
|------|------|------|--------|
| --client | 거래처명 또는 ID | ✅ | - |
| --items | 품목 리스트 (품명,수량,단가) | ✅ | - |
| --issue-date | 작성일자 | ❌ | 오늘 |
| --valid-until | 유효기간 | ❌ | +30일 |
| --notes | 비고 | ❌ | - |
| --include-vat | 부가세 포함 여부 | ❌ | true |
| --currency | 통화 (KRW/USD/EUR) | ❌ | KRW |
| --lang | 언어 (ko/en) | ❌ | ko |
세금계산서 필드
| 필드 | 설명 | 필수 | 기본값 |
|------|------|------|--------|
| --client | 공급받는자 (거래처 ID) | ✅ | - |
| --items | 품목 리스트 | ✅ | - |
| --issue-date | 작성일자 | ✅ | - |
| --type | 영수/청구 | ❌ | 영수 |
| --notes | 비고 | ❌ | - |
자동 계산
한국형 (부가세 10%)
공급가액: 500,000 원
부가세(10%): 50,000 원
합계: 550,000 원
프리랜서 (VAT + Withholding)
Subtotal: $2,000
VAT (10%): $200
Withholding: -$66 (3.3% for Korean freelance)
Total: $2,134
거래처 관리
# 거래처 추가
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)
커스텀 템플릿 생성:
cp templates/quote.html templates/my-custom.html
수정 후
node scripts/generate.js quote --template my-custom ...
출력 형식
저장 경로: 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"
통합 기능
설치
cd skills/unified-invoice
npm install
주의사항
123-45-67890 형식 (하이픈 포함)--lang en 옵션으로 영문 출력트러블슈팅
PDF 생성 실패:
openclaw gateway status)거래처/품목 로드 안 됨:
data/clients.json, data/items.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/ # 생성된 문서 저장
통합 히스토리
| 원본 스킬 | 기여 내용 | 통합 날짜 | |----------|----------|----------| | korean-invoice | 한국형 견적서/세금계산서, 사업자등록번호, HTML 템플릿 | 2026-02-18 | | invoice-gen | 프리랜서 인보이스, Markdown 템플릿, 다국어 지원 | 2026-02-18 |
> 🐧 Built by 무펭이 — 무펭이즘(Mupengism) 생태계 스킬