（4959期）Korean Invoice – 한국 표준 견적서·세금계산서 즉시 생성

한국 표준 견적서·세금계산서 즉시 생성 한국 표준 견적서/세금계산서 자동 생성 도구. 사업자등록번호 검증, 부가세 10% 자동 계산, 거래처/품목 DB 관리 및 PDF/HTML 출력 지원. 1인 사업자 및 소기업 대상. 使用说明 核心用法 korean-invoice는 CLI 기반 한국형 견적서·세금계산서 생성 자동화 도구로, 다음 workflow를 지원한다: 사전 설정: data/my-info.json에 자사 사업자 정보 저장 거래처 관리: client add/edit/remove/view로 거래처 DB 구축 (data/clients.json) 품목 관리: item add/edit/remove으로 재사용 품목 DB 구축 (data/items.json) 문서 생성: 출력: 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) 버전 차이 | 통합 테스트 및 롤백 계획 수립 | 原始说明 한국형 견적서/세금계산서 자동 생성 (사업자등록번호, 부가세 자동 계산)