Alles over HubSpot
HubSpot: Verkooporders naar HubSpot sturen
Stuur orders uit je webshop of marketplace naar HubSpot als deal, met bedrijf, contact en orderregels.
Bijgewerkt op 9 november 2026
Deze flow stuurt verkooporders uit een andere applicatie, zoals een webshop of marketplace, naar HubSpot. APIcenter maakt van elke order een deal, met het bedrijf, het contact en de orderregels.
Zo werkt het
- De dealnaam is het ordernummer. Zonder ordernummer kan APIcenter de deal niet aanmaken.
- APIcenter zoekt in de pipeline een bestaande deal. Is Deal properties to find an existing deal leeg, dan zoekt het op de dealnaam. Vul je HubSpot-eigenschapsnamen in, dan probeert het die eigenschappen in die volgorde en stopt bij de eerste match. Elke controle gebruikt de dealnaam als waarde. Bestaat die al, dan hangt het af van Update order: staat dat uit, dan meldt de flow dat de deal al bestaat. Staat het aan en heeft de deal een andere fase dan de dealfase die je instelt, dan werkt APIcenter de deal bij en vervangt de orderregels.
- Bestaat de deal nog niet, dan verwerkt APIcenter eerst de klant, op dezelfde manier als de flow Klanten naar HubSpot sturen. Het bedrijf en het contact worden aangemaakt of bijgewerkt volgens de instellingen.
- Daarna maakt APIcenter de deal aan in de ingestelde pipeline en dealfase. Het dealbedrag is het ordertotaal inclusief btw en de sluitdatum is de orderdatum.
- APIcenter koppelt het contact en het bedrijf aan de deal. De associatietypes stel je in met contact naar deal, bedrijf naar deal, contact naar bedrijf en orderregel naar deal.
- Elke orderregel wordt een orderregel (line item) op de deal. APIcenter zoekt het product op de SKU (
hs_sku). Bestaat het product nog niet in HubSpot, dan maakt APIcenter het aan. - Verzendkosten, factuurkosten, betaalkosten en commissie komen niet standaard mee. Wil je ze als aparte orderregel, zet dan bijvoorbeeld Require order line for shipping costs aan.
- De standaard data mapping stuurt de betaalmethode en de verzendmethode niet mee. Voeg ze zo nodig toe onder Data mapping.
Wat je eerst nodig hebt
- HubSpot is gekoppeld aan APIcenter. Zie HubSpot koppelen aan APIcenter.
- De pipeline en de dealfase bestaan in HubSpot. De standaardwaarden zijn
defaultenclosedwon. Pas ze aan als jouw HubSpot-account andere namen of ID's heeft. - De bedrijfseigenschap voor het e-mailadres bestaat in HubSpot en de data mapping stuurt het e-mailadres van de klant ernaartoe. Standaard is dat
company_email. - Het contact van de order heeft een e-mailadres. Anders kan APIcenter het contact niet opzoeken of aanmaken. Stuurt het bronsysteem geen e-mailadres, gebruik dan een standaardklant met Enable use of default debtor.
- De andere applicatie van de integratie kan orders versturen.
Tips
- Wil je dealnamen herkenbaar of uniek houden bij meerdere stores? Gebruik een voorvoegsel of achtervoegsel bij het ordernummer, met Default order prefix of Default order suffix.
- De btw op een orderregel gaat als bedrag naar HubSpot. Het btw-tarief komt uit de bedragen van de order, of uit Default tax rate prices als het tarief daar niet in staat. Deze instelling vind je bij de HubSpot verbindings- en integratie-instellingen.
- Volgens HubSpot kan het even duren voordat nieuwe records in zoekresultaten verschijnen. Stuur je twee orders van dezelfde klant kort na elkaar, dan kan APIcenter het bedrijf of contact van de eerste order nog niet vinden.
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 association type for associating company to order or deal
Customer SettingsHet associatietype in HubSpot dat APIcenter gebruikt om een bedrijf aan een deal te koppelen. Standaard: Companies-to-Deals. Pas dit alleen aan als je een ander associatietype wilt gebruiken, en schrijf het in dezelfde vorm: eerst het objecttype, dan -to-, dan het andere objecttype. Laat je het veld leeg, dan gebruikt APIcenter het standaardtype tussen deze twee objecten. Kan APIcenter het type niet vinden in HubSpot, dan stopt de flow met een foutmelding.
Default association type for associating contact to company
Customer SettingsHet associatietype in HubSpot dat APIcenter gebruikt om een contact aan een bedrijf te koppelen. Standaard: Contacts-to-Companies. Pas dit alleen aan als je een ander associatietype wilt gebruiken, en schrijf het in dezelfde vorm: eerst het objecttype, dan -to-, dan het andere objecttype. Laat je het veld leeg, dan gebruikt APIcenter het standaardtype tussen deze twee objecten. Kan APIcenter het type niet vinden in HubSpot, dan stopt de flow met een foutmelding.
Default association type for associating contacts to orders or deals
Customer SettingsHet associatietype in HubSpot dat APIcenter gebruikt om een contact aan een deal te koppelen. Standaard: Contacts-to-Deals. Pas dit alleen aan als je een ander associatietype wilt gebruiken, en schrijf het in dezelfde vorm: eerst het objecttype, dan -to-, dan het andere objecttype. Laat je het veld leeg, dan gebruikt APIcenter het standaardtype tussen deze twee objecten. Kan APIcenter het type niet vinden in HubSpot, dan stopt de flow met een foutmelding.
Default association type for associating order lines to orders or deals
Customer SettingsHet associatietype in HubSpot dat APIcenter gebruikt om een orderregel (line item) aan een deal te koppelen. Standaard: Line_items-to-Deals. Pas dit alleen aan als je een ander associatietype wilt gebruiken, en schrijf het in dezelfde vorm: eerst het objecttype, dan -to-, dan het andere objecttype. Laat je het veld leeg, dan gebruikt APIcenter het standaardtype tussen deze twee objecten. Kan APIcenter het type niet vinden in HubSpot, dan stopt de flow met een foutmelding.
Default debtor email address
Customer SettingsHet e-mailadres dat APIcenter gebruikt als Enable use of default debtor aan staat en de order geen e-mailadres van de klant bevat (of altijd, als Force the usage of the default debtor aan staat). APIcenter controleert het e-mailadres: is het geen geldig adres, dan mislukt de order met een foutmelding. Het e-mailadres wordt gebruikt om het bedrijf in HubSpot te zoeken of aan te maken, in de eigenschap die je instelt bij Property to use as company email.
Default price list group
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen prijslijstgroep mee. De waarde wordt alleen gebruikt als Enable use of a default customer price list group aan staat en je prijslijstgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
Enable fallback to default id and/or email when customer not found
Customer SettingsDeze instelling heeft voor HubSpot geen effect. APIcenter zoekt de klant in HubSpot zelf (op ID, e-mailadres, naam of domein) en maakt de klant aan als die niet bestaat, in plaats van terug te vallen op een standaardklant. Je kunt hem laten staan zoals hij is.
Enable use of a default customer group
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt geen klantgroep mee. Je hebt hem alleen nodig als je klantgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping van de flow. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.
Enable use of a default customer price list group
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt geen prijslijstgroep mee. Je hebt hem alleen nodig als je prijslijstgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping van de flow. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.
Enable use of default debtor
Customer SettingsZet deze instelling aan om voor orders een standaardklant te gebruiken. Voor HubSpot telt alleen het e-mailadres: vul dat in bij Default debtor email address. APIcenter zet dat e-mailadres op de klant van de order, dus op het e-mailadres van het bedrijf in de data mapping. Het wordt gebruikt als de order geen e-mailadres van de klant heeft, of altijd als Force the usage of the default debtor aan staat. Staat dit aan maar is er geen e-mailadres (of ID) ingevuld, dan mislukken orders met een foutmelding. Standaard staat deze instelling uit.
Force the usage of the default customer group
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen klantgroep meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je klantgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Force the usage of the default debtor
Customer SettingsStaat deze instelling aan, dan vervangt APIcenter bij elke order het e-mailadres van de klant door dat uit Default debtor email address. Staat ze uit (standaard), dan wordt het standaard e-mailadres alleen gebruikt als de order geen e-mailadres van de klant bevat. Dit werkt alleen als Enable use of default debtor aan staat.
Force the usage of the default payment terms
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen betalingsvoorwaarde meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je betalingsvoorwaarde zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Force the usage of the default price list group
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen prijslijstgroep meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je prijslijstgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Force the usage of the payment_method id
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen betaalmethode meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je betaalmethode zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Lifecycle stage to set for companies
Customer SettingsDe lifecycle stage voor bedrijven, als naam of ID van de fase in HubSpot (hoofdletters maken niet uit). Standaard: customer. Bij Send Customer en Send Sales Order krijgen bedrijven die APIcenter verstuurt deze fase; dit is verplicht, behalve als je alleen contacten verwerkt. Bij Get Customer en Get Sales Order werkt APIcenter de opgehaalde bedrijven na het ophalen bij naar deze fase; laat je het veld leeg, dan wordt er niets bijgewerkt. Volgens HubSpot kunnen de standaardtools de lifecycle stage alleen vooruit zetten; voor een eerdere fase moet de waarde eerst worden leeggemaakt. Test dit met een voorbeeld.
Lifecycle stage to set for contacts
Customer SettingsDe lifecycle stage voor contacten, als naam of ID van de fase in HubSpot (hoofdletters maken niet uit). Standaard: customer. Bij Send Customer en Send Sales Order krijgen contacten die APIcenter verstuurt deze fase; dit is verplicht. Bij Get Customer en Get Sales Order werkt APIcenter de opgehaalde contacten na het ophalen bij naar deze fase; laat je het veld leeg, dan wordt er niets bijgewerkt. Volgens HubSpot kunnen de standaardtools de lifecycle stage alleen vooruit zetten; voor een eerdere fase moet de waarde eerst worden leeggemaakt. Test dit met een voorbeeld.
Make use of a default payment method id
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt geen betaalmethode mee. Je hebt hem alleen nodig als je betaalmethode zelf koppelt aan een HubSpot-eigenschap in de Data mapping van de flow. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.
Make use of a default payment terms id
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt geen betalingsvoorwaarde mee. Je hebt hem alleen nodig als je betalingsvoorwaarde zelf koppelt aan een HubSpot-eigenschap in de Data mapping van de flow. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.
Only process contact information
Customer SettingsZet dit aan als je alleen contacten in HubSpot wilt aanmaken of bijwerken en geen bedrijven. APIcenter verwerkt dan geen bedrijf en koppelt het contact dus ook niet aan een bedrijf. De pipeline en fase voor bedrijven zijn dan niet nodig. Standaard staat dit uit: dan maakt APIcenter het bedrijf en de contacten aan en koppelt ze.
Pipeline to set for companies
Customer SettingsDe pipeline voor bedrijven. Vul de naam of het ID van de pipeline in HubSpot in; hoofdletters maken niet uit. Standaard: companies-lifecycle-pipeline. Bij Send Customer en Send Sales Order zet APIcenter deze pipeline en de lifecycle stage voor bedrijven op bedrijven die het verstuurt. Dit is verplicht, behalve als je alleen contacten verwerkt (Only process contact information). Bij Get Customer en Get Sales Order werkt APIcenter de opgehaalde bedrijven na het ophalen bij naar deze pipeline en fase; laat je de velden leeg, dan wordt er niets bijgewerkt. Vul pipeline en fase altijd samen in.
Pipeline to set for contacts
Customer SettingsDe pipeline voor contacten. Vul de naam of het ID van de pipeline in HubSpot in; hoofdletters maken niet uit. Standaard: contacts-lifecycle-pipeline. Bij Send Customer en Send Sales Order zet APIcenter deze pipeline en de lifecycle stage voor contacten op contacten die het verstuurt. Bij Get Customer en Get Sales Order werkt APIcenter de opgehaalde contacten na het ophalen bij naar deze pipeline en fase; laat je de velden leeg, dan wordt er niets bijgewerkt. Vul pipeline en fase altijd samen in.
Property to use as company email
Customer SettingsDe naam of het label van de bedrijfseigenschap in HubSpot waarin het e-mailadres van het bedrijf staat. Standaard: company_email. APIcenter gebruikt dit e-mailadres om een bedrijf te herkennen en als herkenning van de klant in de activiteiten. Bestaat de eigenschap niet in HubSpot, dan stopt de flow met een foutmelding, tenzij Create missing properties in the target system aan staat: dan maakt APIcenter de eigenschap aan. Dit veld is verplicht. Bij het versturen moet het e-mailadres in de data mapping naar dezelfde eigenschap gaan.
Update pipeline & stage on existing companies
Customer SettingsBepaalt of APIcenter de pipeline en lifecycle stage ook zet op bedrijven die al in HubSpot bestaan. Staat dit aan (standaard), dan krijgen bestaande bedrijven de pipeline en fase uit de instellingen; staat het uit, dan gebeurt dat alleen bij nieuwe bedrijven. Let op: in de huidige koppeling bepaalt de instelling Update pipeline & stage on existing contacts ook of bestaande bedrijven een nieuwe pipeline en fase krijgen. Zet daarom beide instellingen hetzelfde. Een bestaand bedrijf wordt alleen bijgewerkt als Update existing companies aan staat.
Update pipeline & stage on existing contacts
Customer SettingsBepaalt of APIcenter de pipeline en lifecycle stage ook zet op contacten die al in HubSpot bestaan. Staat dit aan (standaard), dan krijgen bestaande contacten de pipeline en fase uit de instellingen; staat het uit, dan gebeurt dat alleen bij nieuwe contacten. Een bestaand contact wordt alleen bijgewerkt als Update existing contacts aan staat. Deze instelling geldt in de huidige koppeling ook voor bestaande bedrijven.
Use a mapping table to map the default payment method id
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen betaalmethode mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je betaalmethode zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Use customer group mapping table
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen klantgroep mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je klantgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Use default payment terms id mapping table
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen betalingsvoorwaarde mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je betalingsvoorwaarde zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Use default price list group mapping table
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen prijslijstgroep mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je prijslijstgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Value for the default payment method id
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen betaalmethode mee. De waarde wordt alleen gebruikt als Make use of a default payment method id aan staat en je betaalmethode zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
Value to use as Default debtor ID
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De waarde wordt op de klant gezet, maar de standaard data mapping koppelt dat klantnummer niet aan een HubSpot-veld. Gebruik in plaats daarvan Default debtor email address.
Value to use as default customer group
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen klantgroep mee. De waarde wordt alleen gebruikt als Enable use of a default customer group aan staat en je klantgroep zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
What to do with a value that cannot be mapped using the mapping table
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen klantgroep mee. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor klantgroepen zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
What to do with a value that cannot be mapped using the mapping table
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen betaalmethode mee. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor betaalmethodes zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
What to do with a value that cannot be mapped using the mapping table
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen betalingsvoorwaarde mee. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor betalingsvoorwaarden zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
What to do with a value that cannot be mapped using the mapping table
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen prijslijstgroep mee. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor prijslijstgroepen zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
default payment terms id
Customer SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen betalingsvoorwaarde mee. De waarde wordt alleen gebruikt als Make use of a default payment terms id aan staat en je betalingsvoorwaarde zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
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 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 settingDeze 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).
What to do with a value that cannot be mapped using the mapping table
General flow settingDeze instelling heeft geen effect voor HubSpot, omdat de data die APIcenter met HubSpot uitwisselt geen administratieveld heeft. Laat hem staan zoals hij is.
Default customer sales vat code id
Ledger SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen btw-code voor verkoop bij de klant mee. De waarde wordt alleen gebruikt als Enable the use of a default customer sales vat code id aan staat en je btw-code voor verkoop bij de klant zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
Enable the use of a default customer sales vat code id
Ledger SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt geen btw-code voor verkoop bij de klant mee. Je hebt hem alleen nodig als je btw-code voor verkoop bij de klant zelf koppelt aan een HubSpot-eigenschap in de Data mapping van de flow. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.
Force the usage of the customer sales vat code id
Ledger SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen btw-code voor verkoop bij de klant meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je btw-code voor verkoop bij de klant zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Use default customer sales vat code id mapping table
Ledger SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen btw-code voor verkoop bij de klant mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je btw-code voor verkoop bij de klant zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Deze instelling heeft voor HubSpot geen effect. De HubSpot-flows gebruiken geen betaaljournaal en de standaard data mapping stuurt er geen mee. Je kunt hem laten staan zoals hij is.
Deze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen btw-code voor verkoop mee. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor btw-codes voor verkoop bij de klant zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
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.
Add order line for billing costs
Order SettingsZet dit aan om de factuurkosten van de order als aparte orderregel toe te voegen. APIcenter doet dit alleen als de order een bedrag aan factuurkosten heeft. Vul daarna Default item code for billing costs in, anders mislukt de flow. Standaard staat dit uit.
Add order line for commission
Order SettingsZet dit aan om de commissie van de order als aparte orderregel toe te voegen. APIcenter doet dit alleen als de order een commissiebedrag heeft. Vul daarna Default item code for commission in, anders mislukt de flow. Standaard staat dit uit.
Add order line for payment costs
Order SettingsZet dit aan om de betaalkosten van de order als aparte orderregel toe te voegen. APIcenter doet dit alleen als de order een bedrag aan betaalkosten heeft. Vul daarna Default item code for Payment Costs in, anders mislukt de flow. Standaard staat dit uit.
Deal properties to find an existing deal
Order SettingsHubSpot-eigenschapsnamen, gescheiden door een komma, in de volgorde waarin APIcenter een bestaande deal zoekt. Elke controle zoekt de waarde van die eigenschap in de inkomende order. APIcenter stopt bij de eerste match. Laat het veld leeg om alleen de dealnaam (dealname) met de dealnaam uit de order te zoeken. Gebruik de interne naam van de eigenschap, of een label dat in HubSpot bestaat. Een naam die niet bestaat stopt de flow, zodat er geen dubbele deal ontstaat.
Default item code for Payment Costs
Order SettingsDe code die APIcenter op de extra orderregel met betaalkosten zet. In de standaard data mapping wordt de code de SKU (hs_sku) van het product op de regel. Bestaat er in HubSpot nog geen product met deze SKU, dan maakt APIcenter er een aan. Dit veld is verplicht als Add order line for payment costs aan staat; zonder code mislukt de order met een foutmelding.
Default item code for billing costs
Order SettingsDe code die APIcenter op de extra orderregel met factuurkosten zet. In de standaard data mapping wordt de code de SKU (hs_sku) van het product op de regel. Bestaat er in HubSpot nog geen product met deze SKU, dan maakt APIcenter er een aan. Dit veld is verplicht als Add order line for billing costs aan staat; zonder code mislukt de order met een foutmelding.
Default item code for commission
Order SettingsDe code die APIcenter op de extra orderregel met commissie zet. In de standaard data mapping wordt de code de SKU (hs_sku) van het product op de regel. Bestaat er in HubSpot nog geen product met deze SKU, dan maakt APIcenter er een aan. Dit veld is verplicht als Add order line for commission aan staat; zonder code mislukt de order met een foutmelding.
Default item code to use for shipping cost order line
Order SettingsDe code die APIcenter op de extra orderregel met verzendkosten zet. In de standaard data mapping wordt de code de SKU (hs_sku) van het product op de regel. Bestaat er in HubSpot nog geen product met deze SKU, dan maakt APIcenter er een aan. Dit veld is verplicht als Require order line for shipping costs aan staat; zonder code mislukt de order met een foutmelding.
Default order prefix
Order SettingsTekst die APIcenter vóór het ordernummer plaatst, bijvoorbeeld WEB- maakt van order 1001 de order WEB-1001. Zo herken je in HubSpot deals uit een bepaalde bron, of houd je dealnamen uniek als je meerdere stores hebt. Het voorvoegsel wordt alleen toegevoegd als de data mapping van het ordernummer de microfunctie voor het ordervoorvoegsel gebruikt; de standaard data mapping naar HubSpot doet dat niet. In HubSpot is het ordernummer de naam van de deal (dealname).
Default order suffix
Order SettingsTekst die APIcenter achter het ordernummer plaatst, bijvoorbeeld -NL maakt van order 1001 de order 1001-NL. Zo herken je in HubSpot deals uit een bepaalde bron, of houd je dealnamen uniek als je meerdere stores hebt. Het achtervoegsel wordt alleen toegevoegd als de data mapping van het ordernummer de microfunctie voor het orderachtervoegsel gebruikt; de standaard data mapping naar HubSpot doet dat niet. In HubSpot is het ordernummer de naam van de deal (dealname).
Default tax class id for billing costs order line
Order SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen btw-klasse of btw-code meestuurt. Het btw-bedrag van de extra orderregel met factuurkosten komt uit de bedragen van de order. Kan APIcenter het tarief daaruit niet bepalen, dan gebruikt het Default tax rate billing costs. Laat het veld leeg.
Default tax class id for commission order line
Order SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen btw-klasse of btw-code meestuurt. Het btw-bedrag van de extra orderregel met commissie komt uit de bedragen van de order. Kan APIcenter het tarief daaruit niet bepalen, dan gebruikt het Default tax rate commission. Laat het veld leeg.
Default tax class id for payment fee order line
Order SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen btw-klasse of btw-code meestuurt. Het btw-bedrag van de extra orderregel met betaalkosten komt uit de bedragen van de order. Kan APIcenter het tarief daaruit niet bepalen, dan gebruikt het Default tax rate payment costs. Laat het veld leeg.
Default tax class id for shipping costs order line
Order SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen btw-klasse of btw-code meestuurt. Het btw-bedrag van de extra orderregel met verzendkosten komt uit de bedragen van de order. Kan APIcenter het tarief daaruit niet bepalen, dan gebruikt het Default tax rate shipping costs. Laat het veld leeg.
Description to use for the order line for billing costs
Order SettingsVul hier de omschrijving in voor de orderregel met factuurkosten. Laat je het veld leeg, dan zet APIcenter geen eigen omschrijving op de regel. Dit werkt alleen als Add order line for billing costs aan staat. Er is geen standaardwaarde.
Description to use for the order line for commission
Order SettingsVul hier de omschrijving in voor de orderregel met commissie. Laat je het veld leeg, dan zet APIcenter geen eigen omschrijving op de regel. Dit werkt alleen als Add order line for commission aan staat. Er is geen standaardwaarde.
Description to use for the order line for payment costs
Order SettingsVul hier de omschrijving in voor de orderregel met betaalkosten. Laat je het veld leeg, dan zet APIcenter geen eigen omschrijving op de regel. Dit werkt alleen als Add order line for payment costs aan staat. Er is geen standaardwaarde.
Description to use for the order line for shipping costs
Order SettingsVul hier de omschrijving in voor de orderregel met verzendkosten. Laat je het veld leeg, dan zet APIcenter geen eigen omschrijving op de regel. Dit werkt alleen als Require order line for shipping costs aan staat. Er is geen standaardwaarde.
Require order line for shipping costs
Order SettingsZet dit aan om de verzendkosten van de order als aparte orderregel toe te voegen. APIcenter doet dit alleen als de order een bedrag aan verzendkosten heeft. Vul daarna Default item code to use for shipping cost order line in, anders mislukt de flow. Standaard staat dit uit.
Set free shipping on all order lines
Order SettingsDeze instelling heeft geen effect voor HubSpot. De HubSpot-koppeling gebruikt hem niet. Wil je de verzendkosten niet op de deal hebben, laat dan Require order line for shipping costs uit staan. Laat deze instelling uit staan (standaard).
Set the Dealstage where we create the deal
Order SettingsDe dealfase, als naam of ID van de fase in HubSpot (hoofdletters maken niet uit). Bij Send Sales Order is dit de fase waarin APIcenter de deal aanmaakt; standaard closedwon. Dit is verplicht. Bij een bestaande deal werkt APIcenter de fase bij, als Update order aan staat. Bij Get Sales Order werkt APIcenter de opgehaalde deals na het ophalen bij naar deze fase; laat je het veld leeg, dan wordt er niets bijgewerkt. Zo kun je opgehaalde deals een andere fase geven, zodat ze niet opnieuw voldoen aan het filter op dealfase.
Set the Pipeline where we create the deal
Order SettingsDe pipeline voor deals, als naam of ID van de pipeline in HubSpot (hoofdletters maken niet uit). Bij Send Sales Order is dit de pipeline waarin APIcenter de deal aanmaakt en waarin het zoekt naar een bestaande deal; standaard default. Dit is verplicht. Bij Get Sales Order werkt APIcenter de opgehaalde deals na het ophalen bij naar deze pipeline en de bijbehorende dealfase; laat je de velden leeg, dan wordt er niets bijgewerkt. Vul pipeline en fase altijd samen in.
Set the flag indicating the confirmation email has been sent
Order SettingsDeze instelling heeft geen effect voor HubSpot. De HubSpot-koppeling stuurt geen bevestigingsmail en kent geen vlag hiervoor. Laat hem op de standaardwaarde staan.
Update order
Order SettingsBepaalt wat er gebeurt als APIcenter de deal al in de pipeline vindt. Is Deal properties to find an existing deal leeg, dan zoekt het de dealnaam, het ordernummer. Vul je eigenschapsnamen in, dan probeert het die HubSpot-eigenschappen in die volgorde en stopt bij de eerste match. Elke controle gebruikt de dealnaam als waarde. Staat dit uit, dan stuurt APIcenter de order niet opnieuw en meldt de flow dat de deal al bestaat. Staat dit aan (standaard), dan werkt APIcenter de deal bij als de dealfase in HubSpot afwijkt van de fase die je hebt ingesteld: de orderregels van de deal worden gearchiveerd en opnieuw aangemaakt, en de dealgegevens worden bijgewerkt. Heeft de bestaande deal dezelfde fase, dan meldt de flow dat de deal al bestaat. De klant en de contacten worden bij een update niet opnieuw verwerkt.
Create missing properties in the target system
Product SettingsBepaalt 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.
Skip negativity flip process
Product SettingsStandaard zet APIcenter negatieve bedragen bij prijzen, kortingen en belasting om naar positieve bedragen. Bedragen inclusief en exclusief belasting worden dan ook omgewisseld als de belasting negatief is. Zet je deze instelling aan, dan slaat APIcenter deze omzetting over en blijven negatieve waarden negatief. De standaardwaarde is uit.
Maximum number of pages to retrieve
Run behaviourDeze 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.
Use page size
Run behaviourDeze 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.
Enable the use of a default shipping method
Shipment SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De data die APIcenter voor een order naar HubSpot stuurt, heeft geen veld voor de verzendmethode. Je hebt hem alleen nodig als je verzendmethode zelf koppelt aan een HubSpot-eigenschap in de Data mapping van de flow. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.
Force the use of the default shipping method
Shipment SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen verzendmethode meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je verzendmethode zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Use a mapping table to map shipping methods
Shipment SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen verzendmethode mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je verzendmethode zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Value to use as the default shipping method id
Shipment SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen verzendmethode mee. De waarde wordt alleen gebruikt als Enable the use of a default shipping method aan staat en je verzendmethode zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
What to do with a value that cannot be mapped using the mapping table
Shipment SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De data die APIcenter voor een order naar HubSpot stuurt, heeft geen veld voor de verzendmethode. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor verzendmethodes zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
Enable the use of a default warehouse
Stock & Warehouse SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De HubSpot-flows gebruiken geen magazijn en de standaard data mapping stuurt er geen mee. Je hebt hem alleen nodig als je magazijn zelf koppelt aan een HubSpot-eigenschap in de Data mapping van de flow. Laat hem uit staan (standaard): staat hij aan zonder waarde, dan stopt de flow met een foutmelding.
Force the usage of the default warehouse
Stock & Warehouse SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, omdat de standaard data mapping geen magazijn meestuurt en er dus niets te forceren valt. Hij is alleen van belang als je magazijn zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Use warehouse mapping table
Stock & Warehouse SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen magazijn mee, dus er valt niets te mappen. Je hebt de mappingtabel alleen nodig als je magazijn zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Value for the default warehouse id
Stock & Warehouse SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping stuurt geen magazijn mee. De waarde wordt alleen gebruikt als Enable the use of a default warehouse aan staat en je magazijn zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat het veld leeg.
What to do with a value that cannot be mapped using the mapping table
Stock & Warehouse SettingsDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De HubSpot-flows gebruiken geen magazijn. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor magazijnen zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.
Enable the use of a default tax id
Tax & Tax RatesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt het btw-bedrag (tax) mee en geen btw-code of btw-klasse. Het btw-bedrag wordt berekend uit de bedragen in de data of, als het tarief daar niet in staat, uit Default tax rate prices. Laat deze instelling uit staan (standaard): staat hij aan zonder waarde bij Value for the default tax id (exclude '%'), dan stopt de flow met een foutmelding.
Force the use of the default tax id
Tax & Tax RatesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt het btw-bedrag (tax) mee en geen btw-code of btw-klasse. Laat deze instelling uit staan (standaard).
Use default tax id mapping table
Tax & Tax RatesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect, dus er valt niets te mappen. De standaard data mapping naar HubSpot stuurt het btw-bedrag (tax) mee en geen btw-code of btw-klasse. Je hebt de mappingtabel alleen nodig als je een btw-klasse zelf koppelt aan een HubSpot-eigenschap in de Data mapping. Laat hem uit staan (standaard).
Value for the default tax id (exclude '%')
Tax & Tax RatesDeze instelling heeft in de standaard data mapping naar HubSpot geen effect. De standaard data mapping naar HubSpot stuurt het btw-bedrag (tax) mee en geen btw-code of btw-klasse. Je hebt dit veld alleen nodig als je een btw-klasse 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 standaard data mapping naar HubSpot stuurt het btw-bedrag (tax) mee en geen btw-code of btw-klasse. Hij bepaalt alleen wat er gebeurt als je de mappingtabel voor btw-klassen zelf gebruikt: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken geeft de oorspronkelijke waarde door en Waarde negeren laat het veld leeg.