---
title: "Auftragsimport – vorlagenbasiertes Auftragsrouting – was, warum und wie."
description: "Eingehende Aufträge automatisch Vorlagen zuordnen. Behandelt die Konfiguration des Vorlagenabgleichs, den Umgang mit fehlgeschlagenen Importen und die Behebung einer falschen Adressauswahl."
url: https://help.qargo.com/de/articles/681640-auftragsimport-vorlagenbasiertes-auftragsrouting-was-warum-und-wie
locale: de
updated: 2026-05-28
---

# Auftragsimport – vorlagenbasiertes Auftragsrouting – was, warum und wie.

## Zusammenfassung {#h_2cffefddb9}

-   **Was:** Eine neue Ebene für den Vorlagenabgleich im _Auftragsimport_. Sie verknüpft einen eingehenden EDI- oder API-Auftrag automatisch mit einer _Auftragsvorlage_. Der Auftrag übernimmt die vollständige Planungsstruktur der Vorlage (Route mit mehreren Stopps, intermodale Abschnitte, Aufteilungen, Zuweisungen an Subunternehmer, Preisberechnung).
-   **Warum:** Bisher kamen EDI-/API-Aufträge als einfache Datensätze von der Abholung bis zur Lieferung an. Disponenten mussten die Planungsstruktur für jeden importierten Auftrag manuell neu aufbauen, selbst wenn dieselbe Route täglich gefahren wurde. Der vorlagenbasierte Import macht diese wiederkehrende Arbeit überflüssig.
-   **Wie:** Ein _Auftragsimport-Master_ wird so konfiguriert, dass ein Vorlagenabgleich erforderlich ist (_nur Qargo admin_). Wenn ein Auftrag eingeht, ordnet Qargo ihn anhand von Kunde, Transportservice und Stopp-Standorten einer Vorlage zu. Die Struktur der zugeordneten Vorlage wird auf den neuen Auftrag angewendet. Wird keine passende Vorlage gefunden, schlägt der Import mit einem Fehler fehl. Ein Disponent kann dann die richtige Vorlage manuell zuweisen.

## Voraussetzungen {#h_22bfd4bb2e}

-   Mindestens eine _Auftragsvorlage_ muss vorhanden und mit der erwarteten Routenstruktur korrekt konfiguriert sein.
-   Auf den Stopps der Vorlage müssen Standort-Aliase eingerichtet sein, damit eingehende Standortreferenzen zugeordnet werden können.
-   Die Funktion _Auftragsimport_ muss für den Mandanten aktiviert sein.
-   Die Konfiguration des Vorlagenabgleichs steht nur _Qargo admins_ zur Verfügung (oder _Super admins_, wenn das Feature-Flag _Transformationszuordnung erstellen_ aktiviert ist).

## Anwendungsfälle {#h_931939885c}

-   Ein intermodaler Betreiber erhält täglich EDI-Aufträge für dieselben Fährrouten. Der Vorlagenabgleich wendet automatisch die richtigen Abfahrts-, Umschlag- und Lieferstopps an. Disponenten müssen die Route so nicht jedes Mal neu aufbauen.
-   Ein Transportunternehmen importiert API-Aufträge für wiederkehrende Kundenrelationen. Der Import-Master ist so konfiguriert, dass der Abgleich sowohl nach Abhol- als auch nach Lieferstandorten erfolgt. So wird die richtige Vorlage (einschließlich der Zuweisungen an Subunternehmer) ausgewählt.
-   Ein Importauftrag geht mit einem unbekannten Standort-Alias ein. Der Import schlägt fehl, und ein Disponent nutzt die Aktion _Vorlage auswählen_, um die richtige Vorlage zuzuweisen und den Import manuell abzuschließen.

## Begriffe {#h_55015855fa}

