NKS Reservation

Kadeřnice, která během střihu bere telefon a hledá v sešitě volnou hodinu, přichází o čas i o klienty, kteří se nedovolali. Autoservis řeší totéž s jiným nářadím: zákazník chce na geometrii, mechanik je pod autem a termín se domlouvá na třetí pokus. NKS Reservation je rezervační systém, ve kterém si zákazník sám vybere službu, den a čas a provozovna dostane hotovou rezervaci. Jedna instalace obslouží víc provozoven a každá má vlastní stránku se službami.

Proč nestačí formulář nebo sdílený kalendář

Kontaktní formulář s polem „preferovaný termín“ přesune telefonát jen do e-mailu: provozovna stejně musí odpovědět, jestli čas sedí. Sdílený kalendář ukáže obsazené hodiny, ale neví, že barvení trvá dvě hodiny a pánský střih půl hodiny, ani že v neděli je zavřeno. NKS Reservation počítá volné časy z délky služby a otevírací doby, takže zákazník vidí jen termíny, do kterých se služba opravdu vejde.

Co z toho má provozovna a zákazník

• Každá služba má délku, cenu a případně zálohu. Zákazník je vidí dřív, než začne vybírat termín.
• Kalendář škrtne dny, kdy se nepracuje. V ukázkovém salonu jsou přeškrtnuté neděle i státní svátek 17. listopadu.
• Volné časy se nabízejí po čtvrthodinách a vybraný termín se hned potvrdí nad formulářem.
• Formulář chce jen jméno a e-mail, telefon a poznámka jsou nepovinné. Je v něm pole pro slevový kód, který se ověří ještě před odesláním.
• Služba může vyžadovat zálohu. Widget pak ukáže platbu online nebo QR kód pro platbu převodem.
• Provozovna si může nastavit, že rezervaci nejdřív schvaluje. Zákazník pak uvidí, že rezervace čeká na schválení a potvrzení mu přijde e-mailem.
• Termín si zákazník uloží do kalendáře a před návštěvou mu přijde připomínka SMS zprávou.
• Rozhraní mluví česky, slovensky, anglicky, německy a polsky. Jazyk se přepíná v hlavičce.

Jak to funguje

Systém je napsaný v PHP nad frameworkem Nette, veřejná část je v TypeScriptu sestaveném přes Vite. Na adrese reservation.nks-hub.cz je rozcestník provozoven. Každá provozovna má vlastní adresu se seznamem služeb a každá služba vlastní stránku s kalendářem. Model počítá se zdroji, které mají kapacitu: zdrojem může být kadeřnické křeslo, masážní lehátko nebo zvedák v dílně.

Rezervaci jde vložit i do cizího webu. Widget je jeden skript, který se na stránku přidá s klíčem provozovny a názvem služby. Vykresluje se do vlastního stínového stromu stránky (Shadow DOM), takže styly hostitelského webu mu nerozbijí vzhled a jeho styly nezasahují do webu. Kalendář, volné časy, slevový kód i QR kód pro zálohu jsou součástí toho jednoho skriptu.

Pro napojení na jiné systémy má NKS Reservation REST API. Volání se ověřují klíčem v hlavičce X-Api-Key a popis rozhraní ve formátu OpenAPI je veřejně na /api/v1/openapi. API pokrývá volné dny a časy, založení, potvrzení, zrušení a přesunutí rezervace, potvrzení platby, zákazníky, služby, zdroje, ověření slevového kódu, čekací listinu, přehled pro statistiky a správu klíčů. Webhooky posílají události o rezervacích do dalších systémů, třeba do aplikace, ve které provozovna vede zakázky.

Typická nasazení

• Kadeřnictví nebo kosmetika s několika službami různé délky, kde záloha u delších služeb chrání před tím, že zákazník na termín bez omluvy nepřijde.
• Masážní studio s procedurami různé délky, kde se termíny skládají podle volných lehátek.
• Autoservis: ukázková provozovna má geometrii kol na 60 minut, opravu na 120 minut a servisní prohlídku na 90 minut se zálohou.
• Firma s vlastním webem nebo aplikací, která chce rezervace u sebe a NKS Reservation používá jen přes widget nebo API.

Data zákazníků

Zákazník při rezervaci vyplní jméno a e-mail, telefon jen když chce. Bez klíče API nic nevydá: dotaz na rezervace, služby i zákazníky skončí odpovědí 401 „Missing API key“. Klíče se spravují přes API a jdou upravit i smazat, takže klíč, který unikl, se dá zneplatnit.

Stav projektu

NKS Reservation běží od roku 2026. Na reservation.nks-hub.cz jsou ukázkové provozovny: kadeřnický salon, masážní studio a autoservis. Rezervace si tam jde proklikat až k formuláři, odeslání je ale závazné, takže ho pro zkoušku nepoužívejte. OpenAPI zatím vyjmenovává cesty a jejich parametry, schémata odpovědí v něm chybí.

Jak začít

• Ukázka: reservation.nks-hub.cz
• Ukázkový salon: reservation.nks-hub.cz/salon
• Popis API: reservation.nks-hub.cz/api/v1/openapi

Zdrojový kód

NKS Reservation je náš vlastní produkt a jeho kód není veřejný. Zájem o nasazení pro vaši provozovnu nebo napojení na váš systém? Napište na dev@nks-hub.cz nebo přes poptávku.