Troubleshooting & Reference · Article 7.9
„Paragon lub e-mail z fakturą końcową pokazuje kwotę, która się nie zgadza"
Po aneksie faktura końcowa i paragon powinny odzwierciedlać zmienioną sumę — nie oryginalną. Błąd naprawiony w maju 2026 (PR #173 / #179) sprawiał, że e-maile używały oryginalnej sumy. Po naprawie wszystkie dokumenty używają `effective_total`.
Matematyka aneksów i faktury końcowej splątuje się z powodu prawnej subtelności: faktura zaliczkowa (Anzahlungsrechnung) jest niezmienna po wystawieniu — zgodnie z niemieckimi zasadami GoBD i terminowaniem VAT UE nie możesz retroaktywnie zmieniać faktury zaliczkowej. Dlatego gdy aneks zmienia sumę, tylko faktura końcowa i paragon odzwierciedlają nową kwotę. Przed naprawą e-mail z fakturą końcową błędnie używał też oryginalnej sumy; po naprawie używa effective_total.
Step by step
Potwierdź problem.
Porównaj kwotę w e-mailu z aktualnym
effective_totaloferty (widocznym w nagłówku strony szczegółów oferty).Jeśli oferta sprzed naprawy
: e-mail został wysłany z błędną kwotą. Nie próbuj retroaktywnie naprawiać e-maila — to jest wysłany artefakt. PDF w Dokumentach (wygenerowany ponownie po naprawie) powinien być poprawny; udostępnij go klientowi jeśli potrzeba.
Jeśli oferta po naprawie
: e-mail powinien być poprawny. Jeśli tak nie jest, to regresja — skontaktuj się z obsługą techniczną.
Why this works this way
Model danych po naprawie:
- proposal.total: oryginalna suma w momencie podpisania. Niezmieniana thereafter.
- proposal.effective_total: obliczona z oryginalnej sumy + suma wszystkich podpisanych delt aneksów. Przeliczana przy każdym podpisaniu aneksu.
- Faktura zaliczkowa (DEP): zawsze pokazuje original_deposit_amount. Nigdy nie zmieniana.
- Faktura końcowa (INV): pokazuje effective_total - deposit_amount. Aktualizowana przy aneksie.
- Paragony: podzielone według etapu VAT; paragon zaliczkowy pozostaje przywiązany do depozytu, paragon końcowy używa effective_total.
Treść e-mail po naprawie używa effective_total konsekwentnie — e-mail z fakturą końcową, e-mail potwierdzenia płatności i e-mail zakończenia zwrotu odczytują wartości z aktualnej zmienionej sumy.
Troubleshooting
Keep reading
Proposals & Invoices
The 4 delta branches: Δ+, Δ−, Δ=0, Δ_REFUND
Every signed amendment falls into one of four branches based on (a) the sign of the cost change and (b) whether the proposal was already paid. Each branch fires a different document chain. This is the central conceptual map for the entire amendment system.
Proposals & Invoices
The Clozo invoice family: DEP, INV, STR, DCR, CRN, REC
Six document types make up the full Clozo invoicing chain. Each has a distinct legal role under EU VAT Directive Art. 220 and §14 UStG. This article maps which document fires when and what it references.
Refunds & Notifications
Email: "Final invoice — please pay {{amount}}"
Sent when you click `Issue final invoice` after work is complete. Carries the final invoice (Schlussrechnung) PDF and the payment CTA.