HubSpot: veelvoorkomende fouten

Deze pagina beschrijft de fouten die APIcenter bij HubSpot kan melden, met de oorzaak en de oplossing. Je ziet de melding in de activiteit van de flow. De meldingen van APIcenter zijn in het Engels. Zoek op de tekst van de melding, die hieronder tussen aanhalingstekens staat. De namen in de melding, zoals de naam van een deal of eigenschap, zijn bij jou anders.

Gaat het om de verbinding zelf, een flow die niet draait, of records die opnieuw worden geprobeerd? Lees dan Verbinding mislukt, Flow draait niet en Records die mislukken.

Validation of required fields failed

Melding: Validation of required fields failed en Field Validation Failed. De melding noemt de velden die ontbreken.

Oorzaak: de data van de flow mist een verplicht veld.

• Bij Verkooporders naar HubSpot sturen is dealname verplicht. Dat is het ordernummer.
• Bij Betalingen naar HubSpot sturen zijn pipeline, dealstage en dealname verplicht.

Oplossing:

1. Open de melding en lees welke velden ontbreken.
2. Controleer onder Data mapping van de flow of die velden zijn gekoppeld.
3. Controleer in het bronsysteem of de order of betaling een waarde heeft voor die velden, zoals een ordernummer.
4. Voer de flow opnieuw uit.

Pipeline of fase niet ingesteld

Melding: No Pipeline set for Deal!, No Pipeline set for Company!, No Pipeline set for Contact! of No Pipeline Stage set for ....

Oorzaak: in de instellingen van de flow staat geen pipeline of geen fase. Zonder pipeline en fase kan APIcenter geen deal, bedrijf of contact aanmaken. Dat geldt alleen voor flows die gegevens naar HubSpot sturen.

Oplossing:

1. Ga naar het tabblad Instellingen van de flow en open de categorie die in de melding staat.
2. Vul bij een deal de pipeline in bij Set the Pipeline to update the deal towards en de fase bij Set the dealstage to update the deal towards.
3. Vul bij een bedrijf of contact de pipeline en de lifecycle stage in. Zie Klanten naar HubSpot sturen. Verwerk je alleen contacten, zet dan Only process contact information aan: dan is de pipeline voor bedrijven niet nodig.
4. Gebruik de naam of het ID van de pipeline en de fase, precies zoals ze in HubSpot staan.

Pipeline niet gevonden

Melding: Pipeline set for deal not found!. Het woord deal kan ook company of contact zijn.

Oorzaak: APIcenter zoekt in HubSpot een pipeline met de naam of het ID uit de instelling en vindt die niet. Hoofdletters maken niet uit. Een spelfout of een pipeline die je hebt hernoemd of verwijderd, geeft dezelfde melding.

Oplossing:

1. Controleer in HubSpot de naam en het ID van de pipeline.
2. Pas de instelling van de pipeline in de flow aan, zodat die precies overeenkomt.
3. Is de pipeline-instelling optioneel en heb je die niet nodig? Maak de instelling dan leeg.

Fase niet gevonden

Melding: Stage '...' not found in pipeline!.

Oorzaak: de fase uit de instelling bestaat niet in de pipeline die APIcenter gebruikt. Vaak hoort de fase bij een andere pipeline.

Oplossing:

1. Controleer in HubSpot of de fase bestaat in de pipeline uit de instelling. Je kunt de naam of het ID gebruiken.
2. Pas de fase of de pipeline in de instellingen aan, zodat ze bij elkaar horen.

Fase staat in meer dan één pipeline

Melding: Stage '...' found in multiple pipelines!.

Oorzaak: je hebt een fase ingevuld, maar geen pipeline, en de fase komt in meer dan één pipeline voor. APIcenter weet dan niet welke pipeline het moet gebruiken.

Oplossing: vul ook de pipeline in, of kies een fase die maar in één pipeline voorkomt.

Deal bestaat al

Melding: The deal with deal name: '...' was found!.

Oorzaak: bij Verkooporders naar HubSpot sturen bestaat er in de pipeline al een deal met hetzelfde ordernummer als naam. APIcenter maakt de deal dan niet nog een keer aan. Dit gebeurt als Update order uit staat. Het gebeurt ook als Update order aan staat en de bestaande deal al in de ingestelde dealfase staat.

