Från signerad offert till faktura utan manuella steg

Anthony Kvarngård-Eriksson
VD & Grundare
Signaturen är startknappen. Så byggde vi kedjan där ett signerat avtal skapar kund, projekt och faktureringsunderlag i tre system, och varför idempotens är det viktigaste ordet i hela bygget.
Det finns ett ögonblick i varje konsultaffär där allt är bestämt men ingenting är gjort. Avtalet är signerat. Nu ska kunden läggas upp i ekonomisystemet, projektet skapas, budgeten föras in, teamet få sina ytor, och någon ska komma ihåg att göra allt det. Det tar en timme om det görs direkt, och en vecka om det inte görs.
Vi bestämde oss för att signaturen skulle vara startknappen. Inte en påminnelse, utan själva händelsen som gör allt det andra.
Kedjan i sju steg
När e-signeringen rapporterar att alla parter signerat går ett anrop till vårt API. Det anropet kör sju steg i ordning:
Signatur
Webhook från Scrive
Kund i CRM
Skapas eller hittas
Fortnox
Kund och projekt
Projektportal
Budget ur offerten
Avtal sparat
PDF på kunden
Anteckning
På kontakten
- Hämta det signerade dokumentet och spara PDF:en på kundens yta i SharePoint.
- Hitta eller skapa kunden i CRM:et. Organisationsnumret är nyckeln, inte namnet.
- Skapa kunden i ekonomisystemet om kundnumret saknas på företaget. Spara kundnumret tillbaka.
- Skapa projektet i ekonomisystemet med projektnummer ur offertens id.
- Skapa projektet i projektportalen med budget, timpris och aktiviteter från offerten.
- Flytta affären till vunnen och koppla förslag, projekt och avtal.
- Skriv en anteckning på kontakten med länk till allt ovan.
Hela kedjan tar några sekunder. Den körs utan att någon tittar.
Idempotens: det viktigaste ordet i bygget
Det som gör att vi vågar lita på kedjan är inte att den fungerar när allt går bra. Det är att den fungerar när något går fel. Om ekonomisystemet är nere i steg tre ska en omkörning en timme senare skapa det som saknas, och bara det.
Varje steg ställer därför samma fråga först: finns det här redan? Kunden söks på organisationsnummer. Projektet söks på projektnummer. Anteckningen söks på avtalets id. Finns det, hoppa över. Finns det inte, skapa. Det kallas idempotens, och det betyder att kedjan kan köras hur många gånger som helst med samma resultat.
Tips: Lägg en knapp i gränssnittet som kör kedjan om för ett valt avtal. Den knappen är er felsökning, er återställning och ert sätt att ta in avtal som signerades innan kedjan fanns.
Vad som krävs av varje system
| System | Vad kedjan behöver | Fallgrop |
|---|---|---|
| E-signering | Webhook vid signatur, API för att hämta PDF | Verifiera att anropet kommer från tjänsten, inte från vem som helst |
| CRM | Sök på orgnr, skapa företag, uppdatera externt id | Kundnumret måste sparas tillbaka, annars skapas kunden igen nästa gång |
| Ekonomisystem | Skapa kund, skapa projekt, OAuth | Tokens går ut, bygg förnyelsen först |
| Projektportal | Skapa projekt med budget och aktiviteter | Aktiviteterna ska komma ur offertens rader, inte en mall |
Offerten måste vara data, inte en PDF
Allt ovan förutsätter att offerten är strukturerad. Vår offert är en sida, inte ett dokument: kunden ser rader, kan justera omfattning inom ramar vi satt, och ser priset räknas om. När kunden signerar finns varje rad som data, och det är de raderna som blir aktiviteter och budget i projektet. Hade offerten varit en Word-fil hade kedjan stannat i steg fem, med en människa som läser och skriver av.
Vad det gav oss
Det mätbara är timmen per affär som försvann och de glömda projekten som slutade uppstå. Det som betyder mer är att projektet finns med rätt budget samma minut som avtalet signeras, så att den som ska leverera kan börja utan att vänta på administration. Och att kunden ser ett bolag som gör det det säljer.
Hela steget finns beskrivet, med skärmar, som del fem av vårt flaggskeppscase. Kopplingarna till Scrive och Fortnox har egna sidor.
Vanliga frågor
Vad händer om kunden signerar en ändrad offert?
Offerten låses när den skickas till signering. Vill kunden ändra skapas en ny version med nytt id, och det är den versionen som signeras och kör kedjan.
Måste vi ha Scrive och Fortnox?
Nej. Mönstret fungerar med vilken e-signering som har webhook och API, och vilket ekonomisystem som kan skapa kund och projekt via API. Vi valde Scrive för svensk e-legitimation och Fortnox för att vi redan använde det.
Hur vet ni att webhook-anropet är äkta?
Vi verifierar avsändaren med en hemlighet som bara e-signeringstjänsten och vårt API känner till, och hämtar sedan dokumentets status direkt från tjänsten i stället för att lita på anropets innehåll.
Skapad med AI
Om artikeln
Denna artikel är framtagen delvis med hjälp av AI (Anthropic Claude) och kan därför innehålla felaktigheter eller generaliseringar. Innehållet är granskat av en människa innan publicering, men vi rekommenderar att du verifierar viktig information innan du fattar beslut baserat på den.