# SelectLine-API

Über die SelectLine-API schreibt FINN.ghost in den Mandanten — Belege, Adressen, Artikel,
Journale, Buchungen. Sie gehört zu sl.mobile.

![Karte API](https://wiki.dako-it.com/uploads/images/gallery/2026-09/ghostdocs-finnghost-systemhandbuch-sys-api-22254d3d-einstellungen-api.png)

## Die Felder

| Feld | Inhalt |
| ------------- | ---------------------------------------------------------- |
| **URL** | Adresse der API |
| **AppKey** | der bei SelectLine hinterlegte AppKey |
| **Nutzer** | in der SelectLine angelegter API-Benutzer |
| **Passwort** | dessen Kennwort |

### URL

Die Adresse von sl.mobile, mit `slmobileApi` statt `slmobile`:

```text
https://localhost/slmobileApi
```

<p class="callout info">Läuft FINN.ghost auf demselben Server wie sl.mobile, ist <code>localhost</code> die zuverlässigste Angabe — sie ist unabhängig von Rechnernamen und DNS.</p>

### AppKey

Der AppKey wurde beim Kauf der API bei SelectLine angegeben. Einzusehen in der SelectLine
unter **Hilfe → Lizenzierung → AppKeys**.

<p class="callout warning">Weicht der Eintrag hier vom AppKey in der SelectLine ab, meldet die API die Anmeldung ab. In diesem Fall den Wert aus der SelectLine übernehmen — nicht umgekehrt.</p>

<p class="callout info">Bei der Lizenz <strong>SelectLine Shopify-Anbindung</strong> ist die API in der Lizenz enthalten; das Feld bleibt dann leer. In der Oberfläche steht deshalb <em>für Shopify nicht notwendig</em>.</p>

### Nutzer und Passwort

Der in der API-Konfiguration von sl.mobile eingerichtete API-Benutzer.

<p class="callout danger">Dieser Benutzer arbeitet mit seinen SelectLine-Rechten. Er braucht Rechte auf den Mandanten und auf die Bereiche, die die eingesetzten Module berühren — Artikel, Adressen, Belege, Journale. Fehlt ein Recht, scheitert genau die Übertragung, die es braucht.</p>

## Ob die Verbindung steht

Steht sie, zeigt die Karte oben rechts den **Namen des Mandanten**. Ein Klick darauf öffnet
die Angaben zum angemeldeten Benutzer.

<p class="callout success">Das ist die verlässlichste Einzelprüfung der Einrichtung: Der Name kommt aus der SelectLine — er erscheint nur, wenn Adresse, Benutzer, Kennwort und API-Lizenz zusammenpassen.</p>

## Wenn die Anmeldung scheitert

| Symptom | Ursache |
| ------------------------------------------- | ----------------------------------- |
| kein Mandantenname, Fehler im Protokoll | Benutzer, Kennwort oder AppKey falsch |
| Adresse nicht erreichbar | sl.mobile läuft nicht, oder die URL zeigt auf `slmobile` statt `slmobileApi` |
| Zertifikatsfehler | das Zertifikat von sl.mobile wird nicht anerkannt |
| Anmeldung geht, Schreiben scheitert | dem SelectLine-Benutzer fehlen Rechte |

Siehe [Log Informationen](https://wiki.dako-it.com/books/finnghost-systemhandbuch/page/log-informationen).

## Nächster Schritt

[Lizenz und Module](https://wiki.dako-it.com/books/finnghost-systemhandbuch/page/lizenz-und-module)