Integrări
Legătura cu POS-ul din local, widgetul de rezervări de pe site-ul tău și API-ul pentru cine își face propria integrare.
Ce face și ce nu face legătura cu POS-ul
#HaiLa se leagă la sistemul de casă din local, ca rezervările să stea într-un singur loc. Astăzi există legătură cu Poster și una construită pentru Syrve. Nu există alt sistem.
| Ce se întâmplă | În ce direcție |
|---|---|
| Rezervare acceptată de tine în HaiLa | Ajunge pe terminalul din local |
| Rezervare făcută la terminal | Apare în HaiLa, ca rezervare a localului |
| Planul de sală, mesele și locurile | Vin din POS în HaiLa, o dată pe zi |
| Rezervare anulată la terminal | Se anulează și în HaiLa |
| Rezervare anulată în HaiLa | Nu ajunge la terminal. O anulezi tu, de mână |
Terminalul primește rezervarea abia după ce o accepți
O cerere în așteptare nu se vede la casă. Trece acolo doar în clipa în care o confirmi. Este voit: o rezervare oglindită ține o masă ocupată în POS, iar o cerere la care nu ai răspuns încă nu are de ce să o țină. Deci nu aștepta cererile pe terminal, ele se citesc în aplicația HaiLa.
Anulările din HaiLa nu ajung la terminal
Poster nu are un mod prin care noi să anulăm o rezervare la el. Când o rezervare se anulează în HaiLa, HaiLa o arată anulată, iar terminalul rămâne cu ea. Cineva din echipă trebuie să o închidă și acolo, altfel masa rămâne ținută degeaba toată seara.
Rezervările venite de la terminal se facturează la tariful API, 0,50 € plus TVA. Nu sunt socotite rezervări introduse de echipă.
Oaspetele nu vede nimic din toate acestea. Pentru el rezervarea arată la fel, indiferent dacă localul are sau nu POS legat.
Legi Poster la HaiLa
#Cu Poster legat, echipa nu mai ține două liste de rezervări și nu mai trece nimic de mână dintr-un ecran în altul.
Legătura nu se face din dashboard. Nu există o secțiune de POS și nici un buton de conectare: legătura o facem noi. Scrie-ne la hello@haila.md, spune-ne că ai Poster, iar noi îți cerem accesul de care avem nevoie și o pornim.
Nici din aplicația Lite. Scrie-ne la hello@haila.md și o configurăm noi, de partea noastră.
Nici din aplicația Pro. Scrie-ne la hello@haila.md și o configurăm noi. La fel se face și oprirea ei.
Pentru oaspete nu se schimbă nimic: rezervă la fel ca înainte. Se schimbă doar ce vede echipa, pentru că rezervările încep să apară în amândouă sistemele.
- Cât timp legătura este pornită, planul de sală vine din Poster. Mesele pe care le-ai făcut tu în HaiLa înainte de legătură sunt scoase din uz la prima sincronizare, ca să nu se numere de două ori aceleași locuri. Nu se șterg, dar nici nu se întorc singure: dacă oprim vreodată legătura, cere-ne să ți le repunem în uz, altfel rămân deoparte.
- Sincronizarea rezervărilor merge din minut în minut în timpul serviciului și mai rar noaptea. Planul de sală se aduce o dată pe zi, la 4 și jumătate dimineața.
- Nu ai unde vedea în aplicație dacă legătura este pornită sau oprită. Niciun ecran nu o arată. Dacă nu ești sigur, întreabă-ne.
- Oprirea legăturii se cere tot de la noi. Nu există buton de deconectare nicăieri.
Sălile din Poster devin etaje în HaiLa
#Nu ai nimic de potrivit între cele două sisteme. Nu există un ecran de asociere, o listă de perechi sau un pas de confirmare: HaiLa citește sălile și mesele din Poster și le face ale ei.
- Sala din Poster
- Devine un etaj în HaiLa, cu același nume. Fiecare sală are etajul ei, pentru că mesele își au coordonatele socotite în interiorul sălii.
- Masa din Poster
- Devine o masă în HaiLa, cu același număr, aceeași capacitate, aceeași formă și cam în același loc pe hartă.
- Zona mesei
- Se ghicește din numele sălii. O sală al cărei nume seamănă a terasă intră ca terasă, restul intră ca interior.
- Masa ștearsă în Poster
- Iese din uz și în HaiLa, la următoarea aducere a planului.
Numele se schimbă în Poster, nu în HaiLa
Dacă vrei alt nume de etaj sau alt număr de masă, schimbă-l la tine în Poster. La următoarea sincronizare, a doua zi dimineața, vine încoace. Modificat în HaiLa, riști să se întoarcă la ce scrie în Poster.
Mesele făcute de tine în HaiLa sunt scoase din uz
Cât timp legătura este pornită, POS-ul ține planul. Orice masă activă care nu vine de la el este dezactivată, ca aceleași locuri să nu fie numărate de două ori la calculul disponibilității. Nu se șterge nimic, doar se scoate din uz. Dar nici nu se întoarce singură: oprirea legăturii nu reactivează nimic, deci cere-ne repunerea meselor odată cu ea.
Nimic din toate acestea nu ajunge la oaspete. El vede orele libere, nu mesele, nici etajele, nici de unde vin.
Syrve, și de ce nu există un al treilea sistem
#Legătura cu Syrve este scrisă și gata de pornit, dar nu a mers încă la niciun local. Primul care o pornește o face ca pilot, cu noi alături, pentru că prima conectare adevărată este și prima verificare adevărată.
Funcționează după același tipar ca Poster: rezervările tale confirmate ajung la sistem, rezervările făcute acolo ajung în HaiLa, iar planul de sală vine de acolo încoace.
Altceva nu există
HaiLa se leagă la Poster și la Syrve. Nu există un al treilea sistem, nici un conector general, nici un formular prin care să ceri unul. Dacă ai alt POS și ai nevoie de legătură, scrie-ne la hello@haila.md: este o discuție, nu o comandă pe care să o dai dintr-un ecran.
Ca și la Poster, pornirea și oprirea le facem noi. Nici Syrve nu se leagă din dashboard sau din aplicații.
Când POS-ul și HaiLa nu se potrivesc
#Cele mai multe nepotriviri au aceeași explicație: ceva merge într-o singură direcție. Merită verificate în ordinea de mai jos, pentru că prima este de departe cea mai deasă.
| Ce vezi | De ce |
|---|---|
| La terminal masa este ținută, în HaiLa rezervarea este anulată | Anulările din HaiLa nu ajung la POS. Închide rezervarea și la terminal. |
| O cerere se vede în HaiLa, dar nu și la casă | Cererile în așteptare nu se oglindesc. Trece la terminal după ce o accepți. |
| O masă mutată sau redenumită în HaiLa a revenit cum era | Planul vine din POS în fiecare dimineață și se scrie peste. Schimbă în POS. |
| O masă pe care ai făcut-o tu a dispărut din calcul | Legătura scoate din uz mesele care nu vin din POS, ca să nu se numere de două ori. |
| În factură sunt mai multe rezervări API decât ai avut prin widget | Rezervările venite de la terminal intră tot la tariful API. |
Rezervările nu se pierd, doar întârzie
Rezervările făcute la terminal se aduc din minut în minut în timpul serviciului și mai rar noaptea. Dacă una făcută acum treizeci de secunde nu apare încă în HaiLa, mai așteaptă un minut înainte să o scrii de mână, altfel rămâi cu ea de două ori.
Dacă nepotrivirea nu seamănă cu niciuna de mai sus, scrie-ne la hello@haila.md cu numele localului, ziua și numărul mesei. Legătura o ținem noi, deci tot noi ne uităm în ea.
Pui widgetul de rezervări pe site-ul tău
#Widgetul lasă omul să rezerve fără să iasă de pe site-ul tău, iar rezervarea costă jumătate față de una venită prin HaiLa.
- Deschide Configurare și alege Widget.
- Rămâi pe fila Embed Code. Panoul este în engleză.
- Alege cheia API la Select API Key. Dacă nu ai niciuna, scrie-ne la hello@haila.md și îți emitem una.
- Dacă apare căsuța galbenă care cere parola cheii, lipește parola primită de la noi. Fără ea, codul iese cu un text de completat în loc de parolă.
- Înainte să copiezi, citește ID-ul localului din cod și asigură-te că este al localului potrivit. Panoul nu se uită la localul pe care îl ai deschis.
- Apasă Copy Code și lipește codul în pagina site-ului tău, acolo unde vrei să apară formularul.
- Verifică rezultatul din fila Preview, cu Open Widget Only sau Open Mock Restaurant Site.
Aplicațiile de pe telefon nu au widget. Codul se ia din dashboard, de pe web, la Configurare, Widget.
Nici aplicația Pro nu are widget. Deschide dashboard-ul pe web, la Configurare, Widget.
Oaspetele care rezervă din widget alege data, ora, numărul de persoane, își lasă numele și telefonul și primește un ecran care îi spune că rezervarea este înregistrată și așteaptă confirmarea restaurantului, plus un cod de rezervare. Nu este confirmată de la sine: la tine intră ca o cerere obișnuită, în așteptare, și tu o accepți.
- O perioadă blocată nu scoate orele din widget. Ele rămân la vedere, oaspetele alege una și abia la trimitere primește o eroare, iar eroarea este cea generală, care nu îi explică nimic. Bifează Widget la perioada blocată, ca refuzul să vină măcar, dar nu te aștepta ca ora să dispară din listă.
- Codul conține datele de acces ale cheii, inclusiv parola, pentru că widgetul se autentifică din browserul vizitatorului. Folosește codul generat pentru localul tău și, dacă ai nevoie de altă cheie, cere-ne-o.
- Panoul Widget se uită la primul local legat de contul tău, nu la localul pe care îl ai deschis. Cu mai multe localuri, codul poate ieși cu ID-ul și cu cheia altuia, iar rezervările de pe site-ul unui local ajung la celălalt. Verifică ID-ul de fiecare dată, chiar dacă ai copiat codul de zece ori până acum.
- Parola cheii este ținută în formă criptată, deci dashboard-ul nu ți-o poate arăta. Este cea pe care ți-am dat-o la emitere. Dacă ai pierdut-o, scrie-ne și îți dăm alta.
- Widgetul vorbește doar română și rusă. Engleză nu are.
- O rezervare din widget costă 0,50 € plus TVA, jumătate față de una venită prin HaiLa.
- Fila Analytics numără afișările și rezervările widgetului. Este socoteala lui, nu factura ta; factura se citește la Facturare.
Potrivești widgetul cu site-ul tău
#Widgetul stă în pagina ta, deci merită potrivit cu ea atât cât se poate: limba în care vorbește și fundalul, deschis sau închis.
- Deschide Configurare, alege Widget și treci pe fila Settings.
- Alege Language, română sau rusă.
- Alege Theme, Light sau Dark, după fundalul paginii tale.
- Apasă Save Settings.
- Treci înapoi pe Embed Code, apasă Copy Code și înlocuiește codul vechi de pe site-ul tău cu cel nou.
Setările widgetului sunt doar în dashboard, la Configurare, Widget. Din aplicații nu se ajunge la ele.
Nici din aplicația Pro. Deschide dashboard-ul pe web, la Configurare, Widget.
Oaspetele vede widgetul în limba și pe fundalul pe care le-ai ales, dar abia după ce ai înlocuit codul pe site. Culoarea rămâne portocaliul HaiLa, orice ai pune. Pașii rezervării rămân aceiași.
- Ultimul pas nu este de ocolit. Limba și tema sunt scrise în codul pe care îl copiezi, nu trase de widget la fiecare deschidere. Cât timp pe site stă codul vechi, widgetul arată ca înainte, oricât ai salva în Settings.
- Primary Color nu funcționează deloc. Poți alege ce culoare vrei, ea se salvează și intră în cod, dar widgetul nu o citește: butoanele rămân portocalii la oaspete. Nu pierde vremea potrivind culoarea cu site-ul tău, iar dacă ai nevoie de alta, scrie-ne. Merg limba și tema; culoarea nu.
- Cele două bife de jos, Show restaurant information și Allow special requests, se salvează dar nu ajung nicăieri. Widgetul nu le citește. Cererile speciale apar oricum în formular.
- Widgetul își aduce fontul lui și nu îl ia din pagina ta, deci nu are setare de font. Dacă se bate cap în cap cu site-ul tău, scrie-ne.
Folosești API-ul de rezervări
#Dacă ai propriul site sau propria aplicație și vrei rezervările în ele, API-ul dă orele libere și primește rezervarea, fără widget.
- Deschide Configurare și alege API.
- La Date de acces vezi ID-ul localului și Client ID-ul. Cheile le emitem noi: dacă nu ai niciuna, scrie-ne la hello@haila.md.
- Autentificarea este HTTP Basic: Client ID pe post de utilizator, Client Secret pe post de parolă.
- Sub Endpointuri stau cele patru adrese, cu câmpurile fiecăreia și cu un exemplu gata făcut. Copiază exemplul lipind întâi secretul în căsuța de sus, ca să fie completat.
- Citește și lista de erori: răspunsurile de eroare vin ca text simplu, nu ca JSON.
Documentația și datele de acces sunt doar în dashboard, la Configurare, API. Din aplicații nu se ajunge la ele.
Nici din aplicația Pro. Deschide dashboard-ul pe web, la Configurare, API.
Rezervarea creată prin API intră la tine ca o cerere obișnuită, în așteptare, exact ca una venită din widget sau din aplicația HaiLa. Oaspetele nu află pe ce drum a venit.
- Cheile se emit doar de noi. Nu există un buton prin care să îți faci una singur și nici unul prin care să o schimbi.
- Secretul lipit în pagină nu se salvează nicăieri. Serverul completează exemplele cu el doar cât stai pe ecran, iar la reîncărcare îl ceri din nou.
- O cheie deschide un singur local. Cu două localuri ai nevoie de două chei.
- Sunt cel mult 200 de rezervări pe oră pentru un local. Peste asta primești eroarea 429.
- O rezervare prin API costă 0,50 € plus TVA, ca una din widget.
- Orele întoarse de API țin cont de timpul minim de anticipare, dar nu și de perioadele blocate. O oră dintr-o perioadă blocată apare liberă și rezervarea este refuzată la trimitere. Dacă închizi o zi, ține minte că prin API se vede tot deschisă până la ultimul pas.