Verwaltung

# Fragebögen zum Aktionsergebnis einrichten

Je Aktionstyp die Fragen festlegen, die Fahrer beim Abschluss beantworten: Fragetypen, Bedingungen, Ergebnisse, Feldänderungen und Bordcomputer-Codes.

Aktualisiert am 7\. Oktober 2026

**Wer kann das:** Rollenstufe 1000 oder höher (nur interne Benutzer). Für Mit KI generieren ist außerdem die Berechtigung zum Aktualisieren der Plattform erforderlich.

Ein Fragebogen zum Aktionsergebnis ist die Reihe von Fragen, die ein Fahrer beim Abschluss einer Aufgabe beantwortet, etwa beim Entladen. Die Antworten bilden das [Aktionsergebnis](/de/help/action-results): ob die Aufgabe erledigt wurde, warum nicht, Anmerkungen, Fotos und Unterschriften. Antworten können auch den Auftrag aktualisieren, zum Beispiel die Anzahl der tatsächlich geladenen Paletten oder ein neues Lieferdatum.

## So funktionieren Fragebögen

* Ihre Plattform hat höchstens einen Fragebogen pro Aktionstyp, zum Beispiel einen für das Beladen und einen für das Entladen. Um die Fragen innerhalb eines Typs zu variieren, verwenden Sie Bedingungen (siehe unten).
* Wenn ein Fahrer eine Aufgabe in OpenMove abschließt, ersetzt der Fragebogen ihres Typs den normalen Ergebnisbildschirm. Siehe [Aktionsfragebögen beantworten](/de/help/openmove-questionnaires).
* Derselbe Fragebogen öffnet sich in der geteilten Ausführungsansicht eines Trips, wenn dort jemand eine Aufgabe im Browser abschließt.
* Antworten, die ein Fahrer an einem Bordcomputer gibt, zum Beispiel Transics oder Webfleet, werden denselben Fragen zugeordnet (siehe **Antworten vom Bordcomputer** unten).
* Ohne Fragebogen wählen Fahrer **Erledigt**, **Teilweise erledigt** oder **Fehlgeschlagen** und geben einen Grund und Anmerkungen ein.

## Die Fragebögen öffnen

1. Öffnen Sie das Seitenmenü (☰, oben rechts) und wählen Sie **Einstellungen**.
2. Klicken Sie auf den Tab **Umgebung**.
3. Öffnen Sie den Abschnitt **Fragebögen zum Aktionsergebnis** zwischen **Planung** und **Preise**.

Der Abschnitt zeigt die Schaltfläche **Mit KI generieren** und einen Editor mit den Fragebögen als JSON-Text. Ist noch nichts eingerichtet, enthält der Editor `{}`.

## Fragebögen mit KI erstellen oder ändern

Am schnellsten beginnen Sie, indem Sie beschreiben, was Sie brauchen, oder das Informationsblatt Ihres Bordcomputers hochladen.

1. Klicken Sie auf **Mit KI generieren**.
2. Fügen Sie optional unter **Informationsblatt oder Dokumente (optional)** Dateien hinzu: Klicken Sie auf die Büroklammer oder ziehen Sie Dateien darauf. PDF, Word, Excel, CSV, Bilder und andere gängige Formate werden akzeptiert.
3. Beschreiben Sie unter **Anweisung**, was Sie möchten, zum Beispiel „Beim Entladen eine Schadensfrage mit Foto hinzufügen“ oder „Die Fragebögen aus diesem Transics-Informationsblatt erstellen“.
4. Klicken Sie auf **Generieren**. Das kann bis zu einigen Minuten dauern.
5. Lesen Sie die angezeigte Zusammenfassung. **Aktualisiert:** nennt die Aktionstypen, die erstellt oder geändert wurden; die übrigen Aktionstypen bleiben genau so, wie sie waren.
6. Prüfen Sie die neuen Fragebögen im Editor darunter.
7. Klicken Sie unten auf der Seite auf **Speichern**, um sie zu behalten.

Die KI sieht die Fragebögen so, wie sie im Editor stehen, einschließlich nicht gespeicherter Änderungen. So können Sie das Ergebnis mit einer weiteren Anweisung verfeinern, etwa „Das Foto optional machen“. Gespeichert wird erst, wenn Sie auf **Speichern** klicken. Um ein Ergebnis zu verwerfen, verlassen Sie die Seite, ohne zu speichern.

