# `pdf_merge` — PDFs zusammenführen

**Zweck:** Fügt mehrere PDF-Dateien in der angegebenen Reihenfolge zu einem Gesamtdokument zusammen.

**Parameter**

| Name | Pflicht? | Default | Beschreibung |
|---|---|---|---|
| `output` | ja | — | Zielpfad des zusammengeführten PDFs. Verzeichnis wird bei Bedarf angelegt. |
| `file` | ja (mehrfach) | — | Eingabedatei; Element beliebig oft wiederholen. Mindestens **2 existierende** Dateien nötig; nicht gefundene Dateien werden mit Warnung übersprungen. Reihenfolge im XML = Reihenfolge im Ergebnis. |

**Eingangswerte:** Kontext-Variablen mit PDF-Pfaden, z. B. `{{antrag_pdf}}`, `{{anlage_pdf}}` oder `{{latest_pdf_path}}`.

**Ausgangswerte:** `latest_pdf_path`, `latest_pdf_url` (zeigen auf das zusammengeführte Dokument).

```xml
<task type="pdf_merge" id="zusammenfuehren">
  <config>
    <output>{{temp_dir}}/gesamt.pdf</output>
    <file>{{antrag_pdf}}</file>
    <file>{{anlage_pdf}}</file>
    <file>{{unterschrift_pdf}}</file>
  </config>
</task>
```