Skip to main content
Gratis starten

Proposals & Invoices · Article 5.3

Een addendum aanmaken (de wizard in 4 stappen)

De addendumwizard op `/proposals/{id}/amend` leidt u door regelitems, reden, voorbeeld en e-mail — in die volgorde. Vijf minuten voor een eenvoudige wijziging, tien minuten voor een complexe. De klant ziet niets totdat u op Verzenden klikt bij Stap 4.

Open in Clozo

De wizard opent met de huidige effectieve scope als startpunt — dat zijn de oorspronkelijke regelitems als er nog geen addendum is ondertekend, of de regelitems van het meest recent ondertekende addendum als u ketent (artikel 7.6). U bewerkt, vormt, voegt toe of verwijdert regelitems in Stap 1; legt de reden uit in Stap 2; beoordeelt het gegenereerde addendum in Stap 3; en stelt de e-mail op in Stap 4. Alles vóór de knop Verzenden van Stap 4 is privé voor u.

Quick visual tour

  1. creating-an-amendment step 1: Een clausule ontdekt die in een ondertekende offerte moet worden gewijzigd?

    Step 1: Een clausule ontdekt die in een ondertekende offerte moet worden gewijzigd?

  2. creating-an-amendment step 2: Klik op Aanpassen op de offerte — opent de addendumwizard.

    Step 2: Klik op Aanpassen op de offerte — opent de addendumwizard.

  3. creating-an-amendment step 3: Bewerk de gewijzigde regelitems. Drie gemarkeerde balken tonen de delta.

    Step 3: Bewerk de gewijzigde regelitems. Drie gemarkeerde balken tonen de delta.

  4. creating-an-amendment step 4: Stuur het addendum. De klant ontvangt een nieuw ondertekeningsverzoek via e-mail.

    Step 4: Stuur het addendum. De klant ontvangt een nieuw ondertekeningsverzoek via e-mail.

  5. creating-an-amendment step 5: Klant ondertekent het addendum — u bent beiden weer op dezelfde pagina.

    Step 5: Klant ondertekent het addendum — u bent beiden weer op dezelfde pagina.

Step by step

  1. Stap 1: regelitems.

    Originele items verschijnen in de bovenste helft, vergrendeld en gedimmd. Uw bewerkbare herziene lijst verschijnt eronder. Elke rij krijgt een gekleurde tag — groen + toegevoegd, amber ~ gewijzigd, rood − verwijderd, grijs ongewijzigd — zodat u (en de klant, in de diff-weergave) in één oogopslag kunt zien wat er is veranderd. De voorschotcontextbanner aan de rechterkant toont: voorschotpercentage uit het oorspronkelijke contract, geïnd voorschotbedrag, en wat het nieuwe amount_due zal zijn (of terugbetaling, als Δ_REFUND). De wizard herberekent na elke toetsaanslag.

  2. Stap 2: reden.

    Een kort tekstveld. Minimum 10 tekens voor Δ+ / Δ=0, 30 tekens bij het verkleinen van de scope (Δ− / Δ_REFUND) — het langere minimum moedigt u aan de redenering vast te leggen voor elke verlaging, aangezien dat het geval is dat het meest waarschijnlijk later wordt betwist. De reden verschijnt letterlijk op de addendum-PDF en op de diff-weergave van de klant.

  3. Stap 3: voorbeeld.

    De wizard rendert de addendum-PDF direct via een /preview-pdf-eindpunt en sluit hem in een iframe in. Lees hem door. Bevestig dat de regelitems, totalen, BTW-specificatie en reden er goed uitzien. Vink het toestemmingsvakje aan ("Ik heb de gegenereerde PDF beoordeeld en bevestig dat deze de wijziging nauwkeurig weerspiegelt") — Verzenden is uitgeschakeld totdat u dit doet. Elke bewerking stuurt u terug naar Stap 1 en maakt de toestemming ongeldig (u vinkt opnieuw aan).

  4. Stap 4: e-mailcomponist.

    Vooraf ingevuld onderwerp en tekst in de taal van de offerte; beide bewerkbaar. De ontvanger is standaard het e-mailadres van de klant in het systeem, maar kan worden overschreven (bijv. voor een alternatieve ondertekenaar). Klik op Addendum naar klant verzenden om de e-mail te sturen en het addendum te vergrendelen voor verdere bewerkingen.

De wizard neemt het volledige scherm in met een voortgangsbalk van vier stappen bovenaan. De voorschotcontextbanner blijft zichtbaar op Stap 1. Fouten (bijv. "Reden moet ≥ 30 tekens zijn" bij Δ−) verschijnen inline bovenaan de relevante stap. Na Verzenden wordt u doorgestuurd naar /proposals/{id} waar het addendum verschijnt in een paneel "Addendum in behandeling" met aftelling, kopieerlink-knop en een Annuleren-knop.

Why this works this way

De wizard maakt automatisch een concept ProposalAmendment-rij aan (of hervat er één) de eerste keer dat u verder gaat dan Stap 1. Vanaf dat moment PATCHt elke navigatie tussen stappen het concept op de server met de huidige regelitems en reden. Dit betekent dat het sluiten van uw browser midden in de wizard nooit werk verliest — open /proposals/{id}/amend opnieuw en u keert terug waar u was gebleven.

Een subtiel implementatiedetail: de wizard maakt een "voorbeeld" FinalInvoice-rij aan, gekoppeld aan het concept-addendum, met status=cancelled (niet actief). De status schakelt pas naar active op het moment dat de klant ondertekent, wanneer upsert_pending_invoice_for_amendment wordt process_amendment_signed. Twee consequenties: 1. Uw INV-2026-NNNN-teller gaat vooruit wanneer u een concept maakt (het nummer is gereserveerd). Als u het concept annuleert, blijft het nummer in uw boeken staan als een geannuleerde rij — dit is normaal en komt overeen met hoe Duitse Steuerberater genummerde annuleringen in het auditlog verwachten te zien. 2. Het voorbeeld-iframe van Stap 3 rendert op basis van deze voorbeeldfactuur — het is de exacte PDF die de klant zal ontvangen, dus wat u ziet is wat zij krijgen.

Als de bovenliggende offerte de status in_work heeft (voorschot betaald, project loopt), toont Stap 1 een extra rode callout-knop 'Alles terugbetalen' naast de regelitem-editor — door erop te klikken wordt de hoeveelheid van elk regelitem op 0 gezet, wordt revised_total op 0 gebracht, en bij ondertekening door de klant geeft de cascade in process_amendment_signed Storno + DepositInvoiceCorrection + CreditNote uit en start de Stripe-terugbetaling. Dit is het enige legitieme pad om een in_work-voorschot terug te betalen; directe DELETE op de offerte wordt geweigerd met HTTP 409 in_work_requires_amendment (per [D-125]).

Troubleshooting

Keep reading

Proposals & Invoices

When to use an amendment (vs a new proposal vs withdraw)

Three paths exist to change a deal: amend it, withdraw and resend, or start a new proposal. Pick the wrong one and you'll either break the audit trail or scare the client. Here's the decision tree.

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

Multi-amendment chains: one draft at a time, baseline = current effective

A proposal can have many amendments over its life — but only one open at any given moment, and each new amendment baselines on the most recent signed state, not the original proposal. Here's how the chain holds together.

Proposals & Invoices

What your client sees when an amendment lands

The client receives an email with a fresh PIN, lands on a PIN-gated page, sees a side-by-side diff of old vs new with totals and a reason, and signs (or declines) — exactly like the original proposal flow but with the diff baked in.