De testknoppen gebruiken

Testmail versturen bij de systeemmail en Verbinding testen bij een koppeling: wat ze werkelijk controleren, en hoe je de uitkomst leest.

Wanneer gebruik je dit

Je hebt net gegevens van een mailserver of van een externe dienst ingevuld en wilt weten of ze kloppen, zonder te wachten tot er iets echts misgaat. Op twee plekken staat daar een knop voor.

Testmail versturen

De knop staat onderaan het blok Systeemmail, op het tabblad Bedrijfsgegevens.

1. Sla eerst de gegevens op en wacht op de herstart. De test kijkt naar de gegevens waarmee de server op dat moment draait, niet naar wat er in het formulier staat.
2. Klik op Testmail versturen.
3. Lees de melding bovenaan de pagina.

De knop maakt verbinding met de mailserver en probeert in te loggen. Er gaat geen mail de deur uit — er belandt dus ook niets in een mailbox of in de testbak.

Mislukt het, dan staat de reden in de melding: SMTP test mislukt: …, met daarin de server, de poort en wat de mailserver terugzei. Is er nog helemaal geen server ingesteld, dan zegt de melding dat de gegevens ontbreken en eerst opgeslagen moeten worden. Staat de omgeving in de proefstand, dan staat dat er als aantekening bij.

Meer over de velden zelf staat in De systeemmail instellen en testen.

Verbinding testen bij een koppeling

Op het tabblad Koppelingen staat bij Guestplan, DocuSeal en de loonadministratie een knop Verbinding testen naast Opslaan.

1. Sla de kaart eerst op. Een koppeling die nog nooit is opgeslagen kan niet getest worden.
2. Klik op Verbinding testen.
3. Lees de melding bovenaan de pagina.

Wat de test doet, verschilt per dienst. Bij Guestplan haalt hij de restaurantlijst op en meldt de status en het aantal gevonden restaurants. Bij de handtekeningdienst vraagt hij de sjablonenlijst op. Bij de loonadministratie probeert hij vijf verschillende adressen met zes soorten inlogkoppen, tot er iets anders terugkomt dan "niet gevonden" — die dienst is per klant anders ingericht.

De uitkomst lezen

De melding van Verbinding testen is rauwe systeemtekst, geen nette zin. Je krijgt bijvoorbeeld:

Test guestplan: {"provider":"guestplan","ok":true,"status":200,"restaurants":3}

Zo lees je dat:

• ok — betrouwbaar: dit staat alleen op true bij een antwoordcode tussen de 200 en 299. Een geweigerde sleutel of een fout adres levert dus ook echt ok: false op, niet alleen een op te zoeken statuscode.
• status — de antwoordcode zelf. 200 is goed; 401 of 403 betekent dat je sleutel geweigerd wordt; 404 dat het serveradres niet klopt.
• restaurants — bij Guestplan het aantal restaurants dat de dienst teruggaf. Staat daar 0, dan is de verbinding er wel maar levert hij niets op.

Als de test niet eens op gang komt

Gaat het mis vóór het contact met de dienst — bijvoorbeeld omdat de koppeling nog nooit is opgeslagen — dan krijg je geen kale foutpagina meer, maar een nette melding bovenin: Test <koppeling> mislukt: …, met de technische naam erachter. De namen die je kunt tegenkomen:

• integration_not_configured — deze koppeling is voor deze vestiging nog nooit opgeslagen. Sla de kaart eerst op.
• guestplan_missing_base_or_key, docuseal_missing_base_or_key, nmbrs_missing_base_or_key — het serveradres of de sleutel is leeg.
• internal_error — de dienst was helemaal niet te bereiken, bijvoorbeeld door een verkeerd serveradres.

Er is niets veranderd aan je gegevens; je kunt gewoon opnieuw testen nadat je het probleem hebt verholpen.

Let op

• De melding van de testmail-knop noemt zelf dat er niets verstuurd is. Bij een geslaagde controle staat er Verbinding met … geslaagd … Er is geen testmail verstuurd. Ga na een geslaagde test dus niet in je mailbox zoeken.
• Een geslaagde test zegt niets over de proefstand. Of post ook echt naar buiten gaat, hangt af van de mailstand; zie Proefstand en live.
• De testknoppen testen wat is opgeslagen, niet wat je ziet. Wijzig je iets, sla dan eerst op.
• Een test verandert niets. Je kunt hem zo vaak herhalen als je wilt.

Bijgewerkt op 28 augustus 2026