Skwirrel: Producten ophalen uit Skwirrel

Bepaalt hoe de aangepaste eigenschappen van handelsartikelen van producten worden gebruikt: features, metafields of don't use. De oorspronkelijke waarden blijven altijd beschikbaar in de data. Wijzig dit als je ze ergens anders wilt ontvangen dan de standaardkeuze. De standaardkeuze is features.

Het gaat om de aangepaste klassen van het product in Skwirrel: eigen eigenschappen met een klassecode en een klassenaam. APIcenter geeft alleen eigenschappen door die van toepassing zijn en een waarde hebben. De standaardkeuze is features. Voor een variant geldt How should the variant custom properties be used.

Bepaalt hoe de aangepaste eigenschappen van handelsartikelen van varianten worden gebruikt: attributes, features, metafields of don't use. De oorspronkelijke waarden blijven altijd beschikbaar in de data. Wijzig dit als je ze ergens anders wilt ontvangen dan de standaardkeuze. De standaardkeuze is attributes.

Het gaat om de vrije eigenschappen van het product in Skwirrel. De naam van de eigenschap is de naam in de data, de waarde is de waarde in Skwirrel. APIcenter geeft alleen eigenschappen door die een waarde hebben. De standaardkeuze is metafields. Voor een variant geldt How should the variant free properties be used.

Het gaat om de ETIM-eigenschappen van het product in Skwirrel, met de klasse en groep waartoe ze horen. APIcenter geeft alleen eigenschappen door die van toepassing zijn en een waarde hebben. De afkorting van de eenheid wordt achter de waarde gezet. Kies je features, dan komen ze in de kenmerken van het product. De standaardkeuze is features. Voor een variant geldt How should the variant properties be used.

Het gaat om de aangepaste klassen van de variant in Skwirrel. Dit geldt alleen voor de variant van een product met varianten. Het hoofdproduct en een gewoon product volgen How should the custom properties of products be used. De standaardkeuze is don't use: de aangepaste klassen van een variant worden dan niet doorgegeven als eigenschap.

Het gaat om de vrije eigenschappen van de variant in Skwirrel. Dit geldt alleen voor de variant van een product met varianten. Het hoofdproduct en een gewoon product volgen How should the free properties of products be used. De standaardkeuze is metafields.

Het gaat om de ETIM-eigenschappen van de variant in Skwirrel. Dit geldt alleen voor de variant van een product met varianten. Het hoofdproduct en een gewoon product volgen How should the properties of products be used. De standaardkeuze is features.

De naam van de standaardcategorie die APIcenter gebruikt als Enable use of default category aan staat en een product of variant geen categorie heeft (of als je Force use of default category aanzet). De categorie krijgt geen bovenliggende categorie. Standaard is de naam Import API Center.

Zet 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.

Hiermee 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.

Zet 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.

Hiermee bepaal je of een variant zonder categorie de categorie van het hoofdproduct krijgt. Standaard staat deze instelling uit.

Kies categories om de productcategorieën van Skwirrel te gebruiken. De naam van de categorie is de categoriecode uit Skwirrel, met de bovenliggende categorieën erbij. Kies product groups om de productgroepen als categorieën te gebruiken. De koopgroep en de kortingsgroep van het product staan dan niet tussen die categorieën: ze zijn als aparte velden beschikbaar. De standaardkeuze is categories.

Hiermee 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.

Zet 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.

Zet 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.

Hier 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.

Vul 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.

Vul 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.

Kies 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.

Zet 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.

Vul het ID in van de prijslijst in Skwirrel, als getal. Is de instelling leeg, dan gebruikt APIcenter prijslijst 1. Heeft een product geen prijs in deze prijslijst, dan mislukt het product met de melding dat er geen prijs is gevonden voor de prijslijst.

In Skwirrel gaat het om een selectie, niet om een webnode. Zet je deze instelling aan, dan haalt de flow alleen de producten op die in de Skwirrel-selectie zitten met het id dat je bij Selection Id to retrieve invult. Staat de instelling uit, dan worden alle producten opgehaald.

Vul hier het id van één selectie in Skwirrel in, als getal. Staan er meerdere id's, dan gebruikt APIcenter alleen het eerste en meldt dat in het verslag van de flow. Is de waarde geen getal, dan mislukt de flow met de melding dat het id niet numeriek is. De standaardwaarde is 1. Deze instelling werkt alleen als Only get products from selected Ids aan staat.

Voor Skwirrel kies je 1, 2 of 3 producten per run, standaard 2. Per product haalt APIcenter veel gegevens op, zoals prijzen, afbeeldingen en eigenschappen. Bij de flow voor productrelaties kies je tussen 1 en 15, standaard 10.

Hier staat of de eerste run voor het importeren van items van deze flow klaar is. Flows die een cachebestand gebruiken, zetten deze instelling zelf aan na de eerste run. De standaardwaarde is uit.

Hier 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.

Dit 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.

Dit is het aantal items dat de flow overslaat bij het ophalen. APIcenter werkt de waarde zelf bij na een run: is het aantal opgehaalde items gelijk aan Amount to process, dan wordt de waarde met dat aantal verhoogd, anders wordt hij teruggezet. Wijzig dit alleen als je de flow opnieuw vanaf een bepaald punt wilt laten ophalen. De standaardwaarde is 0.

Hier 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.

De flow vraagt Skwirrel welke producten na deze datum zijn gewijzigd. Het gaat om de wijzigingsdatum van het product in Skwirrel. APIcenter verwerkt die producten daarna per run, zoveel als Amount to process. De standaardwaarde is 2026-01-01T00:00:00: producten die voor die datum voor het laatst zijn gewijzigd, worden dan niet opgehaald.

Dit 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.