DigitalBooker-ajanvarausjärjestelmä

Vaatimukset

Sähköinen ajanvarausjärjestelmä DigitalBooker.
Integraatio vaatii seuraavat komponentit käyttöönsä:

• SKJScript -lisenssi

• Uudehko (05/2017) SKJ-versio

• DigitalBooker tunnukset (api-avaimien tekemiseen)

• DigitalBooker -apiavaimet

  • Mene DigitalBookerissa hallintaan

  • Ota sieltä API-avaimet

  • Näet tässä API-osoitteen, ota se talteen

  • Lisää uusi API-avain ja anna tälle kuvaava nimi

  • Ota tunniste ja salasana talteen

Toiminta

Liittymä hakee DigitalBookerista DigitalBookerin APIa käyttäen varauksia ja niiden sisältämiä asiakastietoja.

Kun asiakas (tai myyjäliikkeen henkilö) tekee varauksen, tallennetaan varaukselle aina joku asiakkuus. Asiakkuus voi olla joko tallennettu tai väliaikainen. SKJ:n kannalta ei ole merkitystä, onko asiakkuus tallennettu vai väliaikainen, tärkeintä on se, että henkilöllä on puhelinnumero.

Puhelinnumeron perusteella tehdään täsmäytys asiakasrekisteriin:
Jos järjestelmästä ei löydy puhelinnumerolla asiakkuutta, se perustetaan, jos ei, käytetään puhelinnumeron perusteella löydettyä asiakkuutta. Mikäli löytyy useammalta asiakkaalta sama puhelinnumero, käytetään ensimmäistä löydettyä.

Tämän jälkeen löydetylle (tai perustetulle) asiakkaalle lisätään asiakasteksteihin uusi otsikko muodolla YYYY-MM-DD HH:MM - Tuote eli esimerkiksi '2017-05-02 13:00 - Palvelutyö'. Tämän jälkeen tuon tekstiotsikon alle voidaan syöttää käynnin muistiinpanot.

Open

Käyttöönotto

1. Hae digitalbooker.pas ja digitalbookerconfig.pas tiedosto käyttöösi (saat nämä tilauksen yhteydessä) ja tallenna tiedostot winskj-hakemistoon

2. Muokkaa digitalbookerconfig.pas -tiedostoa esim notepadillä ja aseta sinne asetukset:

   dbname := 'TIETOKANTA'; // Tietokanta, johon tietoja päivitetään bookingsurl := '/ZZZ/fi/api/bookings'; // apin tarkempi endpoint getdays := 10; // kuinka monen päivän ajalta haetaan tietoja user := 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'; // api user pass := 'YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY'; // api pass

   1. SKJ-tietokannan nimi määritellään käyttäjän ympäristön mukaan

   2. bookingsurl, user ja pass -tiedot saat DigitalBookerilta:

      1. bookingsurl on siis API-osoite ilman https://varaaheti.fi -alkua

      2. user on tunniste

      3. pass on salasana

   3. Määritä kuinka monen päivän tiedot aina kerralla haetaan

      1. Jos tietoja haetaan esim päivittäin, teoriassa tähän riittäisi 1 päivä, mutta vikasietoisuuden takia se kannattaa olla hieman enemmän

3. Tallenna tiedosto

Nyt liittymä voidaan ajaa komennolla:

Tämä komento voidaan ajastaa suoritettavaksi sopivin väliajoin tai vaihtoehtoisesti lisätä esim WinSKJ -päävalikkoon seuraavasti:

1. Lisää skj.ini-tiedostoon seuraavat rivit:

   [PAINIKE1] Tyyppi=SUORITA Otsikko=Hae$Digital$Booker Parametri=c:\winskj\skjscript.exe;/F:digitalbooker.pas /RUN Fonttinimi=Arial Fonttikoko=8 [PAINIKE2] Tyyppi=SUORITA Otsikko=Digital$Booker$loki Parametri=c:\winskj\tail.exe;-f -n 50 skjscript.log Fonttinimi=Arial Fonttikoko=8

2. Ensimmäinen nappi siis suorittaa varsinaisen liittymän ja toisesta napista saadaan lokitiedostot näkyviin (mm. vikatilanteiden selvittämistä varten)

3. Napit näkyvät seuraavasti päävalikossa: