/
Cardu-integraatio
Cardu-integraatio
Ohjelmistossa on kaksi merkittävää Cardu-integraatiota:
- Ohjelmiston sisäinen integraatio
- Tavoitteena tuottaa järkevä malli, jolla saadaan asiakkaalle "tulostettua" kanta-asiakaskortti
- Integraatio myös määrittää tiedot, jotka Carduun lähetetään
- SKJScriptillä toteutettu integraatio
- Tämä integraatio tekee kahta asiaa:
- Cardun kautta perustettujen asiakkaiden perustus järjestelmään
- Järjestelmässä muuttuneiden tietojen päivitys Carduun
- Tämä integraatio tekee kahta asiaa:
Ohjelmiston sisäisestä integraatiosta on dokumentaatio täällä: Cardu.
SKJScript-toteutuksella saavutetaan seuraavat hyödyt:
- Asiakkaat voivat lisätä kanta-asiakaskortin Cardu-lompakkoonsa suoraan Cardu-sovelluksessa
- Asiakastiedot päivittyvät Cardu → SKJ automaattisesti
- Asiakasnumeroista ei tarvitse huolehtia: Integraatio perustaa halutulle asiakasnumeroalueelle SKJ-asiakkaan ja lähettää asiakasnumeron heti perustuksen jälkeen takaisin Carduun
- Mikäli asiakas on jo olemassa järjestelmässä, käytetään vanhaa asiakasnumeroa (täsmääminen tapahtuu puhelinnumeron perusteella)
- Mikäli käytössä on bonusjärjestelmä, lähettää järjestelmä ostokertymä/bonustiedot Carduun
SKJScriptillä toteutettu integraatio käyttöönotetaan seuraavasti: Cardu
- Tilataan Cardu-integraatiolisenssi SKJ:lta
- Ladataan integraatio-komponentit
- Asetetaan asetukset
- Testataan integraatio
- Asetetaan integraatio palveluksi
- Varmistetaan, että palvelu toimii
Asetukset
Asetukset löytyvät tiedostosta carduinconfig.pas:
procedure setconfig; begin logentry('Luetaan asetukset tiedostosta carduinconfig.pas'); dbname := 'TIETOKANTA'; // Tietokanta, johon tietoja päivitetään cardid := 'abcdef'; customerNumberField := 'customerId'; // kenttä, johon skj:n asiakasnumero kytketään getdays := 1; // kuinka monen päivän ajalta haetaan tietoja user := 'user@example.com'; // http basic auth user pass := 'password'; // pass kantaasiakas := 1; // haluatko asettaa kanta-asiakas -ruksin päälle kun asiakas lisätään? 1=kyllä 0=ei asiakasryhma := 99; // asiakasryhma, johon asiakas perustetaan asiakasalku := 1; // asiakasnumerovälin, mihin asiakas perustetaan, ensimmäinen mahdollinen numero HUOM! Asiakasnumerovälillä tulee olla perustettuna vähintään yksi asiakkuus asiakasloppu := 1000; //asiakasnumerovälin, mihin asiakas perustetaan, viimeinen mahdollinen numero host := 'https://integrationapi.cardu.com'; // url, johon otetaan yhteys cardsurl := '/rest/cards/'; // apin tarkempi endpoint end;
- Tietokanta: asetetaan tietokanta, johon asiakkaat perustetaan
- Cardid: Cardu-kortin id (sama, mikä on asetettu Tiedosto → Asetukset → Cardu -välilehdelle)
- customerNumberField: Cardun kenttä, johon asiakasnumero on viety (oletuksena customerId)
- getdays: Kuinka vanhoja asiakkuuksia Cardusta haetaan - normaalikäytössä arvo on hyvä olla alle 10, mutta jos halutaan esimerkiksi tuoda vanhat Cardu-asiakkuudet sisään niin päiviä on hyvä lisätä, jotta vanhatkin Carduun perustetut asiakkaat päätyvät SKJ:hin
- user: Cardun integraatiokäyttäjätunnus
- pass: Cardun integraatiokäyttäjän salasana
- kantaasiakas: Asetetaanko kanta-asiakas -ruksi päälle kun asiakasta perustetaan (mm. bonuskäsittely vaatii ko ruksin)
- asiakasryhmä: Mikä asiakasryhmä asetetaan perustetulle asiakkaalle
- Asiakasnumeroavaruus:
- Huom! Asiakasnumeroväli voi olla samalla välillä kun muutkin perustetut asiakkat, tältä väliltä katsotaan aina seuraava vapaa numero
- asiakasalku: Asiakasnumeroavaruuden ensimmäinen numero
- asiakasloppu: Asiakasnumeroavaruuden viimeinen numero
- host / cardsurl: Cardun integraatiopalvelun osoite, lähtökohtaisesti ei tarvitse muokata
Testaaminen
- Aja skjscript käsin:
- C:\WINSKJ\SKJSCRIPT.EXE /F:C:\WINSKJ\CARDU\CARDUIN.PAS /RUN
- Tarkista skjscript.log -tiedosto, katso suorittuiko ajo ilman virheitä
- Perusta Carduun yksi asiakas
- Aja integraatio
- Tarkista, että asiakas perustui oikein järjestelmään
- Tarkista skjscript.log -tiedoto, katso suorittuiko ajo ilman virheitä
- Tee asiakkaalle yksi bonusosto
- Tarkista, että asiakkaalle kirjautui ostokertymä
- Aja integraatio
- Tarkista, että ostokertymä päivittyi oikein Carduun
- Huomaa, että ostokertymä tulee olla asetettu Cardu-asetuksiin lähetettäväksi kentäksi
Integraation asettaminen palveluksi
Integraatioon kuuluu myös tiedosto cardu-integration.cmd
Tarkista tiedoston sisältö, eritoten kaikki sen polut.
Testaa integraation toimivuus suorittamalla komentojono. Tarkista lokimerkinnät mikäli integraatio ei toimi.
Asenna integraatio palveluksi:
nssm Cardu C:\WINSKJ\Cardu-integration.cmd
Käynnistä palvelu (net start Cardu). Testaa integraation toiminta.
Related content
Cardu
Cardu
More like this
Aloitusopas
Aloitusopas
More like this
Perusrekisterin ylläpito
Perusrekisterin ylläpito
More like this
Asiakasryhmät
Asiakasryhmät
More like this
Osastojen ja tuoteryhmien kuvaukset
Osastojen ja tuoteryhmien kuvaukset
More like this
Asiakaspalaute
Asiakaspalaute
More like this