Enforcement

WICHTIG

Die unten stehende Doku betrifft ist für das V1 Enforcement. Die Doku für den V2 Export findet man hier (opens new window)

ZIP Export

Der ZIP Export generiert pro Standort und pro Tag eine ZIP Datei, mit allen Vergehen in einem CSV, und allen dazugehörigen Bildern. Das ZIP kann entweder von ihnen Heruntergeladen werden, oder an einen HTTP, HTTPs, FTP, sFTP oder FTPs Server übertragen werden.

Hier können sie eine Beispieldatei herunterladen.

Verhalten von dem Export

Die Vergehen werden exportiert wenn sie an das Mahnwesen weitergegeben werden sollen. Dies passiert entweder:

• falls eine manuelle Überprüfung eingestellt ist, an dem Tag an dem das Vergehen händisch als gültig markiert worden ist.
• falls das händische überprüfung ausgestellt ist, immer an demselben Tag, wie das Vergehen erstellt worden ist.

Da es beim Händischen überprüfen zu verzögerungen kommen kann, kann es natürlich sein dass Sie Vergehen von unterschiedlichen Tagen erhalten, je nachdem wie regelmäßig die Überprüfung stattfindet. Wenn es keine Vergehen gibt, wird keine ZIP Datei für diesen Tag erstellt.

Es werden Maximal 50 Vergehen und dessen Bilder in eine Zip Datei eingefügt. Sollte es mehrere Vergehen geben, werden zusätzliche ZIP Dateien erstellt. Der Name der ZIP Datei ist eindeutig aber beginnt immer mit dem Datum an dem die Datei erstellt wird.

Bilder

Der Name von den Bildern ist eindeutig, unabhängig vom Standort. Bilder sind im JPEG Dateiformat abgespeichert.

CSV Datei

In der ZIP Datei befindet sich immer eine Datei mit dem selben Namen wie die ZIP Datei selbst (aber der Dateiendung .csv), in welcher alle Vergehen aufgelistet sind.

Warnung

Aufgrund von Rückwärtskompatibilitäten kann es sein, dass eine violations.csv Datei mit dem selben Inhalt in der ZIP Datei vorliegt. In einer Übergangszeit werden beide CSV Dateien vorliegen um bestehende Anbindungen nicht zu zerstören.

Dateiformat

Die CSV Datei ist so formatiert, dass sie mit Microsoft Excel einfach zu öffnen ist. Das Format ist das folgende:

• Encoding: UTF16-LE
• Die ersten 2 Bytes sind das UTF16-LE Byte Order Mark (BOM)
• Separator ist der Tabstop (\t)
• Alle Felder sind immer mit Hochkommas (") angeführt
• Alle Zeitangaben sind in der Zeitzone der Garage

Felder

• violation id: Eindeutige ID für das Vergehen
  Das ist eine Interne ID, sie ist Eindeutig und kann als Referenz für das Vergehen verwendet werden. Ein Vergehen existiert immer für genau einen Parkvorgang (session). Das Feld ist immer ausgefüllt.
• session id: Eindeutige ID für den Parkvorgang
  Das ist eine Interne ID, sie ist Eindeutig und kann als Referenz für das Vergehen verwendet werden. Ein Parkvorgang hat immer genau ein Vergehen. Das Feld ist immer ausgefüllt, da nur Parkvorgänge exportiert werden die auch ein Vergehen haben.
• garage id: Eindeutige ID für den Standort / das Parkhaus
  Das ist eine Interne ID pro Parkhaus. Sie ist eindeutig und kann als Referenz für das Parkhaus / den Parkplatz verwendet werden.
• provider id: Eindeutige ID für den Betreiber
  Das ist eine Interne ID pro Betreiber, sie ist für alle Ihre Standorte gleich und eindeutig.
• created: Datum und Uhrzeit wann der das Vergehen erstellt wurde
  
• license plate country dsit: Länderkennung vom Kennzeichen im DSIT (opens new window) format.
  Beispiel: A für Österreich, D für Deutschland.
• license plate country iso: Länderkennung vom Kennzeichen. 2 Buchstaben (alpha-2, ISO 3166, klein geschrieben).
  Beispiel: at für Österreich, de für Deutschland.
• license plate: Kennzeichen
  
• total penalty amount: gesamt entstandene Vertragsstrafe
  
• unpaid penalty amount: Noch nicht bezahlte Vertragsstrafe
  Üblicherweise steht hier der gleiche Betrag wie bei total penalty amount, aber kann auch im Falle einer Teilzahlung ein Betrag größer Null sein.
• penalty currency: Währung der Vertragsstrafe
  
• total session amount: gesamt entstandene Parkkosten
  
• unpaid session amount: noch zu zahlende Parkkosten
  Üblicherweise steht hier der gleiche Betrag wie bei total session amount, aber kann auch im Falle einer Teilzahlung ein Betrag größer Null sein.
• session currency: Währung der Parkkosten
  
• entry id: Eindeutige ID von der Einfahrts Traksation. Diese ID ist eindeutig und kann als Referenz für genau diesen einen Einfahrtsvorgang verwendet werden. Sie wird nur benötigt, falls Daten von diesem Einfahrtsvorgang über unsere anderen Schnittstellen abgefragt oder bearbeitet werden sollen.
  
• entry datetime: Datum und Uhrzeit der Einfahrt
  
• entry image: Dateiname vom Einfahrt Bild
  
• exit id: Eindeutige ID von der Ausfahrts Traksation. Diese ID ist eindeutig und kann als Referenz für genau diesen einen Ausfahrtsvorgang verwendet werden. Sie wird nur benötigt, falls Daten von diesem Ausfahrtsvorgang über unsere anderen Schnittstellen abgefragt oder bearbeitet werden sollen.
  
• exit datetime: Datum und Uhrzeit der Ausfahrt
  
• exit image: Dateiname vom Ausfahrts Bild
  

Wenn in der Projektphase nichts anderes definiert wurde sind dem Kunden immer die offene Vertragsstrafe (unpaid penalty amount) plus die offenen Parkkosten (unpaid session amount) zu verrechnen. Die Zwei Felder werden separat ausgewiesen um es im Anschreiben deutlicher darzustellen und falls die zwei Beträge steuerlich unterschiedlich gehandhabt werden müssen.