Oplossing:

• Is de order al eerder verstuurd? Dan hoef je niets te doen. De deal staat al in HubSpot.
• Wil je dat APIcenter een bestaande deal bijwerkt? Zet Update order aan en controleer de dealfase. APIcenter werkt de deal alleen bij als de fase in HubSpot afwijkt van de ingestelde fase.
• Hebben twee orders uit verschillende bronnen hetzelfde nummer? Maak de dealnamen uniek met een voorvoegsel of achtervoegsel, zie Verkooporders naar HubSpot sturen.

Deal of factuur niet gevonden bij een betaling

Melding: Deal '...' cannot be found! of Invoice '...' cannot be found!.

Oorzaak: Betalingen naar HubSpot sturen zet betaalgegevens op een bestaande deal of factuur en maakt er zelf geen aan. APIcenter vindt het object niet. Een deal wordt gezocht op pipeline, dealfase en dealnaam, een factuur op het factuurnummer. De deal kan nog niet bestaan, of de pipeline of fase in de data klopt niet. Volgens HubSpot kan het ook even duren voordat een nieuw record in zoekresultaten verschijnt.

Oplossing:

1. Controleer of de deal of factuur in HubSpot bestaat, bijvoorbeeld doordat de order eerst is verstuurd.
2. Controleer of pipeline en dealstage in de data de interne ID's zijn, zoals default en closedwon, en niet de labels. Controleer ook of de deal nog in die fase staat.
3. Heb je de deal net aangemaakt? Wacht even en voer de betaling opnieuw uit.

Eigenschap bestaat niet

Melding: Property: '...' does not exist!.

Oorzaak: een eigenschap, optie of eigenschapsgroep die APIcenter nodig heeft, bestaat niet in HubSpot. De naam in de melding is dan de naam van de eigenschap, of bij een kenmerk van een product de waarde die als optie ontbreekt. Bijvoorbeeld de bedrijfseigenschap voor het e-mailadres (standaard company_email), een eigenschap voor een kenmerk van een product, of een eigenschap voor het hoofdproduct bij varianten. De instelling Create missing properties in the target system staat uit. Dat is de standaard.

Oplossing, kies een van de twee:

• Maak de eigenschap zelf aan in HubSpot. Ga naar het instellingen-icoon, kies Properties en kies het objecttype. Klik daarna op Create property. Zie Create and edit properties. Controleer dat de naam overeenkomt met de naam in de melding.
• Zet Create missing properties in the target system aan, zodat APIcenter de eigenschap zelf aanmaakt. Je gebruiker in HubSpot heeft dan het recht Edit property settings nodig.

Optie kan niet worden aangemaakt

Melding: Cannot create attribute option: '...'!.

Oorzaak: de eigenschap in HubSpot bestaat, maar de waarde die APIcenter verstuurt is nog geen optie van die eigenschap. APIcenter wil de optie toevoegen, maar dat lukt niet omdat de eigenschap dat niet toelaat. Volgens HubSpot kun je sommige eigenschappen niet aanpassen, zoals bepaalde standaardeigenschappen.

Oplossing: voeg de optie zelf toe aan de eigenschap in HubSpot, of pas de waarde aan in het bronsysteem of in de data mapping. Voer de flow daarna opnieuw uit. Zie Create and edit properties.

E-mailadres van het bedrijf ontbreekt

Melding: No email field set for company email!, Email field set for company email not found! of Email field set for company email is empty!.

Oorzaak: APIcenter gebruikt het e-mailadres van het bedrijf om bedrijven en contacten te herkennen. Er is dan iets mis met de instelling Property to use as company email of met de data:

• De instelling is leeg.
• De eigenschap uit de instelling komt niet voor in de data van de order of klant. Dan stuurt de data mapping het e-mailadres niet naar die eigenschap.
• De eigenschap is wel aanwezig, maar heeft geen waarde. Het bronsysteem stuurt dan geen e-mailadres mee.

Oplossing:

