Wat is een Mascus-koppeling?
Mascus beschikt over een API waarmee productgegevens automatisch kunnen worden doorgestuurd. API klinkt technisch, maar het principe is eenvoudig: verschillende systemen wisselen informatie met elkaar uit. Leestip: onze blog over de werking van API's.
Je voegt een machine toe in het beheersysteem van je website. De koppeling zet de juiste gegevens vervolgens automatisch door naar Mascus. Denk bijvoorbeeld aan:
- merk en model;
- categorie;
- bouwjaar;
- prijs;
- draaiuren;
- locatie;
- technische eigenschappen;
- verkoper en contactgegevens;
- foto’s;
- video’s;
- documenten;
- verhuurinformatie.
Je moet machines niet langer dubbel invoeren
Zonder koppeling ziet het proces er vaak zo uit:
- Je hebt een machine ooit in je ERP gezet (waarschijnlijk).
- Je voegt een machine toe aan je eigen website.
- Je logt in op Mascus.
- Je vult dezelfde gegevens opnieuw in.
- Je uploadt dezelfde foto’s opnieuw.
- Bij iedere wijziging pas je beide systemen (of zelfs ook je ERP) afzonderlijk aan.
Dat lijkt voor één machine nog haalbaar. Maar wanneer je regelmatig machines toevoegt, aanpast of verwijdert, ... dan gaat het op na een tijdje wel serieus wat werk beginnen worden.
Met een Mascus-koppeling beheer je de productinformatie op één centrale plaats. Van daaruit synchroniseren we de relevante gegevens met Mascus.
Je hoeft dezelfde machine dus niet opnieuw op te bouwen.
Hoe bouwen we zo’n koppeling?
Een Mascus-koppeling is meer dan een knop waarmee je gegevens doorstuurt. De informatie uit je eigen beheer moet correct overeenkomen met de structuur van Mascus. Daarom bestaat zo’n integratie meestal uit verschillende onderdelen.
1 - Je website is (vaak) de basis
Mascus gebruikt per machinecategorie specifieke velden en eigenschappen. Mogelijk staan die vandaag nog niet allemaal in het beheer van je website.
We breiden het beheer daarom uit met de nodige specificaties. Zo kan je alle informatie die nodig is voor Mascus ook centraal invullen.
We voorzien uiteraard alleen de velden die voor jouw machines en werking relevant zijn. Je beheer hoeft niet ingewikkelder te worden dan nodig.
2 - Categorieën synchroniseren
Een machine moet binnen Mascus in de juiste productgroep terechtkomen. Een minigraver, wiellader of tractor heeft niet noodzakelijk dezelfde eigenschappen en invoervelden.
De API voorziet een methode waarmee categorieën en de bijbehorende eigenschappen kunnen worden opgehaald. Zo kunnen we de structuur van Mascus correct verwerken in jouw websitebeheer.
3 - Velden correct aan elkaar koppelen
Het ene systeem spreekt bijvoorbeeld over een “bouwjaar”, terwijl het andere systeem dat intern als “year of manufacture” verwerkt.
Wij brengen daarom in kaart welk veld uit jouw beheer overeenkomt met welk veld in Mascus. Dat noemen we het mappen van velden. Technische term, moet je niks mee doen. Maar zo kunnen we dus informatie zoals het merk, model, bouwjaar, de prijs, draaiuren en locatie correct doorsturen.
4 - Productgegevens synchroniseren
Zodra de categorieën en velden correct gekoppeld zijn, kunnen machines vanuit je websitebeheer naar Mascus worden gestuurd.
Een nieuw product wordt toegevoegd. Bestaande productinformatie kan worden bijgewerkt wanneer je bijvoorbeeld een prijs, omschrijving of technische eigenschap aanpast.
Iedere machine krijgt daarbij een unieke identificatie. Daardoor weet Mascus of een product nieuw is of dat een bestaande advertentie moet worden aangepast.
5 - Machines verwijderen of offline halen
Een koppeling moet niet alleen machines kunnen toevoegen. Wanneer een machine verkocht is, niet meer beschikbaar is of niet langer op Mascus mag verschijnen, moet je ze ook vanuit je beheer kunnen verwijderen of offline halen.
Daarom voorzien we meestal ook een verwijderfunctie. Via de Mascus-API kan een product volledig worden verwijderd. Daarnaast bestaat er een aparte instelling waarmee een product niet meer publiek wordt getoond, zonder dat alle productinformatie noodzakelijk volledig verwijderd wordt.
Dat onderscheid kan handig zijn:
- offline halen: de machine is tijdelijk niet zichtbaar;
- verwijderen: de advertentie wordt effectief uit Mascus verwijderd.
Waarom zie je een aanpassing niet altijd onmiddellijk?
Hoewel de koppeling gegevens meteen kan doorsturen, betekent dat niet dat iedere aanpassing onmiddellijk zichtbaar is op alle pagina’s van Mascus.
In de praktijk kan er verwerkingstijd zitten tussen:
- de actie in je websitebeheer;
- de verwerking binnen Mascus;
- de update van je Mascus-beheerpagina;
- de wijziging op de publieke verkooppagina.
Wanneer een machine verwijderd wordt, kan het dus enkele minuten duren voordat ze ook publiek verdwenen is. Ook de interne beheerpagina van Mascus wordt niet altijd onmiddellijk bijgewerkt.
Wat met het maximum aantal machines dat je naar Mascus kan syncen?
Hoeveel machines je op Mascus kan publiceren, hangt af van je abonnement of overeenkomst met Mascus. Een technische koppeling verandert dat maximum niet.
Ze zorgt er wel voor dat je de beschikbare plaatsen efficiënter kan beheren. Wanneer een machine verkocht of verwijderd wordt, kan er vanuit je eigen beheer opnieuw ruimte worden gemaakt voor een andere machine.
Ook hier is een goede verwijder- en synchronisatielogica belangrijk. Het systeem moet rekening houden met het feit dat Mascus wijzigingen niet altijd onmiddellijk verwerkt.

