Zuply en Vendo integratie voor slimme vending machines

Projectoverzicht

Voor dit project werkte FreshConnected aan de integratie van een nieuwe Vendo-vendingmachine met bestaande vendingsoftware en het bredere Zuply-platform. De machine moest niet alleen producten kunnen uitgeven, maar ook slimme functies ondersteunen zoals analytics, beheer op afstand en marketingtools rond de vendingervaring.

De kern van het werk lag in het verbinden van de vending-UI-software met de nieuwe Vendo-hardware, zodat machinegebeurtenissen, foutmeldingen en voorraadupdates correct doorstromen naar de softwarelaag en het achterliggende dashboard.

Samenwerking

Bij dit traject kwamen meerdere partijen samen: Quiosk als opdrachtgever, Zuply als hardwarepartij en Innovend aan de softwarekant. FreshConnected stemde af tussen developers en stakeholders en werkte aan de koppeling tussen de Vendo-controller, de Raspberry Pi en de bestaande softwareomgeving.

Dat maakte het project niet alleen technisch, maar ook organisatorisch relevant: de integratie moest passen binnen een bestaand product zonder de dagelijkse machinewerking of de samenwerking tussen leveranciers onnodig complex te maken.

De vraag achter het project

De praktische vraag was helder: hoe voeg je een nieuw type vendinghardware toe aan bestaande vendingsoftware, zonder het hele product opnieuw te moeten opbouwen? Voor machine-eigenaren betekende dit meer keuze in hardware. Voor eindgebruikers moest de ervaring gewoon blijven werken: snel, duidelijk en betrouwbaar.

De waarde zat dus niet alleen in het aansluiten van een machine, maar in het uitbreiden van het platform met een bredere hardwareselectie die bruikbaar blijft binnen dezelfde software- en beheerstructuur.

Wat er is opgeleverd

• Integratie van de Vendo-machine met de bestaande vending-UI-software.
• Koppelingen tussen machine-events, voorraad, foutcodes en het cloudplatform.
• Afstemming tussen hardwaregedrag, de gebruikersinterface en de backend.
• Coördinatie tussen betrokken partijen om de integratie praktisch uitvoerbaar te houden.

Technische implementatie

• Python-microservice op de Raspberry Pi om signalen van de machinecontroller door te geven aan de softwarelaag.
• PHP-backend voor transacties, foutmeldingen en synchronisatie met VendingWeb.
• Vue, JavaScript en TypeScript voor de vendinginterface waarmee klanten producten kiezen en machinefeedback terugzien.
• Cypress-tests voor belangrijke gebruikersflows en foutafhandeling.
• Buddy CI/CD en een gecontroleerde uitrol per machine.

Uitdagingen

• Schaarse documentatie rond de Vendo-koppeling, waardoor protocolgedrag bevestigd moest worden via tests en direct overleg.
• De nieuwe machine moest passen binnen bestaande hardware- en softwareflows zonder andere onderdelen te verstoren.
• Afstemming tussen meerdere partijen en leveranciers tijdens ontwikkeling en uitrol.

Resultaat

• Ondersteuning voor Vendo-machines binnen het bestaande platform.
• Realtime inzicht in uitgiftes, voorraad en foutmeldingen.
• Een soepelere integratie met de bestaande vendingsoftware.
• Eenvoudiger beheer en monitoring op afstand voor machine-eigenaren.
• Een productieklare basis voor verdere uitrol van dit type hardware.

Reflectie

Deze case laat zien dat hardware-integratie niet alleen om techniek draait, maar ook om afstemming tussen partijen, machinegedrag en bestaande softwareflows. Juist bij een bestaand platform is het belangrijk dat nieuwe hardware wordt toegevoegd zonder dat betrouwbaarheid of gebruiksgemak onder druk komen te staan.

De gekozen aanpak was sterk omdat die de koppeling niet als los experiment benaderde, maar als onderdeel van een groter productecosysteem. Daardoor werd de Vendo-machine niet alleen aangesloten, maar ook bruikbaar gemaakt binnen dezelfde beheer- en gebruikersstructuur.