1. Vul bij Property to use as company email de eigenschap in waarin het e-mailadres van het bedrijf staat. De standaardwaarde is company_email.
2. Controleer onder Data mapping dat het e-mailadres van de klant naar dezelfde eigenschap gaat.
3. Stuurt het bronsysteem soms geen e-mailadres mee? Gebruik dan een standaardklant met een e-mailadres, zie Verkooporders naar HubSpot sturen.

Associatietype niet gevonden

Melding: Failed to find association type!.

Oorzaak: APIcenter koppelt contacten, bedrijven, deals en orderregels aan elkaar met een associatietype. Het type uit de instelling bestaat niet in HubSpot. Meestal staat er een tikfout in de instelling of de waarde heeft een verkeerde vorm.

Oplossing:

1. Open de instellingen van de flow en zoek de associatietypes, bijvoorbeeld contact naar bedrijf.
2. Schrijf het type in de vorm die in de instelling staat, bijvoorbeeld Contacts-to-Companies: eerst het objecttype, dan -to-, dan het andere objecttype.
3. Laat je de instelling leeg, dan gebruikt APIcenter het standaardtype tussen de twee objecten.
4. Heb je eigen associatielabels in HubSpot gemaakt? Controleer dan of het type met die naam bestaat in HubSpot.

Contact kan niet worden bijgewerkt

Melding: Error trying to update contact for customer: '...'!. Achter de dubbele punt staat het e-mailadres van de klant.

Oorzaak: HubSpot heeft de update van het contact niet geaccepteerd. Een bekende oorzaak is de lifecycle stage. Volgens HubSpot kun je die alleen vooruit zetten. Een eerdere fase zetten werkt pas als de huidige waarde eerst leeg is. Een andere oorzaak is een waarde die HubSpot niet accepteert voor een eigenschap.

Oplossing:

1. Open de melding en lees wat HubSpot terugmeldt.
2. Gaat het om de lifecycle stage? Zet de fase in HubSpot zelf eerst terug, of laat APIcenter de pipeline en fase van bestaande contacten niet bijwerken met Update pipeline & stage on existing contacts.
3. Controleer onder Data mapping of de waarden die je stuurt, zoals een optie of een landnaam, bestaan in HubSpot.
4. Voer de flow opnieuw uit.

HubSpot meldt te veel verzoeken

Melding: een foutmelding van HubSpot over een limiet, of de HTTP-status 429.

Oorzaak: APIcenter stuurt in korte tijd meer verzoeken dan HubSpot toestaat. HubSpot beperkt het aantal verzoeken per 10 seconden en per dag. Voor het zoeken geldt een strengere limiet. De limieten hangen af van je HubSpot-abonnement en van hoe de app is geïnstalleerd. Daarna geeft HubSpot de foutmelding voor alle volgende verzoeken. De dagelijkse limiet wordt om middernacht (in jouw tijdzone) weer ingesteld.

Oplossing:

1. Verlaag bij flows die gegevens ophalen het aantal records per run met Amount to process.
2. Draaien er meer flows of andere apps tegelijk op hetzelfde HubSpot-account? Spreid ze dan over de dag.
3. Wacht tot de limiet voorbij is. Daarna probeert APIcenter mislukte records opnieuw, zie Records die mislukken.
4. Blijft de melding terugkomen? Bekijk in HubSpot het gebruik van de API. Zie API usage guidelines and limits.

Geen toegang of rechten ontbreken

Melding: een foutmelding van HubSpot over toegang of rechten, of de HTTP-status 401 of 403.

Oorzaak: de autorisatie is verlopen of ingetrokken, of de toegang die je aan APIcenter hebt gegeven, mist een recht dat de flow nodig heeft. Volgens HubSpot ontbreekt bij een melding over integratierechten vaak het recht Edit property settings.

Oplossing:

1. Test de verbinding en autoriseer opnieuw als dat nodig is. Zie Verbinding mislukt en HubSpot koppelen aan APIcenter.
2. Laat een Super Admin in HubSpot de toegang goedkeuren, of de rechten van de gebruiker aanpassen. Zie Foutmelding over integratierechten oplossen.

Meer informatie van HubSpot

• API usage guidelines and limits
• Create and edit properties
• Foutmelding over integratierechten oplossen