Kan verhuurinformatie ook worden doorgestuurd?
Ja, de API bevat specifieke mogelijkheden voor verhuuradvertenties. Een product kan in de verhuursectie worden geplaatst of tegelijk in de gewone en de verhuursectie worden getoond. Daarnaast kunnen specifieke verhuurvelden en maximaal drie verhuurbijlagen worden meegestuurd. Denk bijvoorbeeld aan een technische fiche of verhuurdocument.
Wat zijn de voordelen van een Mascus-koppeling?
Minder dubbel werk
Je hoeft dezelfde machinegegevens niet meer afzonderlijk op je website en op Mascus in te voeren. Ik denk dat dat het belangrijkste voordeel is.
Minder kans op fouten
Wanneer gegevens meerdere keren manueel worden overgenomen, kunnen prijzen, specificaties of beschikbaarheden van elkaar beginnen afwijken.
Door vanuit één centrale bron te werken, verklein je die kans.
Sneller nieuwe machines publiceren
Een machine die volledig in je eigen beheer staat, kan met de juiste categorie en eigenschappen naar Mascus worden doorgestuurd.
Machines eenvoudiger aanpassen
Wijzig je een relevant productgegeven in je centrale beheer? Dan kan de bestaande advertentie in Mascus worden bijgewerkt.
Verkochte machines beter opvolgen
Met een delete- of offlinefunctie hoef je niet telkens afzonderlijk in Mascus te zoeken naar de juiste advertentie.
Je eigen website blijft centraal staan
Mascus helpt om je machines bij een groot doelpubliek zichtbaar te maken. Toch blijft ook je eigen website belangrijk.
Daar bepaal je zelf:
- hoe je aanbod wordt gepresenteerd;
- welke filters bezoekers kunnen gebruiken;
- welke aanvullende diensten je toont;
- hoe mensen een verhuur- of aankoopvraag stellen;
- hoe je bedrijf en expertise worden voorgesteld;
- welke conversies je meet.
Mascus en je eigen website hoeven dus niet met elkaar te concurreren. Ze kunnen elkaar net versterken.
Is iedere website geschikt voor een Mascus-integratie?
Niet ieder standaard websitesysteem biedt evenveel ruimte voor maatwerk en externe koppelingen. Een Mascus-integratie vraagt onder andere:
- een uitbreidbare beheersinterface;
- een duidelijke productstructuur;
- unieke product-ID’s;
- een correcte categorisering;
- opslag van synchronisatiestatussen;
- foutmeldingen en technische opvolging;
- logica voor toevoegen, aanpassen en verwijderen.
Daarom bouwen wij websites op maat van de werking van een bedrijf. We bekijken niet alleen hoe de website eruitziet, maar ook wat er achter de schermen moet gebeuren om tijd te besparen.