När man bygger automation åt svenska företag är affärssystemet nästan alltid med i bilden. Antingen för att läsa data eller för att skriva tillbaka. Det här är ett resonemang om hur de fem vanligaste systemen ter sig, sett från en utvecklares perspektiv och byggt på dokumentation snarare än på egna genomförda leveranser.
Fortnox
Fortnox har på pappret det modernaste API:t av de fem: RESTful, OAuth2, och dokumentation som är förhållandevis lättillgänglig jämfört med de äldre systemen i listan. Vår egen integration mot Fortnox är planerad och pågående, inte klar, så det här är ett resonemang utifrån dokumentationen snarare än en rapport om egen drift.
Den som redan kan REST och OAuth2 bör kunna komma igång relativt snabbt. Ett förnuftigt angreppssätt, oavsett vilket affärssystem det gäller, är att börja med läsande integration och först när den fungerar lägga på skrivande. Det minskar risken om ett skrivande anrop skulle bete sig oväntat.
Visma eEkonomi och Visma Spcs
Två olika produktlinjer, två olika API:er. eEkonomi har ett modernt REST-API som liknar Fortnox men med dokumentation som är något mer fragmenterad. Spcs-familjen är äldre och vissa integrationer kräver en agent installerad lokalt på kundens server.
Ett råd värt att ta med sig: fråga alltid vilken Visma-produkt det handlar om innan man planerar integrationen. Skillnaden i komplexitet mellan de två är stor.
Pyramid Business Studio
Här blir det knöligt. Pyramid har en lång historia och deras API speglar det. Mycket går via SQL-vyer mot databasen direkt, vilket fungerar men kan kräva att kunden öppnar nätverkstillgång på ett sätt som en försiktig IT-avdelning tvekar inför.
När det väl är uppe brukar det vara stabilt. Vägen dit tar rimligtvis längre tid än för de andra systemen i listan här, och det är värt att planera för.
Monitor ERP
Monitor kan bli smärtsammare än förväntat. API:et är rimligt men kräver en del förkunskaper om hur Monitor är arkitekterat. Auktorisering är specifikt och dokumentationen pekar ofta på Monitors egna utvecklarforum snarare än på rena referensmanualer.
Ett rimligt råd är att ta in en Monitor-konsult parallellt för den första integrationen. Det sparar sannolikt tid.
Hogia
Hogia är en familj produkter med varierande modernitet. Hogia Lön Plus beskrivs ofta ha ett bra API. Vissa branschanpassningar har inget alls och kräver export-import via Excel. Be alltid om att få se API-dokumentationen innan man lovar en kund att Hogia-data ska in i en automation.
Den gemensamma fällan
En genomgående utmaning med svenska affärssystem är sällan tekniken i sig. Det är behörighet. För att en agent ska kunna läsa eller skriva i ett affärssystem behövs en användare med rätt rättigheter, ofta licensierad. Den användaren ska skapas, dokumenteras, tas med i revisioner och bytas om någon slutar.
En rimlig tumregel, som egen uppskattning snarare än en mätning: räkna med att en påtaglig del av tiden för en första integration går åt till behörighetsfrågor snarare än till kod. Det är lätt att underskatta i förväg.
När det är värt det
Trots allt detta är affärssystemsintegrationer nästan alltid värda jobbet. När det är på plats kan en agent skapa fakturor, läsa kundregister, plocka leveransstatusar och skapa prognoser baserat på riktiga siffror. Värdet uppstår där, inte i en isolerad chattbot. Räkna bara med vägen dit.