Klicken Sie ohne Anweisung und ohne Dateien auf **Generieren**, sehen Sie **Bitte geben Sie eine Anweisung ein oder laden Sie ein Dokument hoch**. Gab es nichts zu ändern, sehen Sie **Die KI hat nichts geändert.**

## Die Fragebögen selbst bearbeiten

1. Tippen Sie den Text im Editor ein oder fügen Sie ihn ein. Mit den Schaltflächen oben im Editor formatieren Sie den Text oder machen eine Änderung rückgängig.
2. Achten Sie auf den Rand des Editors: Ein Fehler im JSON, etwa ein fehlendes Komma oder Anführungszeichen, wird in seiner Zeile markiert. Solange der Text ungültig ist, ist **Speichern** deaktiviert.
3. Klicken Sie unten auf der Seite auf **Speichern**.
4. Testen Sie den Fragebogen, indem Sie auf einem Test-Trip eine Aufgabe dieses Typs abschließen (siehe **Einen Fragebogen testen** unten).

Der Text ist ein Objekt mit einem Eintrag pro Aktionstyp. Jeder Eintrag hat `enabled` (nur Fragebögen mit `true` werden verwendet), eine Liste `questions` und eine Liste `resultMappings`. Dieses Beispiel fragt, ob eine Entladung gut verlaufen ist, fragt nach einem Grund, wenn nicht, und erfasst eine Unterschrift, wenn ja:

```
{
  "unload": {
    "enabled": true,
    "questions": [
      {
        "id": "delivered",
        "label": "Were all goods delivered?",
        "type": "select",
        "order": 1,
        "options": [
          { "value": "yes", "label": "Yes", "setsResultStatus": "succeeded" },
          { "value": "partly", "label": "Partly", "setsResultStatus": "partiallySucceeded" },
          { "value": "no", "label": "No", "setsResultStatus": "failed" }
        ]
      },
      {
        "id": "why",
        "label": "What went wrong?",
        "type": "text",
        "order": 2,
        "conditions": [{ "questionId": "delivered", "operator": "notEquals", "value": "yes" }],
        "fieldMapping": { "target": "actionResult", "fieldPath": "reason" }
      },
      {
        "id": "signature",
        "label": "Signature of the receiver",
        "type": "signature",
        "required": false,
        "order": 3,
        "conditions": [{ "questionId": "delivered", "operator": "equals", "value": "yes" }]
      }
    ],
    "resultMappings": []
  }
}
```

### Aktionstypen

Der Schlüssel jedes Eintrags ist der Aktionstyp, für den er gilt:

| Schlüssel                              | Aufgabe                                    |
| -------------------------------------- | ------------------------------------------ |
| load                                   | Beladen                                    |
| unload                                 | Entladen                                   |
| attachTransportEquipment               | Ankoppeln eines Aufliegers oder Containers |
| detachTransportEquipment               | Abkoppeln eines Aufliegers oder Containers |
| genericAction                          | Allgemeine Aktion                          |
| refuel, customs, weighing, wait, break | Tanken, Zoll, Wiegen, Warten und Pausen    |

## Fragen

| Einstellung              | Wirkung                                                                                                                                                                                                                                                            |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| id                       | Ein innerhalb des Fragebogens eindeutiger Name für die Frage, etwa delivered. Bedingungen und Ergebniszuordnungen verweisen darauf. Ändern Sie ihn nicht mehr, sobald Fahrer geantwortet haben.                                                                    |
| label                    | Die Frage, die der Fahrer sieht.                                                                                                                                                                                                                                   |
| type                     | Die Art der Antwort (siehe die nächste Tabelle). Ohne Typ ist die Frage eine Textfrage.                                                                                                                                                                            |
| required                 | Ob der Fahrer antworten muss, bevor er abschließen kann. **Eine Frage ist Pflicht, außer Sie setzen "required": false.**                                                                                                                                           |
| order                    | Die Position im Fragebogen, die niedrigste zuerst.                                                                                                                                                                                                                 |
| description, placeholder | Hilfetext unter der Frage und der graue Text in einem leeren Feld.                                                                                                                                                                                                 |
| options                  | Die Auswahlmöglichkeiten einer Auswahlfrage, jeweils mit einem value (gespeichert) und einem label (angezeigt). Eine Option kann auch das Ergebnis setzen (siehe **Das Ergebnis festlegen**) oder mit nextQuestionId eine andere Frage zu ihrer Folgefrage machen. |
| conditions               | Wann die Frage angezeigt wird (siehe **Eine Frage nur anzeigen, wenn sie zutrifft**).                                                                                                                                                                              |
| validation               | Grenzen für die Antwort: minLength und maxLength (Zeichen), min und max (Zahlen, einschließlich) und decimals (Stellen nach dem Dezimaltrennzeichen).                                                                                                              |
| fieldMapping             | Wohin die Antwort geschrieben wird (siehe **Antworten in den Auftrag schreiben**).                                                                                                                                                                                 |
| externalIds              | Die Codes, die ein Bordcomputer für diese Frage verwendet (siehe **Antworten vom Bordcomputer**).                                                                                                                                                                  |

