Zum Hauptinhalt springen

Get toll costs for an auction by MongoDB ObjectId

GET 
/company/minimal/bid-auction

Ruft die Mautinformationen einer bestehenden Auktion anhand ihrer MongoDB ObjectId (_id) ab. Liefert detaillierte Mautdaten für die spezifische Route, die der Auktion zugeordnet ist.

Ziel​

Schnellen Zugriff auf Mautinformationen für subventionierte Frachtauktionen ermöglichen und so eine transparente Kostenaufschlüsselung und die Validierung von Geboten erleichtern.

Anwendungsfälle​

  • Anzeige der Mautkosten in der Auktionsdetailansicht für Transportunternehmen
  • Validierung von Gebotssummen gegenüber den Mautkosten
  • Bereitstellung von Kostenaufschlüsselungen in Auktionszusammenfassungen
  • Unterstützung bei Gesamtkostenberechnungen für Gebotsentscheidungen
  • Generierung von Kostenberichten für abgeschlossene Auktionen

Prozessablauf​

  1. Abfrage der Auktion anhand der MongoDB _id (ObjectId)
  2. Befüllen der Abholadresse (etl_address) und Lieferadresse (etd_address)
  3. Extrahieren der GPS-Koordinaten aus dem Standortfeld der Adresse
  4. Abfrage der externen Maut-API für die Route
  5. Rückgabe der Mautdaten mit Start-/Endkoordinaten und Kosten

Antwortinformationen​

  • start: GPS-Koordinaten des Ursprungs (lat, lng)
  • end: GPS-Koordinaten des Ziels (lat, lng)
  • tolls: Array mit den Mautinformationen der Route
  • tollCost: Gesamtkosten aller Mautstellen in EUR

Fehlerantworten​

  • 400: Fehlende oder ungültige Auktions-ID
  • 404: Auktion mit der angegebenen ID nicht gefunden
  • 500: Fehler des externen Mautdienstes oder fehlende Adresskoordinaten

Request​

Responses​

Mautkosten korrekt abgerufen