Alles over HubSpot

HubSpot: Producten ophalen uit HubSpot

Haal producten op uit HubSpot, met SKU, naam, omschrijving en prijs, en stuur ze door naar je webshop of een andere applicatie.

Bijgewerkt op 9 november 2026

Deze flow haalt producten op uit HubSpot en stuurt ze naar een andere applicatie, bijvoorbeeld een webshop. Gebruik deze flow als HubSpot het leidende systeem is voor je producten.

Zo werkt het

  • APIcenter haalt alleen producten op die zijn gewijzigd na de ingestelde datum, de oudste wijziging eerst. Per run haalt APIcenter maximaal het ingestelde aantal op, standaard 10. Na elke run zet APIcenter de datum op de wijzigingsdatum van het laatste product. Zet je de datum terug, dan haalt APIcenter producten opnieuw op.
  • Standaard stuurt APIcenter de SKU (hs_sku) als productcode, de naam, de omschrijving, de prijs en het btw-bedrag mee. Meer velden voeg je toe onder Data mapping.
  • Heeft een product een afbeeldings-URL in het veld hs_images, dan gebruikt APIcenter die als afbeelding van het product.
  • Varianten verwerkt APIcenter alleen als je de producteigenschap voor het hoofdproduct instelt. Een product waarvan die eigenschap de SKU van een ander product bevat, is een variant van dat product. Laat je de eigenschap leeg, dan verwerkt APIcenter alle producten als losse producten.
  • Kenmerken en attributen komen uit twee eigenschapsgroepen in HubSpot: de groep voor kenmerken en de groep voor attributen. Elke eigenschap in zo'n groep is een kenmerk of attribuut, met de label van de gekozen optie als waarde. Dit werkt alleen als je ook de eigenschap voor het hoofdproduct hebt ingesteld.

Wat je eerst nodig hebt

  • HubSpot is gekoppeld aan APIcenter. Zie HubSpot koppelen aan APIcenter.
  • Voor varianten: een producteigenschap in HubSpot waarin de SKU van het hoofdproduct staat.
  • Voor kenmerken en attributen: eigenschapsgroepen in HubSpot met de eigenschappen die je wilt doorgeven.
  • De andere applicatie van de integratie kan producten ontvangen.

Tips

  • Ontbreekt een product in het doelsysteem? Controleer of het is gewijzigd na de ingestelde datum. Zo niet, zet de datum dan terug.
  • De standaard data mapping bevat geen voorraad en geen categorieën. Heb je die nodig, voeg ze dan toe onder Data mapping.
  • Bestaat de producteigenschap voor het hoofdproduct niet in HubSpot, dan stopt de flow met een foutmelding. Controleer de naam.

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.

Deze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen categorie mee. De waarde wordt alleen gebruikt als Enable use of default category aan staat en je categorie zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.

Deze instelling heeft in de standaard data mapping naar HubSpot geen effect. De HubSpot-flows verwerken geen productcategorieën en de standaard data mapping stuurt geen categorie mee. Je hebt hem alleen nodig als je de categorie zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.

Deze instelling heeft geen effect voor HubSpot. De HubSpot-flows verwerken geen productcategorieën, dus er is niets om van het hoofdproduct over te nemen. Laat hem uit staan (standaard).

Deze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen categorie meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je categorie zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).

Deze instelling heeft geen effect voor HubSpot. De HubSpot-flows verwerken geen productcategorieën, dus er is niets om van het hoofdproduct over te nemen. Laat hem uit staan (standaard).

Deze instelling heeft geen effect. APIcenter gebruikt hem in de HubSpot-flows niet. Wil je extra productvelden uit HubSpot ophalen, koppel ze dan onder Data mapping. Laat het veld leeg.

Use custom Product properties

Custom Properties

Deze instelling heeft geen effect. APIcenter gebruikt hem in de HubSpot-flows niet. Wil je extra productvelden uit HubSpot ophalen, koppel ze dan onder Data mapping. Laat deze instelling uit staan.

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.

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

Zet URL-codering aan voor waarden die APIcenter in de URL van een verzoek aan HubSpot zet. Dit voorkomt fouten met speciale tekens zoals spaties, schuine strepen of ampersands. Bij HubSpot staan zoekwaarden zoals een e-mailadres, SKU of dealnaam in de inhoud van het verzoek en niet in de URL; in de URL staan alleen ID's en objecttypes. Je hebt dit daarom zelden nodig. Dit is de hoofdschakelaar: waarden worden alleen gecodeerd als je ook Enable URL Encoding of data in the endpoints of the source application (bij ophalen) of Enable URL Encoding of data in the endpoints of the target application (bij versturen) aanzet. Standaard staat dit uit.

