Hur lätt det är att byta e-handelsplattform, koppla på ett nytt CRM eller sluta föra över order för hand avgörs sällan av systemen var för sig. Det avgörs av hur de utbyter data med varandra. API-first betyder att man planerar de kopplingarna först och väljer system som har bra, dokumenterade API:er. Det kräver lite mer planering i början, men gör er mindre beroende av enskilda leverantörer och billigare att förändra senare.
Vad ett API är, kort
Ett API är ett avtalat sätt för två system att prata med varandra. När en kund lägger en order i webbutiken kan ordern via API:er skickas till ekonomisystemet för bokföring, lagersaldot uppdateras i lagersystemet och kunden läggas in i CRM-systemet, alltså kundregistret där säljare och kundtjänst ser historiken. Utan API:er sker samma sak med exporter, kalkylark och manuell inmatning.
Vad API-first betyder för dig som beslutsfattare
För en utvecklare är API-first en arbetsmetod. För en verksamhet handlar det om tre beslut:
- Varje typ av data har ett hem. Ni bestämmer vilket system som är facit för kunder, artiklar, priser och lager. Andra system hämtar därifrån i stället för att ha egna kopior som glider isär.
- Kopplingar är utbytbara delar. Integrationen mellan webbutik och ekonomisystem byggs så att den går att byta ut utan att resten påverkas.
- Nya kanaler kopplas till samma källa. En app, en portal för återförsäljare eller en marknadsplats hämtar data från samma ställe som webbplatsen, i stället för att bli ännu en ö.
Där det märks i vardagen
Bristande integrationer syns sällan i en offert men ofta i vardagen:
- Ekonomi. Order och betalningar förs in för hand i ekonomisystemet, till exempel Fortnox eller Visma, och avstämningen vid månadsskiftet drar ut på tiden.
- E-handel och lager. Lagersaldot uppdateras med fördröjning, och varor som är slut säljs ändå.
- CRM. Säljarna ser inte vad kunden har köpt på webben, och kundtjänst saknar orderhistorik.
- Rapporter. Siffrorna skiljer sig mellan systemen, och ingen vet vilken som stämmer.
Varje sådan brist kostar arbetstid varje vecka, och felen blir fler ju mer verksamheten växer.
Kostnad nu jämfört med senare
Den billigaste lösningen på kort sikt är oftast en direktkoppling mellan två system, gärna ett färdigt tillägg. Det är ofta helt rätt. Problemet uppstår när antalet system växer. Med fem system som alla kopplas direkt till varandra kan det bli upp till tio separata kopplingar, var och en med sin egen logik. Byter ni sedan ut ett av systemen påverkas alla kopplingar till det.
Med ett API-first-tänk kopplas systemen i stället mot ett fåtal tydliga gränssnitt. Att byta ekonomisystem blir då ett avgränsat projekt i stället för en omstart. Merkostnaden i början ligger främst i planering: att kartlägga flödena, bestämma var data ska bo och dokumentera kopplingarna. En webbutik med integrationer tar hos oss normalt 4–8 veckor, och en stor del av den tiden går till just det arbetet och till att testa flödena ordentligt.
Inlåsning: vad du ska se upp med
Inlåsning betyder att det blir så dyrt eller krångligt att lämna en leverantör att ni stannar trots att ni inte vill. Varningstecken:
- Era data går inte att få ut i sin helhet, eller bara som PDF-filer.
- API-åtkomst finns bara i den dyraste prisnivån eller kostar extra.
- API:et är odokumenterat eller begränsat till ett fåtal funktioner.
- Integrationen har byggts av en leverantör som behåller koden.
- Avtalet saknar regler för hur ni får ut era data när det upphör.
Inlåsning går sällan att undvika helt. Målet är att den ska vara ett medvetet val med känd kostnad, inte en överraskning.
Det här ska du kräva av leverantörer
- Dokumenterat API. Be att få se dokumentationen innan ni skriver avtal. Är den publik och uppdaterad är det ett gott tecken.
- Full dataexport i öppet format, till exempel CSV eller JSON, vanliga filformat som andra system kan läsa.
- Ägande av integrationskoden som byggs åt er, och tillgång till den.
- Varsel om ändringar. Leverantören ska meddela i god tid innan API:et ändras, så att era kopplingar inte slutar fungera över en natt.
- Övervakning och larm. Integrationer går ofta sönder utan att någon märker det. Någon ska få veta när en order inte kommer fram, och det ska vara bestämt vem.
- Behörigheter per koppling. Varje integration ska ha sin egen åtkomst som kan stängas av utan att något annat påverkas.
- Testmiljö, så att ändringar kan provas utan att röra riktiga order och fakturor.
När det räcker med färdiga kopplingar
Alla behöver inte en genomtänkt integrationsarkitektur. Har ni en webbutik och ett ekonomisystem, och det finns en väl underhållen färdig koppling mellan dem, är det ofta det bästa valet. Välj en färdig koppling om flödet är standard och volymerna måttliga. Välj en egen integration om ni har flera system som ska dela data, egna affärsregler som färdiga tillägg inte klarar, eller planer på nya försäljningskanaler.
Vår rekommendation
Innan ni väljer nästa system: rita upp vilka data som ska flöda vart och vilket system som ska vara facit. Ställ sedan kraven ovan till varje leverantör. Det tar några timmar och kan spara stora ombyggnader senare. Vi bygger API:er och integrationer mellan e-handel, ekonomisystem och verksamhetssystem, och beskriver hur under API-utveckling och integrationer. Vill ni ha hjälp att kartlägga era flöden kan ni höra av er till oss.