Tjekvik tarjoaa yhteyden DMS-järjestelmään standardoidun CSV-tiedostotuonnin kautta. Tämä on yksisuuntainen varaustuonti, jossa CSV-tiedosto lähetetään SFTP:n kautta Tjekvik-palvelimelle.
Standardin CSV-tiedostorakenne on esitetty alla. SFTP-tunnuksia varten ottakaa yhteyttä osoitteeseen [email protected]
CSV-tiedostonimi:
CSV-tiedostojen tulee aina noudattaa tiedostonimen rakennetta:
Tjekvik_%%%%_YYYYMMDD.csv
Tjekvik jotta voitte tunnistaa tiedoston tarkoituksen.
%%%% tulee korvata toimipisteen nimellä, jotta me (Tjekvik) voimme tunnistaa sijainnin.
YYYYMMDD on päivämäärä esim. 20230825 jos kyseessä on 25. elokuuta 2023.
Toimitetut CSV-tiedostot:
Kun tiedostonimi on yhdistetty korjaamoon, mikä tahansa toimitettu tiedosto käsitellään automaattisesti Tjekvikin toimesta sen saavuttuessa SFTP-palvelimelle.
Mikä tahansa ladattu tiedosto korvaa automaattisesti edelliset versiot, jos sama päivämääräväli käytetään. Jos siis tiedosto toimitetaan kello 16:30 varauksilla 25. elokuuta 2023 ja päivitetty versio samalla päivämäärävälillä toimitetaan kello 22:00, niin kello 22:00 toimitettu sisältö korvaa kello 16:30 toimitetun sisällön.
CSV-tiedoston koodaus:
Käyttäkää vain UTF-8-koodausta +BOM:n kanssa
LineSeparator = Windows (CR LF, eli chr(13) + chr(10))
CSV-tiedoston sisältö:
Varmistakaa, että kaikki solut ovat pelkkää tekstiä datatyyppinä. Tämä on erittäin tärkeää, koska Excel tulkitsee päivämäärät, numerot ja muut datatyypit itse ja voi aiheuttaa ongelmia tuonnin aikana.
Datan erottelu tehdään puolipisteellä ";" tai pilkulla ",".
Tiedoston sisällön tulee olla varaukset päivälle P+5 (Huomenna + 5 päivää) ja se tulee ladata 4 kertaa päivässä – 08:00, 12:00, 16:00, 20:00 (paikallinen korjaamon aika).
" erottimena kenttien sisällä eli "Suunniteltu säännöllinen 30k km huolto".
Alla selitetään yksittäiset sarakkeet, ja M tarkoittaa, että sarake on pakollinen kun taas O tarkoittaa, että se on valinnainen. On mahdollista jättää kenttä tyhjäksi pakollisessa sarakkeessa, jos dataa ei ole saatavilla.
Kun arvoja 0 ja 1 käytetään, 0 luetaan "ei, epätosi, negatiivinen" ja 1 luetaan "kyllä, tosi, positiivinen".
Kentän nimi | M/O | Kentän muoto | Kuvaus |
OrderNumber | M | Pelkkä teksti | Korjaamon työtilauksennumero - käytetään varauksen tunnistamiseen |
RegisterNumber | M | Pelkkä teksti | Ajoneuvon rekisterikilpi - voidaan käyttää kirjautumiseen sisäänkirjauksen aikana |
OrderDate | M | DD-MM-YYYY | Suunniteltu varauksen aloituspäivä - TULEE OLLA DD-MM-YYYY muodossa esim. 25-02-2021.<br><br>Mikä tahansa muu muoto (25/02/2021, 25/02/21, 25.02.2021) rikkoo tuonnin. |
ArrivalTime | O
| HH:MM | Suunniteltu varauksen aloitusaika - TULEE OLLA HH:MM muodossa esim. 09:30.<br><br>Mikä tahansa muu muoto (09-30, 09/30, 09.30) rikkoo tuonnin. |
EndDate | O | DD-MM-YYYY | Suunniteltu varauksen päättymispäivä - TULEE OLLA DD-MM-YYYY muodossa esim. 25-02-2021.<br><br>Mikä tahansa muu muoto (25/02/2021, 25/02/21, 25.02.2021) rikkoo tuonnin. |
EndTime | O | HH:MM | Suunniteltu varauksen päättymisaika - TULEE OLLA HH:MM muodossa esim. 09:30.<br><br>Mikä tahansa muu muoto (09-30, 09/30, 09.30) rikkoo tuonnin. |
Contact | M | Pelkkä teksti | Yhteyshenkilön nimi - auton odotettu kuljettaja (jos tyhjä, käytetään asiakkaan nimeä) |
ContactEmail | O | Pelkkä teksti | Yhteyshenkilön sähköposti - käytetään viestintään koko prosessin ajan (jos tyhjä, käytetään asiakkaan sähköpostia) |
ContactMobilePhone | O | Pelkkä teksti | Yhteyshenkilön matkapuhelinnumero - käytetään viestintään koko prosessin ajan (jos tyhjä, käytetään asiakkaan matkapuhelinta) |
Name | M | Pelkkä teksti | Asiakkaan nimi - laskun vastaanottaja |
M | Pelkkä teksti | Asiakkaan sähköposti | |
MobilePhone | M | Pelkkä teksti | Asiakkaan matkapuhelin |
Address1 | O | Pelkkä teksti | Asiakkaan osoite - ensimmäinen rivi |
Address2 | O | Pelkkä teksti | Asiakkaan osoite - toinen rivi |
City | O | Pelkkä teksti | Kaupungin nimi - asiakkaan kaupunki |
ZipCode | O | Pelkkä teksti | Postinumero - asiakkaan kaupungin postinumero |
CarMileage | O | Pelkkä teksti | Auton kilometrimäärä - voidaan käyttää kilometrimäärän päivittämiseen |
CarBrand | O | Pelkkä teksti | Auton merkki |
CarModel | O | Pelkkä teksti | Auton malli - antakaa yksityiskohtainen kuvaus sisältäen moottorin tiedot, polttoainetyyppi |
VIN | M | Pelkkä teksti | Auton VIN-numero - käytetään lopulliseen dokumentaatioon |
CourtesyCar | O | 0/1 | Lainaauto - jos meidän täytyy suodattaa tai reagoida eri tavalla näissä varauksissa, asetetaan 1:ksi, muuten 0 |
Price | O | Pelkkä teksti | Hinta - täytä jos hinta tulee näyttää asiakkaalle |
RepairName1 | M | Pelkkä teksti | Varauksen sisältö - näytetään asiakkaalle |
RepairName2 | O | Pelkkä teksti | Varauksen sisältö - näytetään asiakkaalle, paitsi jos kenttä on tyhjä |
RepairName3 | O | Pelkkä teksti | Varauksen sisältö - näytetään asiakkaalle, paitsi jos kenttä on tyhjä |
RepairName4 | O | Pelkkä teksti | Varauksen sisältö - näytetään asiakkaalle, paitsi jos kenttä on tyhjä |
RepairName5 | O | Pelkkä teksti | Varauksen sisältö - näytetään asiakkaalle, paitsi jos kenttä on tyhjä |
RepairName6 | O | Pelkkä teksti | Varauksen sisältö - näytetään asiakkaalle, paitsi jos kenttä on tyhjä |
RepairName7 | O | Pelkkä teksti | Varauksen sisältö - näytetään asiakkaalle, paitsi jos kenttä on tyhjä |
RepairName8 | O | Pelkkä teksti | Varauksen sisältö - näytetään asiakkaalle, paitsi jos kenttä on tyhjä |
RepairName9 | O | Pelkkä teksti | Varauksen sisältö - näytetään asiakkaalle, paitsi jos kenttä on tyhjä |
RepairName10 | O | Pelkkä teksti | Varauksen sisältö - näytetään asiakkaalle, paitsi jos kenttä on tyhjä |
RepairName11 | O | Pelkkä teksti | Varauksen sisältö - näytetään asiakkaalle, paitsi jos kenttä on tyhjä |
RepairName12 | O | Pelkkä teksti | Varauksen sisältö - näytetään asiakkaalle, paitsi jos kenttä on tyhjä |
CustomerWaiting | O | 0/1 | Asiakas odottaa paikalla - jos meidän täytyy suodattaa tai reagoida eri tavalla näissä varauksissa, asetetaan 1:ksi, muuten 0 |
SelfServiceAllowed | O | 0/1 | Räätälöity itsepalvelun sallimisehto - voidaan käyttää itsepalvelun manuaaliseen poistamiseen käytöstä varaukselle, asetetaan 0:ksi poistamiseksi käytöstä |
CustomerGroup | O | Business/Retail | Asiakastyyppi - määrittää onko asiakas yritysasiakas vai yksityisasiakas |
ServiceAdvisor | O | Pelkkä teksti | Huoltoneuvojan nimi tai ID - käytetään yhdistämiseen työntekijöihin Tjekvik-hallintapaneelissa |
Department | O | Mechanical/Warranty/Bodyshop/ Cleaning/Not Categorized | Osasto - voidaan käyttää varausten suodattamiseen määritetyn osaston perusteella (esim. korikorjaamon sulkeminen pois itsepalvelusta) |
ContactMethod | O | Phone_call/email/sms/ video_call/no_contact_method | Ensisijainen yhteydenottotapa |