核心用法
korean-invoice는 CLI 기반 한국형 견적서·세금계산서 생성 자동화 도구로, 다음 workflow를 지원한다:
1. 사전 설정: data/my-info.json에 자사 사업자 정보 저장
2. 거래처 관리: client add/edit/remove/view로 거래처 DB 구축 (data/clients.json)
3. 품목 관리: item add/edit/remove으로 재사용 품목 DB 구축 (data/items.json)
4. 문서 생성:
5. 출력: HTML 브라우저 미리보기 또는 Puppeteer 기반 PDF 변환 (output/)
- 견적서:
quote --client {ID} --items {품목,수량,단가} - 세금계산서:
tax --client {ID} --items {...} --type {영수|청구}
자동 계산 로직: 공급가액 → 부가세 10% 자동 산출; 총액 입력 시 역산(÷1.1). 품목별 소계 및 합계 자동 집계.
---
显著优点
- 법정 양식 준수: 승인번호, 사업자등록번호, 영수/청구 구분 등 국세청 전자세금계산서 핵심 필드 포함
- 재사용성: 거래처·품목 DB화로 반복 입력 최소화
- 다중 출력: HTML(즉시 확인) + PDF(보관/전송) 동시 지원
- 확장 연동:
message스킬(이메일/Discord),calendar(유효기간 알림) 등 연계 가능 - 역산 기능: 총액 기준 자동 역산으로 협상 시 유연한 가격 설정 가능
---
潜在缺点与局限性
- 법적 유효성 한계: 생성된 문서는 "양식 참고용"이며, 국세청 홈택스 연동 없이는 법적 효력 없음(실제 세금계산서 발행은 별도 필요)
- 브라우저 의존성: PDF 생성 시 OpenClaw/Puppeteer 실행 환경 필수 → 서버리스 환경 제약
- 데이터 무결성:
data/*.json로컬 파일 기반 저장으로 동시 접근 시 충돌 위험; 백업 메커니즘 부재 - 보안 민감정보: 사업자등록번호, 계좌정보 등이 평문 JSON 저장 → 접근 권한 관리 필요
- 국가 특화: 한국 VAT(10%) 고정; 해외 거래처·다른 세율 지원 불가
---
适合人群
- 프리랜서 및 1인 사업자: 견적서/거래명세서 신속 작성 필요
- 소규모 IT/디자인/촬영 스튜디오: 반복 거래처 고정, 품목 표준화
- 사업 초기 단계: 홈택스 복잡성 회피, 내부 견적 관리용
- 개발자/엔지니어: CLI 워크플로우 선호, 자동화 파이프라인 구축 의도
---
常规风险
| 위험 유형 | 설명 | 완화 방안 |
|-----------|------|-----------|
| **법적 리스크** | 국세청 미연동 문서를 "세금계산서"로 오인 사용 가능 | 명확한 "견적/참고용" 표기; 실제 발행은 홈택스 필수 |
| **데이터 손실** | 로컬 JSON 파일 손상/제 시 복구 불가 | 주기적 git 백업 또는 외부 스토리지 동기화 |
| **개인정보 유출** | `my-info.json`, `clients.json` 내 사업자정보 노출 | 파일 권한 600 설정, 민감정보 암호화 저장 권장 |
| **환경 의존성** | Puppeteer/Chrome 실행 불가 환경에서 PDF 생성 실패 | HTML 출력 후 외부 변환 크플로우 대체 |
| **버전 호환성** | 스킬 간 연동(`message`, `daily-report`) 버전 차이 | 통합 테스트 및 롤백 계획 수립 |