Update Kleer Agreement
Uppdaterar ett befintligt löpande avtal i Kleer baserat på den enrollade dealens fält och fakturarader. Designad för "ändringsdeals" — när en kund uppgraderar, nedgraderar eller förnyar skapar du en ny deal som representerar förändringen, och denna action applicerar den på motsvarande avtal i Kleer.
Workflow-typ
Deal-baserad — Denna action är tillgänglig i deal-workflows.
Förutsättningar
- Dealen måste ha egenskapen Kleer Agreement ID (
kleer_agreement_id) satt till ID:t för det avtal som ska uppdateras - Dealens fakturarader representerar hela det nya raduppsättningen för avtalet (se varningen nedan)
Fält
Samma fält som Skapa löpande avtal. Alla fält är valfria — bara de fält du sätter skickas till Kleer.
| Fält | Typ | Beskrivning |
|---|---|---|
| Name | Text | Avtalets namn/beskrivning |
| Start Date | Text | Startdatum för avtalet i formatet YYYY-MM-DD |
| Start Invoice Date | Text | Datum för första fakturan i formatet YYYY-MM-DD |
| End Date | Text | Slutdatum för avtalet i formatet YYYY-MM-DD |
| Your Reference | Text | Kundens referens |
| Payment Days | Text | Antal dagar till betalning förfaller |
| Invoice Interval (Months) | Text | Faktureringsintervall i månader (t.ex. 1, 3, 12) |
| Currency | Text | Valutakod |
| Invoice Day | Text | När fakturor ska genereras |
| PO Number | Text | Beställningsnummer |
Beteende
- Actionen läser den enrollade dealen, dess associerade företag och dess fakturarader
- Den använder dealens
kleer_agreement_idför att identifiera vilket Kleer-avtal som ska uppdateras - Avtalet uppdateras i Kleer med de angivna fältvärdena och fakturaraderna
- Det uppdaterade avtalet synkas omedelbart tillbaka till HubSpot — den kopplade prenumerationen uppdateras utan att vänta på nästa schemalagda sync
Fakturarader skriver över, inte lägger till
Fakturaraderna på dealen ersätter avtalets fullständiga raduppsättning i Kleer. Rader som fanns på avtalet tidigare men som inte finns på den här dealen tas bort. Om du vill lägga till en rad och behålla befintliga rader måste du inkludera både gamla och nya rader på dealen.
Den kopplade kunden kan inte ändras
Kleers update-endpoint tillåter inte att kunden (client-ref) på ett befintligt avtal ändras — kunden är fast vid avtalets skapande. Att ändra det företag som är kopplat till dealen kommer inte flytta avtalet till en annan kund i Kleer. Om du behöver en annan kund, skapa ett nytt avtal istället.
Diff-faktura
Om inställningen "create diff invoice" är aktiverad i ditt Kleer-konto kan Kleer automatiskt skapa en differensfaktura när uppdateringen ändrar det fakturerade beloppet. Integrationen ignorerar det returnerade diff-faktura-ID:t — den hämtas vid nästa utgående fakturasync.
Tips
- Skapa en separat "ändringsdeal" (t.ex. i en "Subscription Change"-pipeline) och sätt dess
kleer_agreement_idtill avtalet som ska ändras - Använd en workflow som triggar denna action när ändringsdealen når closed-won
- Eftersom actionen riktar sig mot ett specifikt avtals-ID applicerar varje ändringsdeal en uppdatering på ett avtal