# `paperless_ablage` — Dokument im Archiv ablegen

**Zweck:** Übergibt eine Datei aus dem Workflow an das Dokumentenarchiv (Paperless-ngx REST-API) inkl. Metadaten (Titel, Korrespondent, Dokumenttyp, Tags). Das Archiv verarbeitet den Upload asynchron; der Task liefert die Task-UUID zurück.

**Parameter**

| Name | Pflicht? | Default | Beschreibung |
|---|---|---|---|
| `datei` | **ja** | — | Abzulegende Datei |
| `titel` | nein | — | Dokumenttitel |
| `korrespondent` | nein | — | Korrespondent (Name/ID) |
| `dokumenttyp` | nein | — | Dokumenttyp |
| `tags` | nein | — | Tags (CSV) |
| `base_url` | nein | *(ENV `PAPERLESS_URL`)* | Basis-URL des Archivs |
| `token` | nein | *(ENV `PAPERLESS_TOKEN`)* | API-Token |
| `output_var` | nein | `paperless` | Prefix der Ausgabevariablen |

**Eingangswerte:** Platzhalter in allen Parametern, z. B. `{{latest_pdf_path}}` in `<datei>`.

**Ausgangswerte:**
- `<prefix>_task_uuid` — Task-UUID des Archivs (Verarbeitung läuft asynchron)
- `<prefix>_ok` — `"1"` bei erfolgreicher Übergabe

**XML-Beispiel**

```xml
<task type="paperless_ablage" id="archivieren">
  <config>
    <datei>{{latest_pdf_path}}</datei>
    <titel>Rechnung {{re_nr}}</titel>
    <korrespondent>{{lieferant}}</korrespondent>
    <dokumenttyp>Eingangsrechnung</dokumenttyp>
    <tags>rechnung,{{verfahren}},freigegeben</tags>
    <base_url>{{paperless_url}}</base_url>
    <output_var>paperless</output_var>
  </config>
</task>
```

**Hinweis:** Zugang bevorzugt über die Umgebungsvariablen `PAPERLESS_URL`/`PAPERLESS_TOKEN` setzen, damit das Token nicht in der Workflow-XML steht. Fehlt der Zugang oder scheitert der Upload, endet der Task mit Fehler — bei nicht-blockierender Archivierung in einen `try_catch` legen.