API - THINGS IO | Low-code data koppelen vanuit Groningen

Zie je als MKB’er door de bomen het bos niet meer met al die nieuwe ontwikkelingen?

Hans Blaauw — Tue, 22 Oct 2024 09:23:24 +0000

Introductie Zie jij het soms ook even niet meer zitten met al die nieuwe ontwikkelingen en leveranciers die je alles op ICT gebied proberen te verkopen? THINGS IO geeft duidelijkheid in een wereld vol vage oplossingen.

Wat is het probleem?

Je wilt als MKB’er graag meedoen met al die nieuwe technologie en iedereen zal je ook vragen waarom je bijvoorbeeld geen AI gebruikt. Maarrrrr, je hebt het druk en geen brede en specialistische kennis in huis van allerlei oplossingen. Maar toch wil je meedoen en je klanten ook het beste bieden terwijl je je kosten wilt verlagen.

Hoe kan THINGS IO helpen?

De kracht van THINGS IO is 25+ jaar ervaring met ICT technologie in diverse branches. Van industrie tot e-commerce en dienstverlening tot overheid. THINGS IO is niet bang voor nieuwe technologie en applicaties die ze niet kent.

We helpen MKB’ers graag met:

het uitzoeken en implementeren van nieuwe systemen
het integreren van bestaande systemen via API’s
het bouwen van interne applicaties op een private cloud omgeving
het gebruiken van geautomatiseerde workflows
het kwijtraken van de angst om het anders te doen

Een voorbeeld

Een MKB’er benaderde ons met de vraag of we eens konden kijken naar logistieke systemen en een integratie met de administratie. Het uitgangspunt was o.a. meer interen oplossen en minder afhankelijk worden van dure externe partijen.

Een eerste analyse

Om tot een aanpak te komen in deze situatie was er eerst een analyse nodig van de huidige situatie. Die was als volgt:

grote afhankelijkheid van externe partijen
geen resources voor interne ontwikkeling
geen architectuur voor koppelen van systemen via API’s
vastgelopen software projecten

De aanpak

De aanpak bestond uit een aantal stappen:

opzetten van een ontwikkelstraat voor interne applicaties
opzetten architectuur voor interne applicaties
analyse koppelingsmogelijkheden
lostrekken lopende projecten
leveranciers meer betrekken en onder druk zetten
afscheid nemen van wat niet werkt
van waterval naar scrum-achtige aanpak
specificaties voor nieuwe koppelingen schrijven

Onze rol

In deze situatie heeft THINGS IO een dubbele rol op zich genomen:

adviseur m.b.t. bestaande applicaties
meewerkende consultant koppelingen en workflow automatisering

Hoe begin je met innoveren?

Dat kan gewoon met een kop koffie, op maandagen is er altijd ruimte. O ja, ik kom graag op locatie.

Afspraak verzoek

The post Zie je als MKB’er door de bomen het bos niet meer met al die nieuwe ontwikkelingen? first appeared on THINGS IO | Low-code data koppelen vanuit Groningen.

Direct linken naar Visma onderdelen

Hans Blaauw — Mon, 02 Sep 2024 06:48:03 +0000

Introductie Visma maakt in haar navigatie gebruik van een versienummer in de URL. Dit is op zich prima maar het versienummer kan soms per dag wel wisselen en dan heeft het direct linken met die URL geen zin. Er is documentatie over dit onderwerp maar ik heb voor de zekerheid contact gezocht met de API manager van Visma.

Wat is de uitdaging?

Omdat THINGS IO voor klanten met de Visma API werkt en zelf ook kleine interne applicaties bouwt waarbij we direct willen linken naar bijvoorbeeld een verkooporder, is het noodzakelijk om een andere manier te gebruiken om direct te linken naar onderdelen van Visma. In dit geval een verkooporder.

Wat heb je nodig?

We hebben een aantal zaken nodig:

Visma login;
Een verkooporder nummer;
De Tenant ID.

Eerst de company ID vinden

