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

Video: Visma financiële analyse via OpenAI

Hans Blaauw — Tue, 04 Mar 2025 13:05:39 +0000

Introductie Een korte demo hoe je AI kunt gebruiken om een financieel scherm te analyseren.

The post Video: Visma financiële analyse via OpenAI first appeared on THINGS IO | Low-code data koppelen vanuit Groningen.

AI, het einde van webscraping op de oude manier?

Hans Blaauw — Mon, 21 Oct 2024 10:53:40 +0000

Introductie Het is mij al een tijdje duidelijk, ouderwets code schrijven om elke HTML element van een pagina te halen is nu al verleden tijd. De oorzaak? Jaja, natuurlijk weer die AI!

Wat is ook alweer web scraping?

Voor heel veel software engineers is het vrij normaal om data van websites af te halen en dat te gebruiken voor in- of extern gebruik. Los van de discussie of dit legaal of illegaal is . Soms zijn er gewoon nog geen API’s beschikbaar om dat te doen en dan is scraping de enige manier.

Met webscraping schrijf je code om elke element van een pagina te analyseren en vervolgens op te slaan of te verwerken. Dit was gedoe omdat je de structuur van de pagina moet kennen.

Heb je een dergelijke oplossing nodig en moeten we dit voor je opzetten?

Plan afspraak

Hoe kun je scrapen op de nieuwe manier?

De nieuwe manier is zoals iedereen wellicht weet AI. Jaja, weer die verdraaide AI. We zijn straks met z’n allen zwaar verslaafd en dan is het niet meer gratis. Dat is echter een andere discussie

Met AI hoef je je niet langer bezig te houden met de structuur, AI zoekt dit wel voor je uit en dat is precies wat we gaan doen.

Het scrapen van info van een Visma screenshot

Omdat THINGS IO recentelijk nogal wat doet met de de Visma ERP API, leek het logisch om de API eens over te slaan om te kijken hoe snel je zinvolle informatie uit een pagina van Visma kunt krijgen, in dit geval Voorraad correcties.

We hebben via de API’s eerst even automatisch wat voorraad correcties aangemaakt, die zie je hierboven. Je weet vast wel hoe je dit zelf uit Visma kunt halen.

De aanpak via AI

Dit keer is er gekozen voor een iets andere AI tool omdat ik een artikel las van Simon Willison die een video liet analyseren waaruit een JSON response kwam. Bekijk dit artikel hier. Hij heeft hiervoor Google Studio AI gebruikt en die hadden we nog niet geprobeerd.

Gebruik van Google AI studio

Om dit te kunnen gebruiken we het goedkoopste AI model van Google AI studio, Gemini Flash 1.5. Deze kost $0.075 per 1 miljoen tokens en de prijs gaat omlaag.

Het gebruik van Google AI studio is een beetje wennen maar het is uiteindelijk redelijke eenvoudig. We maken geen volledige web scraper maar laten zien hoe je bepaalde info uit een screenshot haalt. De code om in te loggen en het screenshot te maken moet je zelf bouwen. Hieronder zie je de interface van AI studio.

Nieuwe prompt maken

Als eerste moet je een nieuwe prompt maken, die zie je links in het menu.

Vervolgens klik je op het plusje om een bestand toe te voegen, je kunt ons plaatje downloaden met de Visma voorraad correcties.

Nu moet je een prompt ingeven, gebruik:

Given this image return the first five rows in JSON. Only return the date in format DD-MM-YYYY from the column “Datum” and the total amount from the column “Totaal aantal. Also add the totals of column “Totaal aantal” as a separate json key.

Vervolgens heb ik de JSON mode aangezet in het rechter scherm van AI studio.

Het resultaat

Na het ingeven van de prompt hebben we deze uitgevoerd. Het resultaat is als volgt:

{“rows”: [{“Datum”: “20-10-2024”, “Totaal aantal”: “-141.00”}, {“Datum”: “19-10-2024”, “Totaal aantal”: “-203.00”}, {“Datum”: “18-10-2024”, “Totaal aantal”: “1.000.00”}, {“Datum”: “18-10-2024”, “Totaal aantal”: “-8.799.00”}, {“Datum”: “16-10-2024”, “Totaal aantal”: “-1.734.00”}], “total”: “-11.077.00”}

Mooi resultaat voor 1-2 minuten werk. Nu hoor ik de nai-sayers al roepen achter in de zaal, dat kan ik ook met mijn tools. Precies, met alle tools die je eerst moet configureren!

Conclusie en waarschuwing

Dat we met z’n allen aan het infuus liggen van de grote techbedrijven is niet ideaal. De AI verslaving zet goed door en ergens aan het einde van de rit komt de rekening. Echter, vooralsnog dalen de token prijzen bij een aantal leveranciers en dat is gunstig.

Zelf denk ik wel dat net zoals bij alle andere SaaS diensten de kosten de pan uit gaan rijzen. Een ondernemer moet elke maand abonnementen betalen en je moet goed analyseren wat nuttig is.

De impact van alle energie vretende data centers is niet gunstig en daar moet nog een oplossing voor komen.

The post AI, het einde van webscraping op de oude manier? 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.

Visma API – inkoop ontvangsten verwerken via een lowcode oplossing

Hans Blaauw — Mon, 19 Feb 2024 09:44:02 +0000

Visma API en inkoop ontvangst In veel organisaties worden order ontvangsten verwerkt via Visma. Organisaties willen deze data ook graag koppelen aan hun interne systemen. Deze video laat kort zien hoe je met een lowcode oplossing met Visma kunt werken.

Kun je het niet zelf en heb je hulp nodig?

Neem contact op

The post Visma API – inkoop ontvangsten verwerken via een lowcode oplossing first appeared on THINGS IO | Low-code data koppelen vanuit Groningen.