### Fragetypen

| Typ            | Der Fahrer                                                                                                                                                                      |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| text           | Gibt freien Text ein.                                                                                                                                                           |
| number         | Gibt eine Zahl ein. Sowohl 12,5 als auch 12.5 werden akzeptiert.                                                                                                                |
| select         | Wählt eine Option.                                                                                                                                                              |
| multiSelect    | Hakt eine oder mehrere Optionen an.                                                                                                                                             |
| boolean        | Nutzt einen Ja/Nein-Schalter. Die Antwort wird als true oder false gespeichert.                                                                                                 |
| date, datetime | Wählt ein Datum oder ein Datum mit Uhrzeit.                                                                                                                                     |
| photo          | Macht ein Foto oder wählt eines vom Telefon.                                                                                                                                    |
| signature      | Lässt jemanden auf dem Bildschirm unterschreiben.                                                                                                                               |
| message        | Liest eine Anweisung, etwa „Fotos der Plombe machen“. Sie braucht keine Antwort. Fügen Sie "messageState": "important" hinzu, um sie als **Achtung** statt **Info** anzuzeigen. |

## Eine Frage nur anzeigen, wenn sie zutrifft

Geben Sie einer Frage `conditions`, um sie nur in bestimmten Fällen anzuzeigen. Eine Frage mit mehreren Bedingungen wird nur angezeigt, wenn alle erfüllt sind. Eine ausgeblendete Frage ist nie Pflicht, und ihre Antwort wird nicht verwendet.

Eine Bedingung vergleicht die Antwort auf eine frühere Frage mit einem `value`:

| Operator               | Erfüllt, wenn die Antwort                                                                               |
| ---------------------- | ------------------------------------------------------------------------------------------------------- |
| equals / notEquals     | genau dem Wert entspricht / ihm nicht entspricht. Verwenden Sie für Ja/Nein-Fragen "true" oder "false". |
| contains               | den Wert enthält.                                                                                       |
| greaterThan / lessThan | eine Zahl über / unter dem Wert ist. Der Wert muss eine Zahl sein.                                      |
| isEmpty / isNotEmpty   | leer ist / gegeben wurde. Diese brauchen keinen Wert.                                                   |

Eine Bedingung kann statt einer Antwort auch den Auftrag prüfen. Setzen Sie `"source": "field"`, ein `target` (`action` oder `consignment`) und einen `fieldPath`, mit denselben Pfaden wie in **Antworten in den Auftrag schreiben**. Fragen Sie zum Beispiel nur dann nach der Aufliegertemperatur, wenn die erste Warenzeile der Sendung ein Kennzeichen hat:

```
"conditions": [{ "source": "field", "target": "consignment", "fieldPath": "goods.0.licensePlate", "operator": "isNotEmpty" }]
```

So deckt ein Fragebogen mehrere Varianten derselben Aufgabe ab, etwa für verschiedene Abteilungen oder Kunden. Lässt sich das Feld gar nicht lesen, wird die Frage angezeigt.

Für „diese Frage erst nach jener Antwort“ geben Sie der Option stattdessen eine `nextQuestionId`. Die genannte Frage wird zur Folgefrage: Sie wird erst angezeigt und ist erst Pflicht, wenn diese Option oder eine andere Option, die auf sie verweist, gewählt ist. Ihre eigenen Bedingungen gelten weiterhin.

## Das Ergebnis festlegen

Die Antworten bestimmen das Ergebnis der Aufgabe. Transportial prüft in dieser Reihenfolge und verwendet das Erste, das zutrifft:

1. **Ergebniszuordnungen.** Der erste Eintrag in `resultMappings`, dessen `conditions` alle erfüllt sind, setzt seinen `resultStatus` und `resultReason`. Verwenden Sie diese für Kombinationen, etwa „teilweise geliefert und mehr als 5 Stück übrig“.
2. **Optionen.** Eine gewählte Option mit `setsResultStatus` setzt diesen Status und `setsResultReason` den Grund.
3. **Standard.** Andernfalls ist das Ergebnis **Erledigt**.