Om de company ID te kunnen zien moet je administrator toegang hebben voor de Admin module. Dit was helaas even zoekwerk maar dit nummer staat in de Admin instellingen.

De URL maken

Als je een URL wilt samenstellen die bijvoorbeeld direct linkt naar een Verkooporder dan moet je rekening houden met het volgende:

de URL is niet wat je precies ziet in het scherm als je bent ingelogd;
het is niet altijd heel snel;
een deel vd URL moet je encoden;
je hebt de company ID nodig.

We kiezen uit het overzicht het Verkooporder nummer SO240641.

De basis URL

De URL die je in de interface ziet van Visma is niet de URL die je kunt gebruiken om direct te linken. Dit zal een paar dagen werken maar dan stopt het. Dit heeft te maken met het gebruik van een versienummer in de URL, wat mij betreft een zeer ongelukkige keuze.

Dit is bijvoorbeeld op dit moment de URL: https://finance.visma.net/1015011001/(W(2)) Visma gaf in eerste instantie aan om dan maar te proberen dit versienummer elke keer tevoorschijn te toveren maar dat is niet echt een optie. Deze moet je dan uit de Swagger file zien te vissen en gebruiken.

De juiste basis URL is: https://finance.visma.net/selector?OdpCompanyId=

Achter de OdpCompanyId heb je het nummer nodig wat ik eerder heb aangegeven, dat is dus nog even zoeken.

Het tweede deel van de URL (encoded)

Het tweede deel vd URL is het belangrijkste en je moet goed opletten dat je dit via enoding doet. Voor de Verkooporder heb je de volgende query parameters nodig:

ScreenID;
OrderType;
OrderNbr

Deze kun je ook vinden in de originele URL van Visma: ScreenId=SO301000&OrderType=SO&OrderNbr=SO240641

Echter, deze moet je wel voorzien van encoding. Dat kun je doen via bijvoorbeeld de site https://www.urlencoder.org/

Vervolgens krijg je de volgende URL: https://finance.visma.net/selector?OdpCompanyId=&UrlParams=%3FScreenId%3DSO301000%26OrderType%3DSO%26OrderNbr%3DSO240641

Conclusie

Het is goed te doen maar het is even zoekwerk. Zoals vaker bij Visma kost het soms veel tijd zaken uit te zoeken. Er is documentatie en er is een forum maar het kost allemaal tijd want er zit niet altijd veel snelheid in. Uiteindelijk lukt het allemaal wel als je de juiste contacten hebt.

Visma is een groot bedrijf en ze moeten rekening houden met al hun klanten. Daarnaast is het te merken dat dit geen API first bedrijf is. De software is ooit ontwikkeld en op basis daarvan is een API gemaakt. Dit in tegenstelling tot een andere klant van ons, whitesky.cloud.

Lukt dit niet om te implementeren?

Neem contact op

The post Direct linken naar Visma onderdelen first appeared on THINGS IO | Low-code data koppelen vanuit Groningen.

Dagelijks automatisch voorraad in Visma corrigeren

Hans Blaauw — Mon, 10 Jun 2024 13:29:13 +0000

Introductie Voorraad correcties, hebben we daar niet allemaal mee te maken en hoe doe dit je dit automatisch op basis van andere data in Visma.

Wat is de uitdaging?

Soms heb je gewoon voorraad correcties binnen je bedrijf. Dat kan zijn omdat een product bedorven is of dat het kapot is gegaan. Afhankelijk van je boekhoudkundige processen moet je dat dan corrigeren. In dit geval kiezen we voor de methode het direct te corrigeren via de Visma.net API.

Wat heb je nodig?

We hebben een aantal zaken nodig:

Lowcode server;
N8N;
Visma.net API toegang;
Eventueel MYSQL.

Met deze componenten kun je het proces automatiseren.

De Visma.net API

Als je dit leest dan heb je vast al wel eens met de Visma API gewerkt. Zo niet dan kun je hier de API reference vinden.

Voor deze oplossing werken wij met de methode inventoryadjustment. Met deze methode doe je binnen Visma direct correcties.