| **Begriff** | **Definition** |
| --- | --- |
| _Auftragsimport-Master_ | Eine konfigurierte Importquelle unter **Konfiguration > Auftragsimport**, die festlegt, wie eingehende Aufträge verarbeitet werden. |
| _Auftragsvorlage_ | Ein vorkonfigurierter Auftrag in Qargo mit einer vollständigen Routenstruktur: Stopps, Transportservice, Zuweisungen an Subunternehmer und Preisberechnung. |
| _Vorlagenabgleich_ | Der Vorgang, bei dem ein eingehender Importauftrag anhand von Kunde, Transportservice und Stopp-Standorten automatisch einer _Auftragsvorlage_ zugeordnet wird. |
| _Standort-Alias_ | Ein alternativer Name für einen Standort, mit dem eingehende Standortreferenzen den Qargo-Standorten in der Vorlage zugeordnet werden. |
| _Vorlage auswählen_ | Eine manuelle Aktion in einer fehlgeschlagenen Importzeile, mit der ein Disponent eine Vorlage zuweisen und den Import erneut ausführen kann. |

* * *

## Vorlagenabgleich in einem Auftragsimport-Master konfigurieren {#h_9c4e4a47c8}

1.  **Konfiguration > Auftragsimporte** **aufrufen**.
2.  Den betreffenden _Auftragsimport-Master_ **öffnen** oder einen neuen erstellen.
3.  Den Toggle _„Vorlagenabgleich“_ **aktivieren**. Wenn er aktiviert ist, müssen alle Aufträge, die über diese Importquelle eingehen, einer Vorlage zugeordnet werden. Eine Ausnahme für einzelne Aufträge gibt es nicht.
4.  Die Einstellung _Abgleich nach_ **auswählen**:

    -   _Abholung und Lieferung_: Die Vorlage wird sowohl nach Abhol- als auch nach Lieferstandorten abgeglichen (strengster Abgleich).
    -   _Nur Abholung_: Abgleich nur nach dem Abholstandort.
    -   _Nur Lieferung_: Abgleich nur nach dem Lieferstandort.
5.  Die Konfiguration **speichern**.

:::callout{tone="info"}
🧰 Der Vorlagenabgleich kann nur von _Qargo admins_ konfiguriert werden (oder von _Super admins_ mit dem Feature-Flag _Transformationszuordnung erstellen_). Für weitere Hilfe den Qargo Account Manager kontaktieren.
:::

