2. Formulare (Formdata)

Grundidee

Formulare ermöglichen es, strukturierte Informationen direkt während der Auftragsausführung über die Driver App zu erfassen.

Typische Beispiele sind:

• Unterschriften

• Fotos

• Checkboxen

• Auswahlfelder

• Texteingaben

• zusätzliche Bemerkungen

Diese Informationen werden im Auftrag im Feld formdata gespeichert und können anschließend über die API ausgelesen werden.

Damit lassen sich Rückmeldungen aus der Ausführung automatisiert in externe Systeme übernehmen, z. B.:

• ERP-Systeme

• Dokumentationssysteme

• Abrechnungssysteme

• Qualitätskontrolle

Aufbau von formdata

Das Feld formdata enthält eine Liste von Formularfeldern.

Jeder Eintrag beschreibt ein einzelnes Formularfeld und dessen Antwort.

Herkunft der Formulardaten

Formulardaten können auf zwei Arten entstehen:

1️⃣ Vorgabe beim Anlegen des Auftrags

Bereits beim Order/Create können Formulare oder Formularwerte definiert werden.

Typische Beispiele:

• Pflichtfelder für den Fahrer

• vorgefüllte Informationen

• strukturierte Eingabemasken

2️⃣ Rückmeldung aus der Driver App

Während der Durchführung eines Auftrags kann der Mitarbeiter in der Driver App Formularfelder ausfüllen.

Typische Beispiele:

• Unterschrift des Empfängers

• Foto einer Lieferung

• Auswahl eines Lieferstatus

• Eingabe von Bemerkungen

Diese Werte werden anschließend im Feld formdata gespeichert und können über die API abgerufen werden.

Bedeutung der wichtigsten Felder

Formularidentifikation

id

Technische ID des Formulars.

id_Text

Lesbarer Name des Formulars.

id_Guid

Interne GUID des Formulars.

Diese wird hauptsächlich systemintern verwendet.

Formularfeld

field

Technische ID des Formularfeldes.

field_Text

Lesbarer Name des Feldes.

field_Guid

Interne GUID des Feldes.

Feldwert

Die tatsächliche Antwort des Mitarbeiters wird über mehrere mögliche Felder übergeben.

value

Rohwert des Formularfeldes.

Dieser Wert wird in der Regel automatisch gesetzt.

value_Text

Textliche Antwort des Mitarbeiters.

Beispiel:

value_Id

ID einer Auswahloption.

Wird verwendet, wenn das Formularfeld eine vordefinierte Auswahl enthält.

value_Guid

GUID einer Auswahloption.

value_Additional

Zusätzlicher Textwert, falls vorhanden.

Beispiel:

Dateien und Bilder

Formulare können auch Dateien oder Fotos enthalten.

Typische Beispiele:

• Unterschrift

• Lieferfoto

• Dokumentation eines Schadens

file_Data

Base64-kodierte Datei.

file_Name

Dateiname der übermittelten Datei.

Beispiel: Rückmeldung aus der Driver App

Typische Integrationsszenarien

Formulardaten werden häufig genutzt für:

Lieferbestätigung

• Unterschrift

• Zustellstatus

• Empfängername

Fotodokumentation

• Foto der Ware

• Foto der Ablagestelle

• Schadensdokumentation

Statusrückmeldung

• Lieferung vollständig

• Lieferung teilweise

• Lieferung verweigert

Zusatzinformationen

• Bemerkungen des Fahrers

• Schadensbeschreibung

• fehlende Ware

Bedeutung für Integrationen

Formulardaten sind besonders relevant, wenn:

• Zustellnachweise automatisiert verarbeitet werden sollen

• Fotos oder Unterschriften archiviert werden

• Rückmeldungen in ERP-Systeme übernommen werden

• digitale Liefernachweise erstellt werden