Kisslog - Dokumentation

Die Excel-Integration dient dem Import kompletter Fahrpläne für LKWs in das KissLog-Backend.
Die importierten Fahrpläne stehen anschließend den Fahrern in der mobilen App zur Verfügung und bilden die Grundlage für die operative Tourdurchführung.

Der Zugriff erfolgt über einen Excel API-Key, der im Bereich Integrationen im Backend erstellt wird.

Zweck der Excel-Integration

Die Excel-Integration ermöglicht:

Planung von LKW-Touren außerhalb des KissLog-Systems
Massenimport kompletter Fahrpläne inklusive Stopps
Schnelle und strukturierte Bereitstellung der Touren für Fahrer
Reduzierung manueller Eingaben im Backend
Integration bestehender externer Planungsprozesse

Voraussetzungen

Für die Nutzung der Excel-Integration müssen folgende Voraussetzungen erfüllt sein:

Aktivierter Excel API-Key im Bereich Integrationen
Verwendung der offiziellen KissLog-Excel-Fahrplanvorlage
Gültige Fahrzeuge (LKWs) im System
Korrekte Zuordnung von Fahrzeugen und Fahrern

Excel-Fahrplanvorlage

Für den Import wird eine vordefinierte Excel-Vorlage verwendet.
Diese Vorlage ist verbindlich und darf strukturell nicht verändert werden.

Grundprinzip

Jede Zeile der Excel-Datei entspricht einer Tour (einem Stopp)
Mehrere Zeilen mit gleicher Fahrplan- oder Tour-ID bilden einen Fahrplan
Die Reihenfolge der Zeilen bestimmt die Abfolge der Stopps
Alternativ kann die Reihenfolge explizit über ein Positionsfeld gesteuert werden
Alle Touren eines Fahrplans werden einem LKW zugeordnet

Ein Fahrplan kann sich somit über mehrere Zeilen der Excel-Datei erstrecken.

Typische Inhalte der Fahrplanvorlage

Die Excel-Fahrplanvorlage enthält unter anderem folgende Informationen:

Fahrplan- oder externe Tournummer // Externe Tournummer wird automatisch generiert.
LKW-Kennzeichen oder interne Fahrzeug-ID
Tourtyp (z. B. Lieferung, Entsorgung)
Lade- und Entladeadresse (Straße, PLZ, Ort)
Optionale Koordinaten für Lade- und Entladepunkte
Zusatzinformationen und Hinweise für den Fahrer
Ansprechpartner- und Kontaktdaten

Unten finden Sie eine Tabelle aller Felder und ob diese Optional oder Pflichtfelder sind.

Import-Ablauf

Der Import erfolgt in mehreren klar definierten Schritten:

Ausfüllen der offiziellen Excel-Fahrplanvorlage
Übermittlung der Datei über die Excel-Integration (API-Key)
Automatische Validierung der Daten
Import der Fahrpläne in das KissLog-Backend
Automatische Bereitstellung des Fahrplans in der mobilen Fahrer-App

Datenvalidierung

Während des Imports werden unter anderem folgende Punkte geprüft:

Existenz des angegebenen LKWs (per ID oder Kennzeichen)
Vollständigkeit der Fahrplandaten
Gültige Lade- und Entladeadressen
Konsistente Zuordnung der Stopps zu einem Fahrplan
Mindestanzahl von Touren pro Fahrplan

Fehlerhafte oder unvollständige Zeilen werden abgelehnt und im Importprotokoll ausgewiesen.
Der restliche Import wird nur durchgeführt, wenn die Validierung erfolgreich ist.

Verfügbarkeit in der mobilen App

Nach erfolgreichem Import:

Erscheinen die Fahrpläne automatisch in der mobilen Fahrer-App
Erscheinen in der Disposition im Backend
Fahrer sehen ihre zugewiesenen Fahrpläne und Touren
Stopps werden in der geplanten Reihenfolge angezeigt
Zusatzinformationen sind pro Tour direkt abrufbar

Die importierten Fahrpläne sind sofort einsatzbereit.

Hinweise & Einschränkungen

Es können ausschließlich vollständige Fahrpläne importiert werden
Änderungen an bestehenden Fahrplänen erfordern einen erneuten Import
Die Excel-Vorlage darf nicht strukturell verändert werden
Der Import ersetzt keine manuelle Nachbearbeitung bestehender Fahrpläne

Individuelle Excel-Importdateien

Auf Wunsch kann eine individuelle Excel-Importdatei bereitgestellt werden, die speziell auf die Anforderungen des Kunden zugeschnitten ist.

Mögliche Anpassungen:

Aufbau und Struktur der Excel-Datei
Spaltennamen und Reihenfolge
Pflicht- und optionale Felder
Abbildung bestehender interner Prozesse

Die Umsetzung individueller Excel-Importformate erfolgt gegen Entgelt und nach vorheriger fachlicher Abstimmung.

Excel-Integration (Fahrpläne für LKWs)