# Zugang zum Portal

FINN.ghost meldet sich am Portal mit einem API-Schlüssel an. Er wird im Portal erzeugt und in
den Einstellungen von FINN.ghost hinterlegt.

![AccessToken und ID in den Einstellungen](https://wiki.dako-it.com/uploads/images/gallery/2026-09/ghostdocs-finngmi-handbuch-gmi-zugang-866a2826-einrichtung-zugang.png)

## Den Schlüssel im Portal erzeugen

1. Im Portal von GetMyInvoices anmelden.
2. Oben rechts im Menü den Bereich für den **API-Zugriff** öffnen.
3. Über die Schaltfläche mit dem Plus einen neuen Schlüssel anlegen.
4. Als Berechtigung **Vollzugriff** wählen.
5. Den Schlüssel kopieren.

<p class="callout danger">Ohne Vollzugriff scheitert der Ablauf mitten drin: Die Schnittstelle darf Rechnungen dann zwar lesen, aber nicht als erledigt kennzeichnen. Die Folge wären Rechnungen, die bei jedem Lauf erneut importiert werden.</p>

## In FINN.ghost eintragen

Unter **FINN.GMI → Einstellungen** im Bereich **Zugang**:

| Feld | Inhalt |
| ---------------- | ---------------------------------------------------------- |
| AccessToken | der kopierte Schlüssel aus dem Portal |
| ID | die Kennung Ihres Portalkontos, beginnt mit `G-` |

<p class="callout info">Die ID dient der Kennzeichnung der Zugriffe. Sie steht im Portal bei den Kontodaten.</p>

<p class="callout warning">Der Schlüssel ist ein Zugang zu allen Rechnungen Ihres Portalkontos. Er gehört behandelt wie ein Kennwort — nicht per E-Mail versenden und nicht in einem Ticket hinterlegen.</p>

## Was FINN.ghost aus dem Portal holt

Bei jedem Lauf werden die Rechnungen abgefragt, die

- vom Typ **Eingangsrechnung** sind,
- im Portal **nicht archiviert** sind,
- das Schlagwort **`OK`** oder **`ZB`** tragen,
- und seit dem letzten Lauf **neu oder geändert** sind.

<p class="callout info">Alles andere bleibt unangetastet. Eine Rechnung ohne diese Schlagworte wird nicht abgeholt — auch nicht später, bis sie eines bekommt.</p>

## Weiter

[Belegzuordnung](https://wiki.dako-it.com/books/finngmi-handbuch/page/belegzuordnung)