Correcties kunnen zowel positief als negatief zijn.

Wat is onze aanpak normaal gesproken?

Over het algemeen kiezen we er altijd voor een tijdelijke database als MYSQL op een lowcode server te gebruiken. Dit is een soort intermediair tussen de verschillende systemen en je kunt daar ook eenvoudig met bijvoorbeeld Budibase een interface overheen leggen. Met N8N regelen we dan vervolgens de hele integratie. Hoe zit dat er in stappen uit?

we halen de mutaties op uit bijvoorbeeld een voorraadsysteem via een API en N8N;
we slaan de informatie op in MYSQL database;
halen de informatie uit MYSQL en formatteren deze;
we bieden via de Visma API de informatie aan.

Via de gekozen Visma methode moet je eigenlijk twee API methoden doorlopen:

POST naar inventoryadjustment;
POST naar inventoryadjustment met de opties <adjustment id>/action/release

De adjustment id moet je uitlezen uit de response van de eerste aanroep. Niet zo heel fijn maar het is goed te doen.

De JSON data

De V isma API werkt met het aanbieden van JSON data en ondersteunt ook batchverwerking van meerdere records. Let er wel op dat je mt een batchverwerking wat meer moet doen om te zien of elke record goed is gegaan. Helaas geeft Visma geen overzicht terug van de juist afgehandelde records. Een niet bestaand product kan bijvoorbeeld de hele batch afkeuren. Alles in separate API calls aanroepen is ook geen optie, het kan soms om heel veel producten gaan. Hieronder zie je een voorbeeld.

{"adjustmentLines":[{"operation":"Insert","description":{"value":"Houdbaarheidsdatum verstreken"},"warehouseId":{"value":"gro"},"branchNumber":{"value":"11"},"lineNumber":{"value":0},"uom":{"value":"STUK"},"inventoryNumber":{"value":"9999"},"quantity":{"value":1}},{"operation":"Insert","description":{"value":"Houdbaarheidsdatum verstreken"},"warehouseId":{"value":"gro"},"branchNumber":{"value":"11"},"lineNumber":{"value":0},"uom":{"value":"STUK"},"inventoryNumber":{"value":"55555"},"quantity":{"value":1}}],"branchNumber":{"value":"11"},"description":{"value":"Producten zijn niet meer goed"}}

Deze eerste aanroep zorgt ervoor dat er een correctie wordt aangemaakt die In balans als status heeft.

Na het aanroepen van de eerste methode moeten we de correctie “releasen”. Dat doen we met de methode zoals eerder beschreven.

Een voorbeeld N8N workflow voor voorraad correcties

De volgende flow is een voorbeeld van een nocode oplossing die informatie uit een API haalt, deze opslaat in MYSQL, transformeert en doorstuurt naar Visma via de API. Dit alles in 1-3 seconden.

Deze workflow heeft een scheduler die dit elke dag 1 keer doet. Als een API aanvraag mislukt dan ondernemen we nog 3 pogingen.

De adjustment id halen we uit het resultaat van de vorige API call, daarmee release we de voorraad correctie.

Het belangrijkste wat je moet doen is het configureren van de URL en de API key. De API key kun je zien in DocHorizon. Daarnaast kun je de URL ook in DocHorizon vinden.

Het tweede deel waar je voor moet zorgen is dat het POST formaat correct gestructureerde JSON is. Dat zie je in het volgende screenshot.

Als we nu de N8N workflow draaien dan krijgen we het volgende resultaat.

Moet je ook veel documenten verwerken en zit je te denken aan een maatwerk oplossing? Kijk eerst eens naar lowcode workflows voordat je dure maatwerk oplossingen gaat bouwen. Vaak kunnen we in een paar dagen al een mooi resultaat behalen.

Interesse in lowcode oplossingen?

Lowcode server

The post Dagelijks automatisch voorraad in Visma corrigeren first appeared on THINGS IO | Low-code data koppelen vanuit Groningen.