Alles over King
King: Klanten naar King sturen
Stuur klanten uit je webshop of CRM naar King. APIcenter maakt nieuwe klanten aan of werkt bestaande bij, met contactpersonen en verzendadressen.
Bijgewerkt op 9 november 2026
Deze flow stuurt klanten uit een andere applicatie, zoals een webshop of CRM, naar King. APIcenter maakt ze aan als debiteur in King, of werkt ze bij als ze al bestaan. Contactpersonen en verzendadressen gaan mee.
Zo werkt het
- Elke klant heeft een e-mailadres nodig. Zonder e-mailadres mislukt de klant. Heeft een contactpersoon geen e-mailadres, dan mislukt de klant ook.
- APIcenter zoekt de klant in King op het debiteurnummer of het e-mailadres. Is de klant een bedrijf en vindt APIcenter niets, dan zoekt APIcenter ook op het e-mailadres van de contactpersonen in King, en daarna op het KvK-nummer.
- Wordt de klant niet gevonden? Dan maakt APIcenter hem aan. Heeft de klant geen zoekcode, dan maakt APIcenter er een van de eerste 10 letters van naam 1 en naam 2, in hoofdletters. APIcenter maakt ook het verzendadres aan, als dat in de gegevens zit.
- Wordt de klant wel gevonden? Dan werkt APIcenter hem bij, maar alleen als Update existing customer accounts aanstaat. Staat de instelling uit, dan slaat APIcenter de klant over en staat dat in het resultaat van de flow. De naam van de klant wordt alleen bijgewerkt als Update name of existing customer accounts aanstaat. Voor het factuuradres en het verzendadres gelden de instellingen Update billing address of existing customer accounts en Update shipping address of existing customer accounts.
- Heeft de klant een bedrijfsnaam, dan wordt het bedrijf de debiteur in King. De naam van de klant zelf wordt dan een contactpersoon van dat bedrijf.
- Contactpersonen zoekt APIcenter in King op e-mailadres. Een nieuwe contactpersoon wordt aangemaakt. Een bestaande wordt alleen bijgewerkt als Update existing contacts aanstaat, en de naam alleen als Update name of existing contacts aanstaat.
- Een verzendadres zoekt APIcenter bij de klant op e-mailadres. Is er een adres met dezelfde straat, huisnummer, postcode, plaats en land, dan werkt APIcenter dat adres bij. Anders maakt APIcenter een nieuw adres aan.
Wat de data mapping omvat
Standaard stuurt APIcenter de voornaam en achternaam, het e-mailadres, de telefoonnummers, het faxnummer, het KvK-nummer, het btw-nummer, de website, het factuuradres, het verzendadres en de contactpersonen met hun verzendadres mee. Andere velden, zoals de bedrijfsnaam en de zoekcode, zijn beschikbaar onder Data mapping. Zie Data mapping.
Wat je eerst nodig hebt
- King is gekoppeld. Zie King koppelen aan APIcenter.
- De andere applicatie van de integratie kan klanten versturen, met minimaal een e-mailadres.
Tips
- Wordt een bestaande klant niet bijgewerkt? Controleer de instellingen voor bijwerken in de verbindings- en integratie-instellingen.
- Stuur je ook orders naar King? De orderflow maakt de klant zelf aan of werkt hem bij, op dezelfde manier als deze flow. Zie Verkooporders naar King sturen.
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 customer gender
Customer SettingsHier vul je het geslacht in dat APIcenter gebruikt als de gegevens van de bronapplicatie geen geslacht bevatten. De waarde wordt alleen gebruikt als Enable use of a default customer gender aanstaat. Is die instelling aan terwijl hier niets is ingevuld, dan geeft APIcenter een melding.
Enable use of a default customer gender
Customer SettingsMet deze instelling gebruikt APIcenter een standaardgeslacht voor de klant. Vul het geslacht in bij Default customer gender. Met Force the use of the default customer gender bepaal je of het standaardgeslacht altijd geldt of alleen als de bron geen geslacht geeft. Standaard staat deze instelling uit.
Force the use of the default customer gender
Customer SettingsMet deze instelling gebruikt APIcenter altijd het standaardgeslacht, ook als de gegevens van de bronapplicatie zelf een geslacht bevatten. Staat de instelling uit, dan geldt het standaardgeslacht alleen als er geen geslacht is. Dit werkt alleen als Enable use of a default customer gender aanstaat. Standaard staat deze instelling uit.
Use a mapping table to map the customer gender
Customer SettingsBepaalt of een koppeltabel wordt gebruikt om het geslacht van de klant om te zetten tussen het bronsysteem en het doelsysteem. Standaard staat de instelling uit. Vul de koppeltabel in als je deze instelling aanzet.
What to do with a value that cannot be mapped using the mapping table
Customer SettingsBepaalt wat er gebeurt met een waarde die niet in de koppeltabel staat. Je kiest uit Waarde negeren, Waarde gebruiken en Standaardwaarde gebruiken. Standaard is Standaardwaarde gebruiken gekozen. De instelling werkt alleen als Use a mapping table to map the customer gender aanstaat.
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.
Hier kies je wat er gebeurt met een waarde die niet in de koppeltabel van Use a mapping table to map the payment journal staat. Bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Waarde negeren wordt de waarde weggelaten. Bij Standaardwaarde gebruiken wordt de standaardwaarde gebruikt die je hebt ingesteld. De standaardwaarde is Standaardwaarde gebruiken.
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.