Use administration mapping table

General flow setting

Deze instelling heeft geen effect voor HubSpot. De data die APIcenter met HubSpot uitwisselt, heeft geen administratieveld, dus er valt niets te mappen. Laat deze instelling uit staan (standaard).

Deze instelling heeft geen effect voor HubSpot, omdat de data die APIcenter met HubSpot uitwisselt geen administratieveld heeft. Laat hem staan zoals hij is.

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.

Notifications frequency

Notifications

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.

Receive Notifications

Notifications

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.

Bepaalt of APIcenter een eigenschap of een optie die niet in HubSpot bestaat, zelf aanmaakt. Staat dit uit (standaard), dan stopt de flow met een foutmelding als een eigenschap of optie ontbreekt. Staat dit aan, dan maakt APIcenter de eigenschap of optie aan in de groep die je hebt ingesteld. Een optie kan alleen worden toegevoegd aan een eigenschap die HubSpot niet vergrendeld heeft; anders volgt een foutmelding.

De naam van de eigenschapsgroep (property group) in HubSpot die de eigenschappen voor attributen bevat, zoals kleur of maat, waarmee varianten verschillen. Bij Get Product leest APIcenter elke eigenschap in deze groep als attribuut, met de label van de gekozen optie als waarde; dat werkt alleen als je ook de eigenschap voor het hoofdproduct hebt ingesteld. Bij Send Product schrijft APIcenter de attributen naar eigenschappen in deze groep. Laat je dit veld leeg, dan verwerkt APIcenter geen attributen.

De naam van de eigenschapsgroep (property group) in HubSpot die de eigenschappen voor kenmerken van een product bevat. Bij Get Product leest APIcenter elke eigenschap in deze groep als kenmerk, met de label van de gekozen optie als waarde; dat werkt alleen als je ook de eigenschap voor het hoofdproduct hebt ingesteld. Bij Send Product schrijft APIcenter de kenmerken naar eigenschappen in deze groep. Laat je dit veld leeg, dan verwerkt APIcenter geen kenmerken.

De naam of het label van de producteigenschap in HubSpot waarin de SKU van het hoofdproduct staat. Bij Get Product behandelt APIcenter een product met een waarde in deze eigenschap als variant van het product met die SKU. Bij Send Product krijgt een variant de SKU van het hoofdproduct in deze eigenschap. Bestaat de eigenschap niet, dan stopt de flow met een foutmelding, tenzij Create missing properties in the target system aan staat. Laat je dit veld leeg, dan verwerkt APIcenter alle producten als losse producten, zonder varianten.

Amount to process

Run behaviour

Het maximale aantal contacten, producten of deals dat APIcenter per run uit HubSpot ophaalt. De standaardwaarde is 10; je kunt een getal van 1 tot en met 15 kiezen. APIcenter haalt de oudst gewijzigde records eerst op. Met een hoger aantal werk je een achterstand sneller weg, maar duurt elke run langer.

De datum en tijd vanaf wanneer APIcenter contacten (Get Customer) of producten (Get Product) uit HubSpot ophaalt. APIcenter haalt alleen records op die ná dit moment zijn gewijzigd, de oudste wijziging eerst. Na elke run zet APIcenter de datum op de wijzigingsdatum van het laatste opgehaalde record, dus je hoeft dit normaal niet aan te passen. Zet je de datum terug in de tijd, dan haalt APIcenter die records opnieuw op en stuurt ze opnieuw door. Standaard: 2025-01-01T00:00:00.

Last execution time

Run behaviour

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.

Deze instelling heeft voor HubSpot in de praktijk geen effect. De HubSpot-flows vragen per run één lijst op met een eigen limiet (bij ophalen is dat Amount to process) en lezen geen extra pagina's. De standaardwaarde is 20; je hoeft dit niet aan te passen.

Offset

Run behaviour

Deze instelling heeft voor HubSpot geen effect. Get Customer houdt bij waar de flow is gebleven met de datum vanaf wanneer contacten worden opgehaald, niet met een offset. De standaardwaarde is 0; je hoeft dit niet aan te passen.

Run at specific times

Run behaviour

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.

Use page size

Run behaviour

Deze instelling heeft voor HubSpot in de praktijk geen effect. De HubSpot-flows bepalen zelf hoeveel records ze per verzoek opvragen: bij ophalen is dat Amount to process. De standaardwaarde is 50; je hoeft dit niet aan te passen.

Nog vragen?

Stel je vraag aan de supportassistent in je dashboard of maak een supportticket aan.

Naar support