```
"resultMappings": [
  {
    "conditions": [
      { "questionId": "delivered", "operator": "equals", "value": "partly" },
      { "questionId": "itemsLeft", "operator": "greaterThan", "value": "5" }
    ],
    "resultStatus": "failed",
    "resultReason": "Too many items not delivered"
  }
]
```

| Status             | Angezeigt als          | Wirkung                              |
| ------------------ | ---------------------- | ------------------------------------ |
| succeeded          | **Erledigt**           | Keine.                               |
| partiallySucceeded | **Teilweise erledigt** | Zählt als erledigt.                  |
| failed             | **Fehlgeschlagen**     | Die Sendung muss neu geplant werden. |
| cancelled          | **Storniert**          | Zählt als erledigt.                  |

Was eine fehlgeschlagene Aufgabe auslöst, ist in [Status erklärt: Aufträge, Sendungen, Trips und Aktionen](/de/help/status-lifecycles) beschrieben.

## Antworten in den Auftrag schreiben

Ein `fieldMapping` schreibt die Antwort auf eine Frage in ein Feld. Es hat ein `target`, einen `fieldPath` und optional eine `strategy` und eine `transform`.

| Ziel         | Feldpfade                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| actionResult | reason und remark des Ergebnisses. requestedRescheduleAt erfasst ein neues, vom Empfänger gewünschtes Datum, was die Neuplanung auslöst. Jeder andere Name wird unter diesem Namen beim Ergebnis gespeichert.                                                                                                                                                                                                                                                                      |
| action       | startTime, endTime, eta, etd, remark, duration (Sekunden) und externalAttributes.<name>. Bei einer Fotofrage fügt documents das Foto den Dokumenten der Aufgabe hinzu, wo Disponenten es auf der Aktionskarte sehen.                                                                                                                                                                                                                                                               |
| consignment  | remark, description, constraints.delivery.startingDateTime, constraints.delivery.endingDateTime und externalAttributes.<name>. Waren: goods.<field> (jede Warenzeile), goods.0.<field> (die erste Zeile, gezählt ab 0) oder goods.0.containedGoods.1.<field> (das zweite Stück im ersten Auflieger oder Container). Warenfelder: quantity, name, description, remark, barCode, weight, grossWeight, loadMeters und für Auflieger und Container licensePlate, seal und equipmentId. |

Die `strategy` bestimmt, was mit der Antwort geschieht:

| Strategie            | Wirkung                                                                                                                                                                                                                |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| overwrite (Standard) | Ersetzt das Feld durch die Antwort.                                                                                                                                                                                    |
| recordDifference     | Lässt das Feld unverändert. Weicht die Antwort davon ab, erfasst das Ergebnis eine Abweichung, etwa 33 gemeldete Paletten, wo der Auftrag 32 nennt. Verwenden Sie dies, um den Auftrag zu prüfen, statt ihn zu ändern. |
| appendComment        | Fügt der Anmerkung des Ziels eine Zeile „Frage: Antwort“ hinzu.                                                                                                                                                        |

Antworten werden so geschrieben, wie sie gegeben wurden. Um ein Datum in einem anderen Format zu schreiben, fügen Sie `"transform": { "type": "dateParse", "format": "dd-MM-yyyy HH:mm" }` hinzu; `"type": "addDuration"` macht aus einer Anzahl Sekunden einen Zeitpunkt, der so weit nach jetzt liegt.

Ein `overwrite` auf der Sendung ändert den Auftrag für alle, auch für Ihren Kunden. Verwenden Sie `recordDifference`, wenn Sie nur wissen möchten, was der Fahrer vorgefunden hat.

## Antworten vom Bordcomputer

Fahrer mit einem Bordcomputer beantworten Fragen auf diesem Gerät. Transportial ordnet diese Antworten Ihrem Fragebogen über `externalIds` zu: pro System (`transics` oder `webfleet`) der Code, den der Bordcomputer sendet. Antworten auf Fragen ohne Zuordnung werden nicht auf den Fragebogen angewendet.

* **Transics.** Verwenden Sie den Code aus den „Info columns“ Ihres Informationsblatts, etwa `SNR` für eine Plombennummer. Hat eine Frage keinen Code, verwenden Sie ihre genaue Beschreibung aus dem Blatt. Geben Sie Optionen beide Kodierungen: den Antworttext als `value` und den Antwortcode in eigenen `externalIds`.
* **Webfleet.** Verwenden Sie den Namen des Felds in der Auftragsnachricht.

