automationsmanufaktur-labs/open-invoice-germany

** 무료, 독일에 대한 자체 호스팅 오픈 소스 통합 소프트웨어.** E-invoice (XRechnung / ZUGFeRD) · GoBD · § 14 UStG · 중소기업 § 19 · GDPR

 ·  라이센스: AGPL-3.0  ·  영어 · Deutsch

왜? 2025년 독일 B2B에서 receive 구조화된 e-invoice가 있어야 합니다. 2027/2028 sending에서 필수가 됩니다. 많은 프리랜서 및 SME는 월별 요금을 지불하여 준수해야합니다. 이 프로젝트는 ** 무료 및 오픈 ** - 당신은 자신을 호스팅, 귀하의 데이터는 당신과 함께 머물.

⚠️ ** 세금 또는 법적 조언이 없습니다. ** GoBD 준수는 사용자의 프로세스 문서 (Verfahrensdokumentation)를 추가로 요구합니다. ** COMPLIANCE.md ** (진리의 단일 소스)에서 라이브 소스와 모든 법적 참조. 보장 없음.

---

ܧ️ 클레드 코드 (MCP)로 이야기

로컬 인스턴스를 Claude Code 또는 Claude Desktop에 연결하고 법적으로 소리 청구서를 작성하십시오.

“Müller GmbH의 청구서를 € 95에서 컨설팅의 3 시간, 오늘 전달, XRechnung을 최종적으로 수출합니다.”

Claude는 주문에서 올바른 도구를 호출합니다 (고객 / 서비스 → 송장 → 최종 → PDF + XRechnung).

Why? From 2025 German B2B must be able to receive structured e-invoices; from 2027/2028 sending becomes mandatory. Many freelancers and SMEs pay a monthly fee just to stay compliant. This project makes it free and open — you host it yourself, your data stays with you.

⚠️ Not tax or legal advice. GoBD compliance additionally requires the user’s own process documentation (Verfahrensdokumentation). All legal references with sources live in COMPLIANCE.md (single source of truth). No warranty.

---

🗣️ Talk to it with Claude Code (MCP)

Connect your local instance to Claude Code or Claude Desktop and create legally sound invoices just by describing them:

“Create an invoice to Müller GmbH for 3 hours of consulting at €95, delivered today, finalise it and export the XRechnung.”

Claude calls the right tools in order (create customer/service → invoice → finalise → PDF + XRechnung). Finalising enforces the § 14 UStG mandatory fields — non-compliant invoices are rejected. The invoice is created and stored locally. Setup + examples: docs/MCP.md.

npm run mcp   # start the MCP server (stdio) / wire it into Claude Code via .mcp.json

🔒 Data protection (GDPR). The app core runs 100% locally, but the MCP feature is optional and not automatically GDPR-compliant: when you let a cloud LLM (e.g. Claude) create the invoice, the data you describe (customer name, items, amounts = personal data) is sent to that provider and processed on your behalf (Art. 28 GDPR). For business use with real personal data, either use a local model (the MCP server is model-agnostic) or a commercial API with a DPA — note that Claude Code/Desktop always use Anthropic’s cloud and the consumer Pro/Max subscription has no DPA. List the provider as a sub-processor in your records and privacy policy. Details: docs/MCP.md. Not legal advice.

Features

• Voice control via MCP (Claude Code/Desktop) — see above.
• GoBD core: finalisation (draft → immutable), gapless number ranges, append-only audit hash-chain, cancellation instead of deletion.
• § 14 UStG: mandatory-field check blocks finalisation when data is missing.