Guestplan koppelen en de restaurantnummers invullen

De kaart Guestplan op het tabblad Koppelingen: de schakelaar, de server, de API-sleutel en de restaurantnummers per vestiging — die sinds 27 augustus 2026 gewoon op het scherm staan.

Wanneer gebruik je dit

Draai je met Guestplan, dan haalt Morris daar reserveringen op en boekt er zelf in — vanuit de reserveringskaart in de mail en vanaf de telefoon. Dat werkt pas als deze kaart klopt: een sleutel én het juiste restaurantnummer per vestiging.

Waar het staat

Ga naar Instellingen en kies links, onder Systeem, het tabblad Koppelingen. Onderaan staat de kaart Guestplan, met rechtsboven een chip Actief of Uit.

De kaart hoort bij de vestiging die bovenin gekozen is. Wissel je van vestiging, dan bewerk je een andere koppeling.

De velden

Koppeling actief — de schakelaar die de koppeling aan- of uitzet, per vestiging. Uit betekent: geen verkeer meer met Guestplan voor deze vestiging.

Server — het adres van de Guestplan-koppeling, bijvoorbeeld https://www.guestplan.com/api.

API-sleutel — je sleutel van Guestplan. Onder het veld staat wat er nu opgeslagen is: *** als er een sleutel ligt, anders Nog niet ingesteld. De sleutel zelf komt nooit terug op het scherm. Laat je het veld leeg bij het opslaan, dan blijft de bestaande sleutel staan; wil je hem vervangen, typ dan de nieuwe.

Restaurantnummers

Onder de sleutel staat de groep Restaurantnummers. Die velden zijn nieuw sinds 27 augustus 2026 — daarvóór verwachtte de opslag deze nummers wel, maar had de kaart er geen veld voor en kon je ze alleen rechtstreeks in de database zetten.

• Standaardnummer — Het nummer dat jouw restaurant in Guestplan heeft. Reserveringen zonder herkenbare vestiging komen op dit nummer binnen. Je vindt het in Guestplan zelf, bij de instellingen van het restaurant.
• Per vestiging een veld — onder het standaardnummer staat elke vestiging van je zaak met een eigen nummerveld. Laat leeg als deze vestiging het standaardnummer gebruikt.

Morris kiest bij elke opdracht in deze volgorde: eerst het nummer dat bij de vestiging staat, dan — als de filiaalnaam zelf een getal is — dat getal, en anders het standaardnummer. Levert dat niets op, dan slaat Morris het ophalen bij Guestplan voor die vestiging over en zet er de waarschuwing guestplan_branch_not_mapped bij.

Klik onderaan op Opslaan.

De verbinding testen

De knop Verbinding testen haalt de restaurantlijst bij Guestplan op. De uitkomst komt als melding bovenin te staan, in ruwe systeemtaal, bijvoorbeeld:

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

Lees hem zo: ok staat op true bij een geslaagd antwoord (200) en op false zodra Guestplan iets anders teruggeeft, ook een geweigerde sleutel. status is de antwoordcode van Guestplan zelf, en restaurants het aantal restaurants dat je sleutel mag zien. Staat daar 0 terwijl je er meer verwacht, dan klopt de sleutel wel maar geeft hij geen toegang tot jouw restaurants.

Let op

• Testen kan alleen na opslaan. Een koppeling die nog nooit is opgeslagen geeft integration_not_configured; ontbreekt de server of de sleutel, dan guestplan_missing_base_or_key.
• Een leeggemaakt nummerveld wist de toewijzing echt. De kaart stuurt de velden altijd mee, dus leeg is leeg. Dat is met opzet: anders kon je een verkeerd nummer nooit meer weghalen. Ouder opgeslagen nummers die je niet op het scherm ziet, blijven wel staan.
• Hoofdletters maken niet uit. De opgeslagen rijen staan met kleine letters; Morris leest en schrijft ongeacht de schrijfwijze en schrijft terug naar de rij die er al is, zodat er geen tweede, lege koppeling ontstaat.
• Zet de vestigingen eerst neer. De nummervelden verschijnen per vestiging uit de vestigingenlijst; die volgt uit de bedrijfsgegevens en de personeelsdossiers.
• Welk reserveringssysteem de mailmodule gebruikt, stel je apart in bij Reserveringssysteem kiezen. Guestplan koppelen zet dat niet vanzelf om.
• De kaarten DocuSeal, Nmbrs en Nmbrs-code inwisselen op hetzelfde tabblad horen bij het personeel; zie De kaarten DocuSeal en Nmbrs bij Koppelingen.

Bijgewerkt op 28 augustus 2026