Tjekvik zapewnia połączenie z DMS poprzez standaryzowany import pliku CSV. Jest to jednokierunkowy import wizyt, gdzie plik CSV jest wysyłany przez SFTP na serwer Tjekvik.
Nasza standardowa struktura pliku CSV jest podana poniżej. W celu uzyskania danych dostępowych SFTP, prosimy o kontakt z [email protected]
Nazwa pliku CSV:
Pliki CSV powinny zawsze mieć strukturę nazwy pliku:
Tjekvik_%%%%_YYYYMMDD.csv
Tjekvik aby można było zidentyfikować cel pliku.
%%%% powinno zostać zastąpione nazwą lokalizacji, abyśmy (Tjekvik) mogli zidentyfikować lokalizację.
YYYYMMDD to data, np. 20230825 dla 25 sierpnia 2023.
Dostarczone pliki CSV:
Gdy nazwa pliku zostanie połączona z salonem, każdy dostarczony plik zostanie automatycznie przetworzony przez Tjekvik w momencie dostarczenia na serwer SFTP.
Każdy przesłany plik automatycznie nadpisze poprzednie wersje, jeśli zostanie zastosowany ten sam zakres dat. Jeśli więc plik zostanie dostarczony o 16:30 z wizytami na 25 sierpnia 2023, a zaktualizowana wersja z tym samym zakresem dat zostanie dostarczona o 22:00, to zawartość z 22:00 zastąpi zawartość z 16:30.
Kodowanie pliku CSV:
Proszę używać tylko kodowania UTF-8 z +BOM
LineSeparator = Windows (CR LF, czyli chr(13) + chr(10))
Zawartość pliku CSV:
Upewnij się, że wszystkie komórki mają typ danych zwykłego tekstu. Jest to bardzo ważne, ponieważ Excel interpretuje daty, liczby i inne typy danych samodzielnie i może powodować problemy podczas importu.
Separacja danych odbywa się za pomocą średnika ";" lub przecinka ",".
Zawartość pliku powinna obejmować wizyty na D+5 (Jutro + 5 dni) i powinna być przesyłana 4 razy dziennie – 8:00, 12:00, 16:00, 20:00 (lokalny czas salonu).
" jako separator w polach, np. "Planowana regularna konserwacja 30k km".
Poniżej wyjaśniono poszczególne kolumny, a M oznacza, że kolumna jest obowiązkowa, podczas gdy O oznacza, że jest opcjonalna. Możliwe jest pozostawienie pola pustego w obowiązkowej kolumnie, jeśli dane nie są dostępne.
Gdy używane są wartości 0 i 1, 0 będzie odczytane jako "nie, fałsz, negatywne", a 1 będzie odczytane jako "tak, prawda, pozytywne".
Field name | M/O | Format pola | Opis |
OrderNumber | M | Zwykły tekst | Numer zlecenia pracy warsztatowej - używany do identyfikacji wizyty |
RegisterNumber | M | Zwykły tekst | Numer rejestracyjny pojazdu - może być używany do logowania podczas zameldowania |
OrderDate | M | DD-MM-YYYY | Planowana data rozpoczęcia wizyty - MUSI BYĆ w formacie DD-MM-YYYY np. 25-02-2021.<br><br>Każdy inny format (25/02/2021, 25/02/21, 25.02.2021) spowoduje błąd importu. |
ArrivalTime | O
| HH:MM | Planowany czas rozpoczęcia wizyty - MUSI BYĆ w formacie HH:MM np. 09:30.<br><br>Każdy inny format (09-30, 09/30, 09.30) spowoduje błąd importu. |
EndDate | O | DD-MM-YYYY | Planowana data zakończenia wizyty - MUSI BYĆ w formacie DD-MM-YYYY np. 25-02-2021.<br><br>Każdy inny format (25/02/2021, 25/02/21, 25.02.2021) spowoduje błąd importu. |
EndTime | O | HH:MM | Planowany czas zakończenia wizyty - MUSI BYĆ w formacie HH:MM np. 09:30.<br><br>Każdy inny format (09-30, 09/30, 09.30) spowoduje błąd importu. |
Contact | M | Zwykły tekst | Nazwa kontaktu - oczekiwany kierowca samochodu (jeśli puste, zostanie użyta nazwa klienta) |
ContactEmail | O | Zwykły tekst | E-mail kontaktu - będzie używany do komunikacji przez cały proces (jeśli pusty, zostanie użyty e-mail klienta) |
ContactMobilePhone | O | Zwykły tekst | Numer telefonu komórkowego kontaktu - będzie używany do komunikacji przez cały proces (jeśli pusty, zostanie użyty telefon komórkowy klienta) |
Name | M | Zwykły tekst | Nazwa klienta - odbiorca faktury |
M | Zwykły tekst | E-mail klienta | |
MobilePhone | M | Zwykły tekst | Telefon komórkowy klienta |
Address1 | O | Zwykły tekst | Adres klienta - pierwsza linia |
Address2 | O | Zwykły tekst | Adres klienta - druga linia |
City | O | Zwykły tekst | Nazwa miasta - miasto klienta |
ZipCode | O | Zwykły tekst | Kod pocztowy - kod pocztowy miasta klienta |
CarMileage | O | Zwykły tekst | Przebieg samochodu - może być używany do aktualizacji przebiegu |
CarBrand | O | Zwykły tekst | Marka samochodu |
CarModel | O | Zwykły tekst | Model samochodu - proszę podać szczegółowy opis włączając szczegóły silnika, typ paliwa |
VIN | M | Zwykły tekst | Numer VIN samochodu - używany do dokumentacji końcowej |
CourtesyCar | O | 0/1 | Samochód zastępczy – jeśli musimy filtrować te wizyty lub inaczej na nie reagować, należy ustawić wartość 1, w przeciwnym razie 0 |
Price | O | Zwykły tekst | Cena - wypełnij jeśli cena ma być pokazana klientowi |
RepairName1 | M | Zwykły tekst | Zawartość wizyty - zostanie pokazana klientowi |
RepairName2 | O | Zwykły tekst | Zawartość wizyty - zostanie pokazana klientowi, chyba że pole jest puste |
RepairName3 | O | Zwykły tekst | Zawartość wizyty - zostanie pokazana klientowi, chyba że pole jest puste |
RepairName4 | O | Zwykły tekst | Zawartość wizyty - zostanie pokazana klientowi, chyba że pole jest puste |
RepairName5 | O | Zwykły tekst | Zawartość wizyty - zostanie pokazana klientowi, chyba że pole jest puste |
RepairName6 | O | Zwykły tekst | Zawartość wizyty - zostanie pokazana klientowi, chyba że pole jest puste |
RepairName7 | O | Zwykły tekst | Zawartość wizyty - zostanie pokazana klientowi, chyba że pole jest puste |
RepairName8 | O | Zwykły tekst | Zawartość wizyty - zostanie pokazana klientowi, chyba że pole jest puste |
RepairName9 | O | Zwykły tekst | Zawartość wizyty - zostanie pokazana klientowi, chyba że pole jest puste |
RepairName10 | O | Zwykły tekst | Zawartość wizyty - zostanie pokazana klientowi, chyba że pole jest puste |
RepairName11 | O | Zwykły tekst | Zawartość wizyty - zostanie pokazana klientowi, chyba że pole jest puste |
RepairName12 | O | Zwykły tekst | Zawartość wizyty - zostanie pokazana klientowi, chyba że pole jest puste |
CustomerWaiting | O | 0/1 | Klient czeka w salonie - jeśli musimy inaczej filtrować lub reagować na te wizyty, powinno być ustawione na 1, w przeciwnym razie 0 |
SelfServiceAllowed | O | 0/1 | Niestandardowa dozwolona samoobsługa - może być używana do ręcznego wyłączenia samoobsługi dla wizyty, powinna być ustawiona na 0 dla wyłączenia |
CustomerGroup | O | Business/Retail | Typ klienta - określa czy klient to flota czy klient detaliczny |
ServiceAdvisor | O | Zwykły tekst | Nazwa lub ID doradcy serwisowego - będzie używane do mapowania z pracownikami w panelu Tjekvik |
Department | O | Mechanical/Warranty/Bodyshop/ Cleaning/Not Categorized | Dział - może być używany do filtrowania wizyt na podstawie przypisanego działu (np. wykluczenie lakierni z samoobsługi) |
ContactMethod | O | Phone_call/email/sms/ video_call/no_contact_method | Preferowana metoda kontaktu |