Proposals & Invoices · Article 5.1
Rodzina dokumentów Clozo: DEP, INV, STR, DCR, CRN, REC
Sześć typów dokumentów tworzy pełny łańcuch fakturowania Clozo. Każdy ma odrębną rolę prawną na mocy Art. 220 Dyrektywy VAT UE i §14 UStG. Ten artykuł mapuje, który dokument jest generowany kiedy i do czego się odwołuje.
Jedna oferta Clozo może w ciągu swojego cyklu życia wystawić do sześciu różnych typów dokumentów, w zależności od tego, co się zdarzy (aneksy, zwroty, ręczne korekty zaliczki). Ten artykuł to mapa. Dla głębokiej mechaniki każdego z nich, patrz artykuły 6.2–6.4 i Sekcja 7 (aneksy) / Sekcja 8 (zwroty).
Na liście Dokumenty na każdej stronie szczegółowej oferty odpowiednie typy dokumentów pojawiają się w miarę ich generowania. Etykiety filtrów na liście: „Oferta", „Podpisana umowa", „Faktura zaliczkowa", „Faktura końcowa", „Powiadomienie o anulowaniu" (Storno), „Nota kredytowa", „Potwierdzenie". Każda to pobieralny link R2 (CORS-włączony, bez wymagania uwierzytelnienia dla adresu URL — link jest nie do odgadnięcia).
Why this works this way
Dlaczego tyle typów dokumentów? Prawo VAT UE (Dyrektywa 2006/112/WE, Tytuł XI Rozdział 3) traktuje różne zdarzenia jako różne punkty naliczenia: zaliczka to jedno zdarzenie podatkowe, świadczenie usług to kolejne, częściowe zmniejszenie zakresu to jeszcze inne. Każde zdarzenie wymaga własnej dokumentacji, bo każde przesuwa zobowiązanie VAT. Większość narzędzi dla freelancerów sprowadza to do „faktury" i ryzykuje naruszenie przepisów krajowych (szczególnie §14 UStG w Niemczech, Art. 220 Dyrektywy UE, BTW Art. 35a w Holandii, CGI Art. 271-II we Francji).
Pełna rodzina dokumentów (z apps/pdf/service.py i HELP_LIFECYCLE_MAP.md Sekcja 5):
| Typ | Prefiks | Renderer | Wyzwalacz | Cel |
|---|---|---|---|---|
| PDF oferty | PRO- | render_proposal_pdf | Wyślij ofertę | Propozycja (nie faktura) |
| Umowa o Świadczenie Usług | AGR- | (render podpisanego PDF) | Klient podpisuje | Umowa (nie faktura) |
| Faktura zaliczkowa | DEP- | render_deposit_invoice_pdf | Klient podpisuje (zaliczka > 0) | Anzahlungsrechnung — VAT naliczany od zaliczki |
| Faktura końcowa | INV- | render_final_invoice_pdf | Wystaw fakturę końcową | Schlussrechnung — zamyka projekt, odwołuje się do DEP |
| Faktura anulująca | STR- | render_storno_invoice_pdf | Aneks ze zmniejszeniem kosztu | Anuluje/unieważnia poprzednią fakturę; „Rechnungskorrektur" w DE |
| Korekta zaliczki | DCR- | render_deposit_correction_pdf | Aneks zmienia kwotę zaliczki | Dokumentuje korektę zaliczki |
| Nota kredytowa | CRN- | render_credit_note_pdf | Zainicjowany zwrot | Rejestruje zwrot + powód + rozbicie VAT |
| Potwierdzenie płatności | REC- | render_receipt_pdf | Płatność wpłynęła | Potwierdza wpłynięcie środków |
Łańcuch szczęśliwej ścieżki (brak aneksów, brak zwrotów):
``
Oferyta wysłana → PRO-2026-0042
Klient podpisuje → AGR-2026-0042 + DEP-2026-0042
Zaliczka opłacona → REC-2026-0042 (etap zaliczki)
Projekt ukończony → INV-2026-0042 (odwołuje się do DEP-2026-0042)
Ostatnia opłata → REC-2026-0042 (etap końcowy)
``
Łańcuch aneksu ze zmniejszeniem (Δ−):
``
… szczęśliwa ścieżka przez opłacenie zaliczki …
Aneks podpisany → STR-2026-NNNN (unieważnia starą INV)
+ INV-2026-NNNN (revision=2, zmniejszony zakres)
+ CRN-2026-NNNN (nota kredytowa dla zwrotu)
+ Zwrot Stripe LUB ręczny zwrot SEPA
+ REC-2026-NNNN (potwierdzenie zwrotu, gdy zwrot się rozliczy)
``
Numeracja dokumentów jest sekwencyjna per freelancer per rok per typ, atomowa (SELECT FOR UPDATE na DocumentCounter). Brak luk — raz przypisany numer jest permanentny. Rok resetuje się 1 stycznia: INV-2025-0099 następuje po nim INV-2026-0001. Patrz artykuł 6.9 dla dokładnej mechaniki.
Retencja: każdy dokument w rodzinie jest przechowywany na Cloudflare R2 z flagą legal_hold przez 10 lat, aby spełnić wymagania GoBD §147 AO (DE), Wet OB Art. 52 (NL), CGI Art. L102 B (FR) i analogicznych przepisów w całej UE.
Troubleshooting
Keep reading
Proposals & Invoices
The deposit invoice (DEP-) — Anzahlungsrechnung, facture d'acompte
The deposit invoice is the legal artefact that records VAT liability on an advance payment. Under EU VAT Directive Art. 65, the deposit becomes chargeable the moment the client pays — the deposit invoice is what the law requires you issue.
Proposals & Invoices
The final invoice (INV-) — Schlussrechnung, facture de solde
The final invoice closes the project. It states the full work value, then explicitly references the deposit invoice and **deducts both the deposit amount and the deposit VAT**, so you don't pay tax twice. This deduction is mandated by §14 UStG and parallel rules across the EU.
Proposals & Invoices
Receipts (REC-) — payment confirmation, single-stage vs split
A receipt confirms that a payment was actually received. Clozo issues one receipt per payment event: one for the deposit, one for the final balance, or a single receipt if the project was 100% prepaid.
Refunds & Notifications
EU invoice compliance — Art. 226 mandatory fields, sequence numbering, retention
Every invoice Clozo issues complies with EU VAT Directive Art. 226: 14 mandatory fields, sequential numbering with no gaps, immutability after issue, and 10-year retention.
Proposals & Invoices
Invoice numbering — sequential per year per type, atomic, no gaps
Every invoice gets a sequential number from an atomic counter scoped per freelancer per year per document type. No gaps allowed under EU VAT Directive Art. 226(2); enforced by a row-level database lock so concurrent operations cannot collide.