![](https://help.qargo.com/media/14a2e7f0495d-image.png)

* * *

## So funktioniert der Vorlagenabgleich beim Import {#h_f2c4730662}

Wenn ein Auftrag über einen Import-Master mit aktiviertem Vorlagenabgleich eingeht:

1.  Qargo prüft Kunde, Transportservice und Stopp-Standort(e) des eingehenden Auftrags anhand aller verfügbaren _Auftragsvorlagen_.
2.  Die Anzahl der Sendungen in der Vorlage muss genau mit dem eingehenden Auftrag übereinstimmen.
3.  Stopp-Standorte werden über _Standort-Aliase_ abgeglichen. Die eingehende Standortreferenz muss einem Alias auf den Stopps der Vorlage entsprechen.
4.  _Aufbau_- und _Abbau_-Stopps werden beim Abgleich nicht berücksichtigt. Es werden nur Abhol- und Lieferstandorte verwendet.
5.  Wird eine passende Vorlage gefunden, wird der Auftrag mit der Struktur der Vorlage erstellt. Die Importdaten (Daten, Mengen, Referenzen) werden darüber angewendet.
6.  Wird keine passende Vorlage gefunden, schlägt der Import fehl.

## Umgang mit fehlgeschlagenen Vorlagenimporten {#h_7ce6b31364}

Fehlgeschlagene Importe erscheinen in der Liste _Auftragsimport_ mit einem Fehlerstatus.

1.  **Aufträge > Auftragsimporte** **öffnen**, um die Liste anzuzeigen.
2.  Die fehlgeschlagene Zeile **identifizieren**. Sie zeigt einen Fehlerstatus an, der angibt, dass keine Vorlage gefunden wurde.
3.  Die Aktion _Vorlage auswählen_ in der Zeile **wählen**.
4.  Die richtige Vorlage in der Auswahl **auswählen**.
5.  **Bestätigen**: Der Auftrag wird aus der ausgewählten Vorlage erstellt, und die Importdaten werden darüber angewendet.

![](https://help.qargo.com/media/2985bc8f2075-image.png)

:::callout{tone="note"}
‼️ Wenn der Fehler durch einen unbekannten Standort-Alias verursacht wurde, muss der Alias zuerst manuell zum betreffenden Standort in der Vorlage hinzugefügt werden. Erst dann kann die Vorlage zugeordnet werden.
:::

![](https://help.qargo.com/media/dd3515b5b405-image.png)

## Falsche Adressauswahl beheben {#h_bd19e66f16}

Eine falsche Adressauswahl bei Importen oder beim KI-/OCR-Abgleich kann den Betrieb stören. Die folgenden Abschnitte erläutern die häufigsten Ursachen, die Schritte zur Behebung und Maßnahmen, um ein erneutes Auftreten zu verhindern.

### Häufige Ursachen {#h_0d5751ea1e}

-   **Konfiguration der Import-Aliase.** Ein falscher Import-Alias auf einem Standort kann dazu führen, dass Qargo eine Adresse durch eine andere ersetzt, wenn ein bestimmter Name oder Alias in der Importdatei vorkommt. Hat ein Standort zum Beispiel einen Alias wie „Karlsgarde“, ordnet Qargo diesen Namen möglicherweise der falschen Adresse zu.
-   **Fehler beim KI-/OCR-Abgleich.** Beim Import von Daten aus Dokumenten wie PDFs schlägt das KI-/OCR-System möglicherweise den falschen Standort vor, wenn die Standortdaten in Qargo nicht genau mit dem Wortlaut im Dokument übereinstimmen. Abweichungen in wichtigen Feldern wie Standortname, Adresse oder Anzeigename können zu falschen Zuordnungen führen.

### Probleme mit Aliasen beheben {#h_9ed9d87e08}

Um Probleme durch einen falschen Import-Alias zu beheben:

1\. Die Einstellungen des Standorts **aufrufen**.\
2\. Den Standortdatensatz in Qargo **öffnen**, der fälschlicherweise ausgewählt wird.\
3\. Den Abschnitt **_Import/Export_** **_Aliase_** im Standortprofil **suchen**.\
4\. Den Alias über das Stiftsymbol **bearbeiten**, um ihn zu korrigieren, oder den Alias ganz entfernen, wenn er falsche Zuordnungen verursacht.

:::callout{tone="note"}
📚 Durch das Entfernen oder Korrigieren eines falschen Alias werden Adressen bei künftigen Importen anhand der gelieferten Daten zugewiesen, ohne Ersetzung.
:::

* * *

## Genauigkeit des KI-/OCR-Abgleichs verbessern {#h_7c53ea2041}

Damit das KI-/OCR-System den richtigen Standort auswählen kann:

1\. Sicherstellen, dass die Standortdaten in Qargo so genau wie möglich mit dem Wortlaut im Quelldokument übereinstimmen.\
2\. Wichtige Felder (Standortname, Adresse und Anzeigename) an die Begriffe im Dokument angleichen.\
3\. Einheitliche und präzise Namenskonventionen für ähnliche Standorte verwenden, um der KI einen klareren Kontext für die Unterscheidung zwischen den Optionen zu geben.

### Vorbeugende Maßnahmen {#h_3c61a5c91a}

-   Standort-Aliase regelmäßig prüfen und aktualisieren, um sicherzustellen, dass sie die beabsichtigten Zuordnungen korrekt abbilden.
-   Namenskonventionen für Standorte und Adressen in Qargo vereinheitlichen, um Abweichungen zwischen Importdaten und Qargo-Datensätzen zu minimieren.
-   Importe mit Beispieldaten testen, um vor der Einführung einer neuen Importkonfiguration zu prüfen, dass die richtigen Adressen ausgewählt werden.

* * *

## Einschränkungen {#h_3b8a062241}

-   **Immer aktiver Abgleich.** Sobald der Vorlagenabgleich für einen Import-Master aktiviert ist, müssen alle über diese Quelle eingehenden Aufträge einer Vorlage zugeordnet werden. Über diese Quelle kann kein Auftrag ohne Vorlage erstellt werden.
-   **Keine nachträgliche Anwendung.** Vorlagen können nicht auf Aufträge angewendet werden, die bereits ohne Vorlage importiert wurden.
-   **Strikte Anzahl der Sendungen.** Die Vorlage muss genau dieselbe Anzahl an Sendungen enthalten wie der eingehende Importauftrag.
-   **Manuelle Standort-Aliase.** Standort-Aliase müssen manuell auf den Stopps der Vorlage erstellt werden. Eine automatische Erzeugung von Aliasen gibt es nicht.
-   **Keine regelbasierte Optimierung.** Wenn eine Route bedingte zusätzliche Stopps oder dynamische Aufteilungen erfordert (z. B. Emballage-Stopps, standortbasierte Aufteilungen), müssen diese bereits in der Vorlage enthalten sein. Der Vorlagenabgleich fügt Stopps nicht dynamisch hinzu und ändert sie nicht.
-   **Importe über das Kundenportal.** Portal-Nutzer können keine Vorlage auswählen. Portal-Aufträge durchlaufen denselben automatischen Abgleich wie EDI-/API-Aufträge.

* * *

## Fehlerbehebung {#h_07e1b0c026}

| **Problem** | **Wahrscheinliche Ursache** | **Lösung** |
| --- | --- | --- |
| Import schlägt mit dem Fehler „Keine Vorlage gefunden“ fehl | Keine Vorlage passt zu Kunde, Transportservice oder Stopp-Standorten des eingehenden Auftrags | Prüfen, ob für diese Route eine Vorlage vorhanden ist und ob die Standort-Aliase auf den Stopps der Vorlage korrekt konfiguriert sind |
| Import schlägt trotz passender Vorlage fehl | Die Anzahl der Sendungen in Vorlage und eingehendem Auftrag stimmt nicht überein | Sicherstellen, dass die Vorlage dieselbe Anzahl an Sendungen enthält wie der Importauftrag |
| Aktion _Vorlage auswählen_ ist nicht verfügbar | Für den Import-Master ist der Vorlagenabgleich nicht aktiviert | _Vorlagenabgleich verwenden_ in der Konfiguration des Import-Masters aktivieren |
| Vorlage wird gefunden, aber die falsche Route wird angewendet | Falscher Alias auf einem Stopp | Die Standort-Aliase in der zugeordneten Vorlage prüfen und korrigieren |
| Beim Import wird eine falsche Adresse ausgewählt | Auf dem Standort ist ein falscher Import-Alias konfiguriert | Den Alias im Abschnitt _Aliase_ des Standorts prüfen und korrigieren (siehe _Falsche Adressauswahl beheben_ oben) |
| KI/OCR schlägt anhand eines Dokuments den falschen Standort vor | Die Standortdaten in Qargo stimmen nicht genau mit dem Wortlaut im Quelldokument überein | Standortname, Adresse oder Anzeigename in Qargo an die Begriffe im Dokument angleichen |


## Verwandte Artikel

- [Datenimport – Standortdaten importieren](https://help.qargo.com/de/articles/413082-datenimport-standortdaten-importieren.md)
- [Kundenportal: Aufträge aus Vorlagen erstellen](https://help.qargo.com/de/articles/685597-kundenportal-auftraege-aus-vorlagen-erstellen.md)
- [Integrationen – Aufträge in Qargo importieren](https://help.qargo.com/de/articles/450378-integrationen-auftraege-in-qargo-importieren.md)
- [Datenimport – Import von Auftragsdaten](https://help.qargo.com/de/articles/418636-datenimport-import-von-auftragsdaten.md)
- [Intermodal: Käufer- und Verkäuferrollen in Qargo verstehen](https://help.qargo.com/de/articles/531968-intermodal-kaeufer-und-verkaeuferrollen-in-qargo-verstehen.md)
