Eigenes System (API)

Wenn Ihre Lkw an eine Telematik melden, die Quanty nicht selbst liest (oder an Ihr eigenes System), kann dieses System die Positionen stattdessen an Quanty senden. Sie verbinden unter Telematik Eigenes System (API), erstellen einen API-Schlüssel, der Positionen senden darf, und Ihr System sendet die Positionen an eine Adresse. Ab dann wirken sie wie die jedes Anbieters: auf der Flottenkarte, auf der Fahrzeugtafel in der Sendungsverfolgung, bei den Kilometern der Aufträge und beim Kilometerstand.

Bevor Sie beginnen

• Telematik ist Teil des TMS-Add-ons, und nur Administratoren der Organisation verbinden Telematik und erstellen API-Schlüssel.
• Die Fahrzeuge müssen schon im TMS-Fuhrpark sein (Fahrzeuge und Züge): Quanty ordnet jede Position einem Ihrer TMS-Fahrzeuge zu und legt nie ein Fahrzeug aus einer Position an.
• Wer das sendende System entwickelt, braucht die Adresse, den Schlüssel und die Anfrage unten. Die vollständige Anfrage und Antwort stehen auch in der API-Referenz.

1. Eigenes System (API) verbinden

1. Öffnen Sie Telematik (über Integrationen) und klicken Sie auf der Kachel Eigenes System (API) auf Verbinden: „Für eine Telematik, die Quanty nicht selbst liest: Ihr System sendet die Positionen an Quanty.“
2. Unter Zugang ist nichts auszufüllen: „Hier ist nichts einzutragen. Ihr System sendet Fahrzeugpositionen an die Adresse unten, mit dem API-Schlüssel Ihrer Organisation.“ Der Schritt zeigt dieselben Anweisungen wie So senden Sie Daten (unten).
3. Ziel: eine Tabelle oder Keine Tabelle, nur Karte, wie bei jedem Anbieter (siehe Telematik verbinden).
4. Zeitplan: „Nichts wird nach Zeitplan gelesen: Positionen kommen an, wenn Ihr System sie sendet.“ Geben Sie bei Bedarf einen Namen ein und speichern Sie. Es gibt keinen Test: Bei keinem Anbieter wird etwas abgefragt.

Die Zeile der Verbindung zeigt dann Empfang: Über die API und Letzte Daten (wann die letzte Position ankam) und hat So senden Sie Daten. Eine solche Verbindung genügt; sobald Sie sie haben, blendet die Kachel Verbinden aus.

2. Einen API-Schlüssel erstellen, der Positionen senden darf

1. Öffnen Sie TMS-Einstellungen, API und Webhooks und klicken Sie auf Schlüssel erstellen.
2. Geben Sie einen Namen ein, zum Beispiel „Telematik-Sender“.
3. Wählen Sie Telematik: Senden. Es ist nie vorausgewählt, und früher erstellte Schlüssel haben es nicht. Die vier Arten von Daten zum Lesen (Aufträge, Geschäftspartner, Fahrzeuge, Rechnungen) sind standardmäßig ausgewählt: Wählen Sie sie ab, wenn der Schlüssel nur Positionen senden soll.
4. Klicken Sie auf Schlüssel erstellen und kopieren Sie den Schlüssel: „Wir zeigen diesen Schlüssel nur einmal. In der Liste bleibt nur sein Anfang; geht er verloren, widerrufen Sie ihn und erstellen Sie einen neuen.“

Ein Schlüssel nur mit Telematik: Senden kann Positionen senden und nichts lesen. Eine Organisation kann bis zu 20 aktive Schlüssel haben. Widerrufen sperrt einen Schlüssel sofort.

3. Positionen senden

So senden Sie Daten zeigt die Adresse mit Kopieren:

POST https://<your Quanty API address>/api/v1/ext/tms/telematics/positions
Authorization: Bearer <API key>
Content-Type: application/json

und die Beispielanfrage, mit der aktuellen Zeit ausgefüllt:

{"items":[{"vehicle":{"plate":"PO 1AB23"},"at":"2026-11-02T10:00:00Z","lat":52.4064,"lng":16.9252,"speed_kmh":82}]}

Die Felder einer Position

Ein optionaler Wert, der keinen Sinn ergibt (eine Geschwindigkeit von -1, ein Kilometerstand von 0, ein Kraftstoff von „n/a“), wird weggelassen und unter ignored aufgeführt; die Position selbst bleibt erhalten. Ein Feld, das Sie nicht senden, behält seinen letzten Wert (zum Beispiel der Fahrer); null leert es.

Wie ein Fahrzeug zugeordnet wird

1. Über id, wenn angegeben (eine unbekannte ID wird abgelehnt, ohne weiteren Versuch).
2. Sonst über vin; eine FIN, die zu nichts passt, fällt auf das Kennzeichen zurück.
3. Sonst über plate, verglichen ohne Leerzeichen und Bindestriche und in Großbuchstaben („po-1ab23“ passt zu „PO 1AB23“).

Ein TMS-Fahrzeug ohne Telematik wird bei seiner ersten Position mit dieser Verbindung verknüpft, und sein Verlauf vermerkt das. Ein Fahrzeug, das schon eine andere Telematikverbindung speist, wird abgelehnt, ebenso ein Kennzeichen oder eine FIN, die zwei Ihrer Fahrzeuge gemeinsam haben.

Grenzen

Senden Sie in Paketen von einigen hundert Positionen, pro Fahrzeug in zeitlicher Reihenfolge. Das Fahrzeug ist ab 3 km/h Fährt, darunter Steht und Kein Signal, wenn seine letzte Meldung älter als 6 Stunden ist. Der Kilometerstand des TMS-Fahrzeugs steigt nur, senden Sie also echte Werte.

Die Antwort

Quanty antwortet mit 200, wenn mindestens eine Position gespeichert wurde, mit:

Wurde nichts gespeichert, hat die Antwort dieselbe Form mit dem Status der Ablehnungen (404, 409 oder 422).

Eine einzelne Position kann abgelehnt werden wegen: einer unbekannten Fahrzeug-ID (404), eines Fahrzeugs, das nicht eindeutig ist oder von einer anderen Telematik gespeist wird (409), einer Zeit in der Zukunft oder älter als der Verlauf, oder eines fehlenden oder falschen Felds (422).

Gut zu wissen

• Eine pausierte Verbindung lehnt neue Positionen ab, bis Sie sie fortsetzen; die Zeile zeigt dann Empfang: Pausiert.
• Das Löschen der Verbindung löscht ihren Positionsverlauf und hebt die Verknüpfung der TMS-Fahrzeuge auf; danach gesendete Positionen werden abgelehnt.
• Positionen aus Ihrem System erscheinen innerhalb von 30 Sekunden auf der Flottenkarte und zählen wie die jedes Anbieters für die Auftragskilometer und die Fahrtenblätter.

Verwandte Seiten

• Telematik verbinden: die Anbieter, die Quanty selbst liest.
• Positionen und die Flottenkarte: wo die Positionen erscheinen.
• TMS-Einstellungen: API-Schlüssel und Webhooks.
• API-Referenz: die vollständige Anfrage und Antwort.