```
{
  "id": "seal",
  "label": "Seal number?",
  "type": "text",
  "required": false,
  "externalIds": { "transics": "SNR" },
  "fieldMapping": { "target": "consignment", "fieldPath": "goods.0.seal", "strategy": "recordDifference" }
}
```

Antworten vom Bordcomputer kommen einzeln an. Pflichtfragen können daher unbeantwortet bleiben, und eine ungültige Antwort wird übersprungen, statt den Rest abzulehnen. Das Ergebnis ändert sich nur, wenn eine Antwort eines setzt.

Standardmäßig wird außerdem jede Antwort des Fahrers bei der Aufgabe angezeigt, auch Antworten, für die Sie keine Frage haben. Um nur zugeordnete Antworten zu erfassen, schalten Sie in der Bordcomputer-Integration **Alle Antworten des Bordcomputers erfassen** aus. Siehe [Bordcomputer](/de/help/board-computers).

Laden Sie das Informationsblatt bei **Mit KI generieren** hoch und lassen Sie die Fragebögen erstellen: Die KI trägt die Codes für Sie ein. Prüfen Sie sie anhand der in Ihrem Transics-Konto registrierten Codes, die vom Blatt abweichen können.

## Auf Abweichungen reagieren

Wenn eine Antwort eine Abweichung erfasst oder eine Antwort vom Bordcomputer als ungültig übersprungen wird, löst Transportial das Ereignis **Nach einem Fragebogen-Konflikt** aus. Wählen Sie es als Auslöser eines Workflows, einer Warnregel oder einer Nachrichtenautomatisierung, zum Beispiel um den Disponenten oder den Kundenservice zu benachrichtigen. Siehe [Arbeit mit Workflows automatisieren](/de/help/workflows) und [Warnungen und Warnregeln einrichten](/de/help/alert-rules).

## Einen Fragebogen testen

1. Legen Sie einen Test-Trip mit einer Aufgabe dieses Aktionstyps an und starten Sie den Trip.
2. Klicken Sie auf dem Trip auf das Symbol **Ausführungsansicht teilen**, um den Link zu kopieren, und öffnen Sie ihn in einem neuen Browser-Tab.
3. Klicken Sie bei der Aufgabe auf **Start** und dann auf **Abschließen**.
4. Beantworten Sie die Fragen und prüfen Sie, ob Folgefragen erscheinen, wenn sie sollen.
5. Klicken Sie auf **Abschließen** und prüfen Sie das Ergebnis bei der Aufgabe im Trip. Siehe [Aktionsergebnisse lesen](/de/help/action-results).

## Fehlerbehebung

* **Der Fragebogen erscheint nicht.** Prüfen Sie, ob `enabled` auf `true` steht, ob der Schlüssel zum Aktionstyp der Aufgabe passt und ob Sie die Einstellungen gespeichert haben.
* **Eine Frage erscheint nie.** Prüfen Sie ihre Bedingungen: Die `questionId` muss eine frühere Frage sein, und der `value` muss genau dem `value` der Option entsprechen, nicht ihrem Label.
* **Der Fahrer kann nicht abschließen.** Eine Frage ist Pflicht, außer sie hat `"required": false`. Ausgeblendete Fragen sind nie Pflicht.
* **Das falsche Ergebnis wird gesetzt.** Ergebniszuordnungen kommen vor Optionen, und die erste passende Zuordnung gewinnt. Setzen Sie die spezifischste Zuordnung an den Anfang.
* **Ein Feld wird nicht aktualisiert.** Prüfen Sie den `fieldPath` anhand der Listen oben, ob die Strategie `overwrite` ist und ob die Aufgabe zu einer Sendung gehört, wenn das Ziel `consignment` ist.

## Verwandte Artikel

* [Aktionsergebnisse lesen](/de/help/action-results)
* [Aktionsfragebögen beantworten](/de/help/openmove-questionnaires)
* [Planung und Routing für die Plattform konfigurieren](/de/help/platform-planning-and-routing-settings)
* [Bordcomputer registrieren](/de/help/board-computers)
* [Status erklärt: Aufträge, Sendungen, Trips und Aktionen](/de/help/status-lifecycles)

## Brauchen Sie weitere Hilfe?

Unser Support-Team beantwortet gerne alle Fragen zu Transportial.

[Support kontaktieren](/de/contact)[Problem melden](/de/report-issue)

---
Canonical page: https://transportial.com/de/help/action-result-questionnaires
