Przejdź do głównej zawartości

Import pliku CSV

Jeśli Twój system DMS nie posiada integracji API, możemy pomóc w skonfigurowaniu prostego importu wizyt klientów z pliku CSV.

P
Napisane przez Patrick Bostyn
Zaktualizowano ponad 3 tygodnie temu

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:

  1. 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.

  2. Separacja danych odbywa się za pomocą średnika ";" lub przecinka ",".

  3. 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).

  4. " 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

Email

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

Plik szablonu CSV

Ikona załącznika
Czy to odpowiedziało na twoje pytanie?