Integrationen & Automatisierung

# Dokumente mit einer Dateivorlagen-Integration lesen

Zeigen Sie Transportial, wo Werte in einem Dokumentlayout stehen, etwa in einem Bestellformular, damit Dateien in diesem Layout automatisch gelesen werden.

Aktualisiert am 4\. Oktober 2026

**Wer kann das:** Rollenstufe 800 oder höher und die Integrationsberechtigung.

Viele Kunden senden Aufträge als PDF-, Word- oder Excel-Dateien, die immer gleich aussehen. Eine Dateivorlagen-Integration beschreibt dieses Layout einmal: welcher Wert wo steht und welches Transportial-Feld er füllt. Dateien im selben Layout können dann automatisch gelesen werden, zum Beispiel wenn Sie einen Auftrag aus einer Datei erstellen.

## Bevor Sie beginnen

* Halten Sie eine Beispieldatei im gewünschten Layout bereit. Unterstützt werden unter anderem PDF, Word, Excel, CSV, XML und Bilder.

## Die Vorlage erstellen

1. Öffnen Sie das Seitenmenü (☰, oben rechts), wählen Sie **Integrationen** und klicken Sie auf **\+ Integration erstellen**.
2. Geben Sie einen **Name** ein, zum Beispiel Kunde und Dokumentname.
3. Wählen Sie unter **Wählen Sie den Integrationstyp aus** die Option **Integration von Dateivorlagen**. Das Fenster wird breiter.
4. Wählen Sie unter **Entität auswählen**, was die Datei erstellt, meist einen Transportauftrag.
5. Legen Sie Ihre Beispieldatei im Upload-Bereich ab oder klicken Sie darauf, um die Datei auszuwählen.
6. Klicken Sie für jeden Wert, den Sie lesen möchten, auf **\+ Feld hinzufügen**.
7. Richten Sie jedes Feld ein (siehe unten).
8. Klicken Sie auf **Zu testen** und prüfen Sie das Ergebnis.
9. Stellen Sie **Aus/Ein** auf Ein und klicken Sie auf **Speichern**.

## Ein Feld einrichten

* **Selektortyp auswählen**: wie der Wert gefunden wird.  
  * **HTML**: Der Wert wird in der Textstruktur des Dokuments gefunden.
  * **Matrix**: Der Wert steht an einer Position im Seitenraster.
  * **Position der Textvariablen**: Der Wert wird relativ zu einer Beschriftung gefunden, zum Beispiel der Text rechts von „Lieferdatum“. Geben Sie mit **Oben**, **Rechts**, **Unten** und der Option für links an, wo.
* **Selektor**: wonach gesucht wird.
* **JSON-Zuordnung**: das Transportial-Feld, in das der Wert kommt.
* **Feldtyp auswählen**, **Format** und **Regex**: Daten und Zahlen korrekt lesen und einen Teil eines Texts herausgreifen.

Die Tabs **Matrix** und **HTML** neben den Feldern zeigen, wie Transportial Ihre Beispieldatei sieht, und heben hervor, was Ihre Selektoren finden. Nutzen Sie sie zur Feinabstimmung der Positionen. Schalten Sie den **JSON-Modus** ein, um alle Felder als Text zu bearbeiten.

Markieren Sie das Feld, das den Auftrag identifiziert (zum Beispiel die Auftragsnummer des Kunden), mit **Identifikation**, damit eine korrigierte Datei den Auftrag aktualisiert, statt einen zweiten anzulegen.

## Die Vorlage verwenden

Wenn Sie einen Auftrag aus einer Datei erstellen, füllt Transportial den Auftrag anhand Ihrer Vorlage aus. Siehe [Einen Transportauftrag aus einer Datei importieren](/de/help/import-transport-order-from-file).

## Verwandte Artikel

* [Einen Transportauftrag aus Datei oder E-Mail erstellen](/de/help/import-transport-order-from-file)
* [Andere Systeme über Integrationen anbinden](/de/help/integrations)
* [Eine selbstkonfigurierbare Integration erstellen](/de/help/self-configurable-integration)

## 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/file-template-integration