Proposals & Invoices · Article 5.6
Meerdere addenda achter elkaar: één ontwerp tegelijk, basislijn = huidige effectieve staat
Een offerte kan in de loop van zijn leven vele addenda hebben — maar slechts één openstaand op enig moment, en elk nieuw addendum is gebaseerd op de meest recente ondertekende staat, niet op de oorspronkelijke offerte. Zo houdt de keten samen.
De meeste offertes krijgen nul of één addendum. Een aantal krijgt er meer — ontwerpopdrachten waarbij de briefing evolueert, ontwikkelingsprojecten waarbij de specificatie verschuift, retainers waarbij elke maand een nieuw addendum is. Clozo verwerkt ketens van elke lengte door elk nieuw addendum te behandelen als een delta ten opzichte van de meest recente ondertekende staat — niet ten opzichte van de onveranderlijke oorsprong. Dit houdt de berekening intuïtief: als u na een eerder ondertekend addendum een wijziging doorvoert, werkt u vanuit het huidige contract, niet vanuit een punt in het verleden.
Step by step
Bekijk de offerte-detailpagina.
Onder de Documenten-dropdown staat een sectie Addenda met elk addendum op de offerte in chronologische volgorde, met status (ondertekend / afgewezen / geannuleerd / verlopen), volgnummer, ondertekeningsdatum en een directe koppeling naar de addendum-PDF.
Open de wizard voor een nieuw addendum.
Vanuit het Acties-paneel op
/proposals/{id}, klik opScopewijziging voorstellen. De wizard controleerthas_signed_amendmenten laadt de laatste ondertekende scope als basislijn.Bewerken, verzenden en ondertekenen zoals gebruikelijk.
De stroom is identiek aan een eerste addendum vanuit het perspectief van de freelancer. De klant ziet een verschil ten opzichte van de laatste ondertekende staat, niet ten opzichte van de oorspronkelijke offerte.
Na ondertekening wordt de keten verlengd.
De herziene scope van het nieuw ondertekende addendum wordt de basislijn voor eventuele toekomstige addenda. De Documenten-dropdown krijgt een nieuwe addendum-PDF (AMD-NNNN-vN), een nieuwe actieve Eindafrekening (met verhoogde revisie) en een nieuwe Stornorechnung voor de vorige actieve factuur.
Een overzichtelijke sectie Addenda op de offerte-detailpagina met de keten. Elke rij is onafhankelijk: eigen status, eigen documenten, eigen audittraject. De "huidige effectieve scope" is altijd de herziene staat van het laatste ondertekende addendum; de regelitems van de oorspronkelijke offerte zijn bewaard in proposal.line_items (onveranderlijk per [D-086]) maar alleen de herziene staat bepaalt facturen en totalen voortaan.
Why this works this way
Drie regels beheersen de keten:
1. Één openstaand tegelijk. Een DB-beperking (uniq_open_amendment_per_proposal met conditie status IN (sent, viewed)) dwingt dit af op de datalaag. De wizard dwingt het af op de UI-laag door u door te sturen naar Ontwerp hervatten als er al een ontwerp bestaat. Als u een tweede addendum probeert op te stellen terwijl een ander wacht op de handtekening van de klant, retourneert de API 409 open_amendment_exists. Om een nieuw addendum te starten, moet het vorige een eindstatus bereiken: ondertekend, afgewezen, geannuleerd of verlopen.
2. Basislijn = huidige effectieve scope. Wanneer u de wizard opent voor een nieuw addendum op een offerte die al ondertekende addenda heeft, toont stap 1 de regelitems van het laatste ondertekende addendum als de vergrendelde kolom "Origineel" — niet de regelitems van de oorspronkelijke offerte. De API biedt dit via proposal.has_signed_amendment en proposal.revised_line_items; de frontend-wizard schakelt daarnaar over wanneer aanwezig.
3. Voorschot is verankerd aan het oorspronkelijke totaal. Zelfs na meerdere ondertekende addenda gebruikt de voorschotberekening het allereerste totaal (parent.total_amount), niet het laatste herziene totaal. Dit is opzettelijk per [D-086]: het voorschot werd betaald tegen een specifiek bedrag; het schaalt niet retroactief bij. De banner met de voorschotcontext in de wizard weerspiegelt dit — het voorschot € blijft constant gedurende de keten, ook als het herziene totaal verandert.
Troubleshooting
Keep reading
Proposals & Invoices
Creating an amendment (the 4-step wizard)
The amendment wizard at `/proposals/{id}/amend` walks you through line items, reason, preview, and email — in that order. Five minutes for a simple change, ten minutes for a complex one. The client doesn't see anything until you click Send on Step 4.
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
Why a signed amendment issues two new documents (Storno + new INV)
Every signed amendment that touches the financial side of the contract generates at minimum two new documents: a Stornorechnung (cancellation invoice) for the old final invoice, and a fresh active FinalInvoice with revised numbers. This is required by GoBD §147 AO and parallel EU rules — never an arbitrary Clozo choice.