Alles over Winstore
Winstore: Producten uit Winstore ophalen
Haal gewijzigde artikelen op uit Winstore, met maten als varianten, categorie en voorraad per filiaal, en stuur ze door naar je webshop.
Bijgewerkt op 9 november 2026
Deze flow haalt gewijzigde artikelen op uit Winstore en stuurt ze door naar een andere applicatie, zoals je webshop. APIcenter haalt per run een deel van de gewijzigde artikelen op.
Zo worden artikelen opgehaald
- APIcenter vraagt Winstore om alle artikelen die zijn gewijzigd sinds de datum bij Specify the Date from which you want to retrieve Products.
- Staat Only process web items aan? Dan houdt APIcenter alleen artikelen over waarvan het veld
Onlineartikelaan staat. - APIcenter verwerkt per run maximaal het aantal artikelen bij Amount to process, te beginnen bij Offset.
- Na de run telt APIcenter het aantal verwerkte artikelen op bij Offset. Zijn het er minder dan Amount to process, dan is de lijst helemaal verwerkt. APIcenter zet dan Specify the Date from which you want to retrieve Products op het starttijdstip van die run en Offset terug op 0.
Varianten
- Heeft een artikel in Winstore maten, dan maakt APIcenter van elke maat een variant. De barcode van de maat wordt het modelnummer van de variant.
- Heeft een artikel geen maten, dan komt het door als één product. Het artikelnummer is dan de id van het product.
Categorie
APIcenter bepaalt de categorie van een product zo:
- Is Field to use as category ingevuld? Dan wordt de waarde van dat veld uit Winstore de categorie.
- Is die instelling leeg? Dan gebruikt APIcenter Default category name.
- Is ook die leeg? Dan gebruikt APIcenter het veld
WarengruppeBezvan het artikel.
De categorie krijgt geen bovenliggende categorie.
Voorraad
APIcenter haalt voor elke variant de voorraad op bij Winstore, op de barcode van de maat. Je krijgt de voorraad per filiaal, met de hoeveelheid, de filiaalcode en de naam van het filiaal. Geeft Winstore voor een barcode geen voorraad terug, dan zet APIcenter de voorraad op 0. Winstore geeft artikelen zonder voorraad namelijk niet terug.
Standaard mapping
De standaard mapping koppelt deze velden uit Winstore aan APIcenter. Je kunt ze aanpassen onder Data mapping. Zie Data mapping.
ArtikelBez: naam.WebMemo: omschrijving.ArtikelNr: modelnummer.EanenBarcode: EAN en barcode.VkenSteuersatz: verkoopprijs inclusief btw en btw-tarief.LieferantenIdentNr: leveranciersreferentie en referentie.
Wat je eerst nodig hebt
- Winstore is gekoppeld. Zie Winstore koppelen aan APIcenter.
- De andere applicatie van de integratie kan producten ontvangen.
Tips
- Haal eerst alle artikelen op en zet daarna pas Initial run done aan. Zo weet de flow voor voorraad (zie Voorraad uit Winstore ophalen) dat de artikelen er zijn.
- Duurt een run te lang, verlaag dan Amount to process. Staat de lijst van gewijzigde artikelen vol, dan duurt het meerdere runs voordat alles is verwerkt.
Hieronder vind je alle instellingen van deze flow, elk met een eigen uitleg.
Instellingen
De instellingen die je in het dashboard ziet, met wat elke instelling doet.
Default category name
CategoriesDit is de naam van de categorie die APIcenter gebruikt als Field to use as category leeg is. Is deze instelling ook leeg, dan gebruikt APIcenter het veld WarengruppeBez van het artikel. De categorie krijgt geen bovenliggende categorie.
Enable use of default category
CategoriesZet deze instelling aan om een standaardcategorie te gebruiken voor producten of varianten zonder categorie. De naam van die categorie vul je in bij Default category name. Heeft een product al een categorie, dan blijft die staan, tenzij je Force use of default category aanzet. Standaard staat deze instelling uit.
Field to use as category
CategoriesVul de naam in van het veld uit Winstore dat de categorie van het artikel bevat. APIcenter gebruikt de waarde van dat veld als categorie. Laat je dit veld leeg, dan gebruikt APIcenter de waarde van Default category name. Is ook die leeg, dan gebruikt APIcenter het veld WarengruppeBez van het artikel.
Force category on variant as parent
CategoriesHiermee bepaal je of de categorie van het hoofdproduct ook wordt gezet op een variant zonder categorie. Standaard staat deze instelling uit. Dit werkt alleen als Set category on variant as parent aan staat.
Force use of default category
CategoriesZet deze instelling aan om de standaardcategorie altijd te gebruiken, ook als het product al een categorie heeft. De categorie van het product wordt dan vervangen door de standaardcategorie. Dit werkt alleen als Enable use of default category aan staat. Standaard staat deze instelling uit.
Set category on variant as parent
CategoriesHiermee bepaal je of een variant zonder categorie de categorie van het hoofdproduct krijgt. Standaard staat deze instelling uit.
Enable URL Encoding of data in the endpoints of the source application
General flow settingHiermee codeer je de waarden in het adres (de URL) van de bronapplicatie, dus bij flows die gegevens ophalen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.
Enable URL Encoding of data in the endpoints of the target application
General flow settingHiermee codeer je de waarden in het adres (de URL) van de doelapplicatie, dus bij flows die gegevens versturen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.
Enable URL encoding of data in endpoints
General flow settingZet dit aan als er speciale tekens in de data staan die in het adres (de URL) van een verzoek terechtkomen, zoals in een SKU of categorienaam. De waarden worden dan URL-gecodeerd, zodat het verzoek niet misgaat. Met Enable URL Encoding of data in the endpoints of the source application en Enable URL Encoding of data in the endpoints of the target application bepaal je voor welke kant dit geldt. Standaard staat dit uit.
Use administration mapping table
General flow settingZet dit aan om de administratie om te zetten met een koppeltabel tussen de twee applicaties. Wat er gebeurt met een waarde die niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.
What to do with a value that cannot be mapped using the mapping table
General flow settingHier kies je wat er gebeurt met een administratie die niet in de koppeltabel staat. Bij Waarde negeren wordt de waarde leeggelaten, bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Standaardwaarde gebruiken wordt de standaardwaarde uit Default administration id gebruikt, als je die hebt ingeschakeld. Deze instelling werkt alleen als Use administration mapping table aanstaat. Standaard is Standaardwaarde gebruiken gekozen.
Notifications Email address
NotificationsVul hier het e-mailadres in waarnaar APIcenter meldingen stuurt over mislukte activiteiten van deze flow. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan gebruikt APIcenter bij Direct het e-mailadres van je account. Er is geen standaardwaarde.
Notifications Slack webhook
NotificationsVul hier de Slack-webhook van je Slack-werkruimte in om meldingen over mislukte activiteiten ook in Slack te ontvangen. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan stuurt APIcenter geen Slack-melding. Er is geen standaardwaarde.
Notifications frequency
NotificationsKies hoe vaak APIcenter meldt dat activiteiten van deze flow zijn mislukt. Bij Direct volgt de melding zodra een activiteit mislukt. Bij Elke 30 minuten, Elk uur, Dagelijks en Wekelijks stuurt APIcenter een overzicht van de mislukte activiteiten die nog niet gemeld zijn. Dit werkt alleen als Receive Notifications aan staat. Standaard is dit Direct.
Receive Notifications
NotificationsZet dit aan om een melding te krijgen als een activiteit van deze flow mislukt. Met Notifications frequency bepaal je hoe vaak je de melding krijgt, en met Notifications Email address en Notifications Slack webhook waar die naartoe gaat. Standaard staat dit uit.
Only process web items
Product SettingsStaat deze instelling aan, dan verwerkt de flow alleen artikelen waarvan het veld Onlineartikel in Winstore aan staat. Dit veld staat vast: je kunt het niet wijzigen. Staat de instelling uit, dan verwerkt de flow alle gewijzigde artikelen. Standaard staat de instelling uit.
Amount to process
Run behaviourDit is het maximale aantal items dat de flow in één run verwerkt. Bij de flow Producten is de standaardwaarde 2 en kun je kiezen uit 1, 2 of 3. Bij de flow Voorraad is de standaardwaarde 10.
Last execution time
Run behaviourHier staat het moment waarop de flow voor het laatst is gestart. APIcenter vult dit zelf in na elke run en gebruikt het om te bepalen wanneer de flow weer mag draaien. Je hoeft dit normaal niet te wijzigen. De standaardwaarde is 1980-01-01T00:00:01: de flow heeft dan nog niet gedraaid.
Maximum number of pages to retrieve
Run behaviourDit is het maximale aantal pagina's dat de flow in één run ophaalt. Het aantal items per pagina stel je in bij Use page size. De standaardwaarde is 20.
Offset
Run behaviourDit is het aantal artikelen dat de flow Producten overslaat in de lijst met gewijzigde artikelen. APIcenter telt na elke run het aantal verwerkte artikelen erbij op, en zet de waarde terug op 0 als er minder artikelen waren dan Amount to process. Wijzig dit alleen als je de flow opnieuw vanaf een bepaald punt wilt laten ophalen. De flow Voorraad gebruikt deze instelling niet.
Run at specific times
Run behaviourHier kies je vaste tijden van de dag waarop de flow ook moet starten. Je kunt meerdere tijden kiezen, in stappen van 15 minuten. Er is geen standaardwaarde.
Winstore geeft alleen artikelen en voorraad terug die na deze datum zijn gewijzigd. De standaardwaarde is 2026-01-01T00:00:00. Bij de flow Producten zet APIcenter de datum pas op het starttijdstip van de run als alle gewijzigde artikelen zijn verwerkt, dus als er minder artikelen waren dan Amount to process. Bij de flow Voorraad zet APIcenter de datum na elke run op de wijzigingsdatum van de laatste verwerkte barcode. Zet je de datum terug, dan haalt de flow de gegevens opnieuw op.
Use page size
Run behaviourDit is het aantal items dat de flow per API-verzoek ophaalt. Samen met Maximum number of pages to retrieve bepaalt dit hoeveel items één run kan ophalen. De standaardwaarde is 50.