KoppelingenCycleSoftware
CycleSoftware API koppelen aan je webshop.
CycleSoftware is het kassa-, voorraad- en werkplaatssysteem van de tweewielerbranche. Wij koppelen het aan je eigen website of webshop: je fietsen en artikelen staan er met de voorraad van dat moment, en een bestelling komt terug in het systeem waar je toch al in werkt.
Vertrouwd door
200+ bedrijven en webshops
Wat het oplevert
Wat een koppeling met CycleSoftware je oplevert.
Voorraad van dat moment. Fietsen en artikelen staan op je site met de voorraad zoals die in de winkel is, en met de voorraad van je leverancier erbij.
Bestellingen in je kassa. Een order uit je webshop komt binnen in CycleSoftware, met de producten en de klantgegevens erbij.
Filters die echt werken. De artikeldata komt uit de branchestandaard DST, dus maat, kleur, merk en motorvermogen zijn losse velden.
Technisch
De koppeling in het kort.
- Vorm van de koppeling
- REST met JSON via CS Connect, daarnaast oudere SOAP-webservices
- Authenticatie
- HTTP Basic met gebruikersnaam, wachtwoord en api-key, per vestiging
- Richting
- Beide kanten op
- Verversing
- Voorraad bij het opvragen; wijzigingen in orders, offertes, werkplaats en facturen via webhooks
- Wij bouwen het op
- WordPress, Next.js, Maatwerk
Waar het misgaat
- De API’s zitten achter CS Connect. Daarmee komen de scopes e-commerce, resources, stock-export, sales-export, rental en webhooks beschikbaar. Staat CS Connect niet op het account, dan kan er niets worden opgehaald en niets worden getest. Dat is dus de eerste stap van het traject en niet iets wat je onderweg regelt.
- Er zit een limiet per minuut en per dag. Sinds mei 2022 geeft elk antwoord headers mee met wat je nog over hebt, en bij overschrijding volgt een 429. Dat bepaalt hoe je het bouwt: je haalt periodiek op en slaat lokaal op, en je vraagt niet bij elke bezoeker live aan CycleSoftware. Bij een winkel met duizenden artikelen is dat het verschil tussen een site die het houdt en een site die halverwege de middag stilvalt.
- Paginering gaat op twee manieren. De meeste lijsten werken met een offset, de nieuwere artikeldata met een adres naar de volgende pagina. Bouw je op offset terwijl de bron het andere gebruikt, dan sla je stilletjes artikelen over zodra de lijst verandert terwijl je hem doorloopt. Kijk dus per endpoint wat er staat.
- De artikeldata komt uit DST, de branchestandaard voor tweewielers, en dat is de reden dat filteren op een fietsenwebshop überhaupt werkt. Maar niet elk merk levert volledig aan. Reken erop dat een deel van je aanbod minder velden heeft en bouw je filters zo dat een leeg veld een fiets niet laat verdwijnen uit de resultaten.
CycleSoftware koppelen
Wat je moet weten voor je begint.
Wat is CycleSoftware?
CycleSoftware is bedrijfssoftware voor de tweewielerbranche, gemaakt door CycleSoftware B.V. in Nistelrode. Het is geen voorraadpakket alleen: kassa, voorraad, pakbonverwerking, verkoopregistratie, werkplaatsplanning en verhuur zitten er allemaal in, en het draait online.
Voor een fietsenwinkel is dat het systeem waar de dag in begint en eindigt. Dat is ook meteen het uitgangspunt van een koppeling: de winkel blijft in CycleSoftware werken en de website haalt op wat daar staat. Twee plekken waar je voorraad bijhoudt is geen koppeling maar een probleem.
Wat de webshopkoppeling uitwisselt
Twee kanten op, en dat is wat deze koppeling anders maakt dan een gewone voorraadfeed.
Naar je site gaan de tweewielers en de artikelen, met de voorraadstand van dat moment, de voorraadindicatie van je leverancier, je winkel- of webshopprijs en de volledige productinformatie met foto’s en de DST-productcategorieën. Dat laatste is wat je zoekfilters en je categoriepagina’s voedt.
Terug komen de bestellingen. Een order uit je webshop verschijnt in CycleSoftware met de producten en de klantgegevens erbij, zodat je hem afhandelt vanuit hetzelfde systeem als een verkoop aan de balie. Met de webhooks-API krijg je daarnaast bericht bij wijzigingen in orders, offertes, werkplaats en facturen, zodat je site niet hoeft te blijven vragen of er al iets is.
De limiet bepaalt hoe je het bouwt
Dit is het punt waar een koppeling misgaat, en het is geen detail. CycleSoftware limiteert het aantal aanvragen per minuut en per dag. Elk antwoord vertelt je hoeveel je er nog over hebt, en ga je eroverheen dan krijg je een 429 terug en niets anders.
De verleiding is om de voorraad live op te vragen bij elke bezoeker, want dan klopt hij altijd. Dat gaat goed tot de eerste drukke dag. Wij halen daarom periodiek op en bewaren het aan onze kant, en vragen alleen de voorraadstand van één artikel live op waar dat echt uitmaakt, zoals op de productpagina zelf.
Hoe vaak dat moet hangt af van je winkel. Een fiets die één keer verkocht wordt vraagt iets anders dan een band die je met tientallen tegelijk hebt liggen. Die afweging maken we per klant, en we zetten er een melding op als het ophalen stilvalt.
Waarom DST-data het verschil maakt
DST is de branchestandaard voor artikeldata in de tweewielerbranche. Leveranciers leveren hun producten daar op één manier aan, en CycleSoftware gebruikt die data.
Voor een webshop is dat precies wat je nodig hebt. Merk, maat, kleur, framehoogte en motorvermogen zijn losse velden en geen zinnen in een omschrijving, dus je kunt er echt op filteren. Zonder zo’n standaard eindig je met filters die op tekst zoeken en dan valt de helft van je aanbod eruit omdat de ene leverancier "28 inch" schrijft en de andere "28".
Eén ding om rekening mee te houden: niet elk merk levert volledig aan. Wij bouwen de filters daarom zo dat een ontbrekend veld een product niet uit de resultaten haalt, want anders verdwijnt precies het aanbod waar de gegevens nog niet compleet van zijn.
Specialist voor koppelingen
JosDesign & Development085 83 30 533jos@klubb.nlVeelgestelde vragen
Kan ik mijn CycleSoftware-voorraad op mijn eigen webshop tonen?
Ja. CycleSoftware heeft daar een webshopkoppeling voor: je tweewielers en artikelen verschijnen op je site met de voorraad van dat moment, je prijs en de productinformatie met foto’s. De koppeling kan door elke webshopbouwer worden ingebouwd, dus je zit niet vast aan één leverancier.
Komen bestellingen uit mijn webshop in CycleSoftware terecht?
Ja, dat is de andere kant van dezelfde koppeling. Een order verschijnt in CycleSoftware met de producten en de klantgegevens erbij, zodat je hem afhandelt vanuit je eigen kassasysteem en je voorraad blijft kloppen. Je hoeft niets over te typen.
Heeft CycleSoftware een API?
Ja, en de documentatie is openbaar. Het zijn REST-endpoints die JSON teruggeven, met scopes voor e-commerce, voorraad, verkoop, verhuur en webhooks. Je hebt er wel CS Connect voor nodig op je account; dat is wat die scopes vrijgeeft.
Hoe actueel is de voorraad op mijn site?
Dat is een keuze en geen vaststaand gegeven. CycleSoftware limiteert het aantal aanvragen per minuut en per dag, dus live opvragen bij elke bezoeker kan niet. Wij halen periodiek op en vragen de stand van één artikel live op waar dat uitmaakt, zoals op de productpagina.
Werkt een CycleSoftware-koppeling ook op WordPress?
Ja. We slaan de opgehaalde fietsen en artikelen op als eigen berichttype in WordPress, zodat zoeken, filteren en losse productpagina’s werken zoals de rest van je site. CycleSoftware blijft leidend: je beheert de producten daar en niet in WordPress.
Wat is DST-artikeldata?
DST is de branchestandaard voor productgegevens in de tweewielerbranche. Merk, maat, kleur en motorvermogen komen als losse velden binnen in plaats van als tekst, en daar kun je echt op filteren. Niet elk merk levert volledig aan, dus we houden er in de filters rekening mee dat een veld leeg kan zijn.
Let’s work together.
Je winkelvoorraad en je webshop uit één systeem.