Alles over 5 Sterren Specialist
5 Sterren Specialist: Verkooporders naar 5 Sterren Specialist sturen
Stuur orders uit je webshop naar 5 Sterren Specialist als transactie, met verplichte velden en het aantal dagen voor de verzenddatum.
Bijgewerkt op 9 november 2026
Deze flow stuurt orders uit een andere applicatie, zoals je webshop, naar 5 Sterren Specialist. Per order maakt APIcenter in 5 Sterren Specialist een transactie aan. Gebruik deze flow als je klanten na een aankoop wilt laten uitnodigen voor een review.
Wat APIcenter doet
- APIcenter controleert of de verplichte velden een waarde hebben (zie hieronder).
- APIcenter meldt zich aan bij 5 Sterren Specialist met API Username, API Password en Organisation Name. Lukt dat niet, dan mislukt de order met de melding "Authorisation request failed!".
- 5 Sterren Specialist geeft bij het aanmelden door welke extra velden het kent. Staat daar een veld bij dat verplicht is, dan controleert APIcenter dat dit veld in de gegevens van de order zit. Bekende extra velden stuurt APIcenter mee in de transactie. Andere velden stuurt APIcenter niet mee.
- APIcenter maakt de transactie aan met de code, de verzenddatum, de omschrijving, de klant, het e-mailadres, de taal, de aanhef en de achternaam, als je die hebt gekoppeld.
- Geeft 5 Sterren Specialist aan dat de transactie niet is gelukt, dan mislukt de order. De melding "Failed to create transaction for order reference" laat de terugmelding van 5 Sterren Specialist zien. Lukt het wel, dan staat in de activiteit dat de transactie is aangemaakt, met de code van de order.
Verplichte velden
Deze velden moeten een waarde hebben, anders mislukt de order met een melding over verplichte velden:
code: het ordernummer.email: het e-mailadres van de klant.customer: de naam van de klant.unitformat
Bij een standaard mapping koppelt APIcenter het ordernummer aan code, het e-mailadres van de klant aan email, de volledige naam van de klant aan customer, de klantgroep aan unit en de administratie aan format. Controleer dit onder Data mapping van de flow. Wat unit en format precies zijn bij 5 Sterren Specialist, staat niet in de code. Vraag het na bij 5 Sterren Specialist als je twijfelt welke waarde je moet sturen.
Datum van de transactie
APIcenter neemt de orderdatum en telt daar een aantal dagen bij op. Het resultaat stuurt APIcenter als verzenddatum (sendDate) mee. Het aantal dagen stel je in met Add number of days to order date. Standaard is dit 10 dagen.
Andere velden
Naast de verplichte velden stuurt APIcenter deze velden mee als ze een waarde hebben: date, description, language, gender, prefix en lastName. De standaard mapping koppelt de orderdatum, de taal en het geslacht van de klant. Andere velden van de order stuurt APIcenter niet naar 5 Sterren Specialist.
Zie bij een fout ook 5 Sterren Specialist: veelvoorkomende fouten.
Instellingen
De instellingen die je in het dashboard ziet, met wat elke instelling doet.
Enable use of a default customer group
Customer SettingsZet dit aan om een standaard klantgroep te gebruiken. Vul daarna de waarde in bij Value to use as default customer group. Zonder deze instelling gebruikt APIcenter geen standaardwaarde. Standaard staat dit uit.
Force the usage of the default customer group
Customer SettingsMet deze instelling bepaal je of de standaardwaarde de klantgroep in de gegevens vervangt. Staat dit aan, dan gebruikt APIcenter altijd de waarde uit Value to use as default customer group. Staat dit uit, dan wordt die waarde alleen gebruikt als de gegevens zelf geen klantgroep bevatten. Dit werkt alleen als Enable use of a default customer group aan staat. Standaard staat dit uit.
Use customer group mapping table
Customer SettingsBepaalt of een koppeltabel wordt gebruikt om de klantgroep om te zetten. Zonder koppeltabel wordt de waarde uit de klantgegevens doorgegeven en gebruikt als id van de klantgroep. Standaard staat de instelling uit. Vul de koppeltabel in als je deze instelling aanzet.
Value to use as default customer group
Customer SettingsVul hier de waarde in van de klantgroep, zoals het doelsysteem die herkent (meestal het id). APIcenter gebruikt deze waarde alleen als Enable use of a default customer group aan staat. Heeft de klantgroep in de gegevens al een waarde, dan blijft die staan, tenzij Force the usage of the default customer group aan staat. Er is geen standaardwaarde.
Default administration id
General flow settingHet administratienummer (de administratie-ID) dat als standaard wordt gebruikt voor de order of het record. Het wordt ingevuld als Make use of a default administration id aanstaat en de data zelf geen administratie bevat, of altijd als Force the usage of the default administration id aanstaat.
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 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.
Force the usage of the default administration id
General flow settingZet dit aan om altijd de standaardwaarde uit Default administration id te gebruiken, ook als de data zelf al een administratie bevat. Staat dit uit, dan wordt de standaardwaarde alleen gebruikt als de data geen administratie bevat. Dit werkt alleen als Make use of a default administration id aanstaat.
Make use of a default administration id
General flow settingZet dit aan om een standaard administratie-ID te gebruiken. De waarde komt uit Default administration id en wordt ingevuld als de data zelf geen administratie bevat. Standaard staat dit uit.
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.
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 number of days to order date
Order SettingsAPIcenter telt dit aantal dagen op bij de orderdatum en stuurt het resultaat als verzenddatum (sendDate) mee in de transactie naar 5 Sterren Specialist. Vul een geheel aantal dagen in. Standaard is dit 10.
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.