[SnelStart](https://www.snelstart.nl) ist eine niederländische Buchhaltungssoftware. X-Sitter überträgt deine Aufträge als Verkaufsaufträge (*verkooporders*) in deine SnelStart-Administration. Die Kunden (*relaties*) und Artikel (*artikelen*) dieser Aufträge werden in SnelStart ebenfalls angelegt, wenn es sie dort noch nicht gibt.

Die Seite **Buchhaltung › SnelStart** zeigt, ob die Verbindung funktioniert, wie viele Datensätze übertragen wurden und welche Übertragungen fehlgeschlagen sind.

![Screenshot: SnelStart-Seite, Karte „Status“ mit SnelStart aktiv, Länderfilter, Webhook-URL und der Verbindungsliste mit den Knöpfen „Verbindung testen“ und „Kopplung aktivieren“](/accounting/images/snelstart-status.png)

## Bevor du startest

- Dein Benutzer braucht das Recht **SnelStart** im Bereich **Buchhaltung** des Rechtebaums. Frag deinen Administrator.
- Du brauchst eine SnelStart-Administration und Zugang zur SnelStart-B2B-API: einen **Subscription Key** aus dem SnelStart Developer-Portal und – je nach Art der Kopplung – einen Kopplungsschlüssel oder den **AppShortName** aus der Anmelde-Mail von SnelStart.
- Der X-Sitter-Support schaltet SnelStart für deine Firma ein und setzt den **Länderfilter**. Übertragen werden nur Aufträge, deren Lieferland im Filter liegt. Solange **SnelStart aktiv** auf **nein** steht, wird nichts übertragen.
- Die Übertragung läuft über zwei Jobs, **Bestellungen zu SnelStart senden** und **Artikel zu SnelStart senden**. Du legst sie selbst unter **Administration › Jobs & Verbindungen** › **Neuer Job** an, Gruppe **SnelStart** – siehe [Jobs & Verbindungen](/administration/jobs-and-connections.md). Fehlt dir das Recht für Jobs & Verbindungen, frag deinen Administrator; Untermandanten brauchen zusätzlich die Freigabe ihres Hauptmandanten.

## Schritt für Schritt

### 1. SnelStart-Verbindung anlegen

1. Öffne **Administration › Jobs & Verbindungen**, klicke auf **Verbindungen** und dann auf **Neue Verbindung** – siehe [Jobs & Verbindungen](/administration/jobs-and-connections.md).
2. Wähle den Typ **SnelStart** und trag eine **Bemerkung** ein, z. B. den Namen deiner Administration.
3. Trag den **Subscription Key** ein – den Primär- oder Sekundärschlüssel aus deinem Profil im SnelStart Developer-Portal.
4. Je nach Art der Kopplung:
   - **Maatwerk:** Erzeuge in SnelStart Web unter *Koppelingen › Maatwerk* einen Schlüssel und trag ihn als **Kopplungsschlüssel (Client Key)** ein.
   - **Productie:** Trag den **AppShortName** aus der Anmelde-Mail von SnelStart ein und lass den Kopplungsschlüssel leer – SnelStart füllt ihn in Schritt 2.
5. Klicke auf **Speichern**.

![Screenshot: Verbindungsformular vom Typ SnelStart mit Subscription Key, Kopplungsschlüssel, AppShortName, Benutzer, Passwort und API Basis-URL](/accounting/images/snelstart-connection-form.png)

### 2. Verbindung mit SnelStart koppeln (nur Productie)

1. Öffne **Buchhaltung › SnelStart**.
2. Klicke in der Zeile der Verbindung auf **Kopplung aktivieren**. Der Knopf erscheint nur, wenn ein AppShortName hinterlegt ist.
3. X-Sitter leitet dich zu SnelStart Web weiter. Bestätige dort die Kopplung.
4. SnelStart schickt dich zurück zu X-Sitter. Du siehst „Die Kopplung wurde in SnelStart bestätigt. Sobald SnelStart den Schlüssel übermittelt hat, ist die Verbindung aktiv.“
5. SnelStart übermittelt den Kopplungsschlüssel an die **Webhook-URL**, die auf der Seite steht. Danach zeigt die Spalte **Kopplungsschlüssel** einen Haken und **Aktiviert** das Datum.

### 3. Verbindung testen

Klicke auf **Verbindung testen**. X-Sitter schickt eine Testanfrage an SnelStart und liest die Daten deiner Administration. Klappt es, siehst du „Verbindung zu "…" erfolgreich“, und die Spalte **Administration** zeigt den Namen deiner SnelStart-Administration.

### 4. Übertragungen im Blick behalten

Die Karte **Übertragungen** zählt je Art – **Bestellungen**, **Kunden**, **Artikel** –, wie viele **übertragen** wurden, wie viele fehlgeschlagen sind (**Fehler**) und wie viele noch **offen** sind. Darunter siehst du die SnelStart-Jobs deiner Firma mit ihrem Zustand (**aktiv** / **inaktiv**) und dem Zeitpunkt des letzten Laufs.

![Screenshot: Karte „Übertragungen“ mit den Zählern für Bestellungen, Kunden und Artikel und der Liste der SnelStart-Jobs](/accounting/images/snelstart-transfers.png)

### 5. Fehlgeschlagene Übertragungen wiederholen

Fehlgeschlagene Übertragungen stehen unter **Letzte Fehler** mit Typ, Schlüssel (Auftrag, Kunde oder SKU), Anzahl der Versuche, der Fehlermeldung von SnelStart und dem Zeitpunkt.

1. Behebe die Ursache in SnelStart oder in X-Sitter (siehe Fehlermeldung).
2. Klicke in der Zeile auf **erneut**. Du siehst „Der Eintrag wird beim nächsten Lauf erneut übertragen“, und die Zeile verschwindet.
3. Der nächste Lauf des Jobs überträgt den Datensatz erneut.

![Screenshot: Karte „Letzte Fehler“ mit einem fehlgeschlagenen Artikel, seiner Fehlermeldung und dem Knopf „erneut“](/accounting/images/snelstart-errors.png)

## Felder und Optionen

### Status

| Feld | Bedeutung |
|---|---|
| **SnelStart aktiv** | **ja** = die Jobs übertragen Daten. **nein** = SnelStart ist für deine Firma ausgeschaltet; wende dich an den X-Sitter-Support. |
| **Länderfilter** | Lieferländer, deren Aufträge übertragen werden, z. B. Niederlande (NL). **alle Länder** = keine Einschränkung. |
| **Webhook-URL** | Adresse, an die SnelStart den Kopplungsschlüssel schickt. Gib sie in deinem API-Antrag bei SnelStart an. |

### Verbindung

| Feld | Bedeutung | Pflicht |
|---|---|---|
| **Subscription Key** | Primär- oder Sekundärschlüssel aus dem SnelStart Developer-Portal (Profil). | ja |
| **Kopplungsschlüssel (Client Key)** | Maatwerk: von dir in SnelStart Web unter *Koppelingen › Maatwerk* erzeugt. Productie: wird automatisch per Webhook befüllt. | ja, außer bei Anmeldung mit Benutzer und Passwort |
| **AppShortName** | Aus der Anmelde-Mail von SnelStart, Teil des Aktivierungslinks. Nur für die Productie-Kopplung; ohne ihn fehlt der Knopf **Kopplung aktivieren**. | nein |
| **SnelStart Benutzer (optional)** / **SnelStart Passwort (optional)** | Anmeldung mit Benutzername und Passwort, nur wenn kein Kopplungsschlüssel vorliegt. | nein |
| **API Basis-URL** | Adresse der SnelStart-API, `https://b2bapi.snelstart.nl/v2`. Lass sie, wie sie ist. | nein |

Die Spalte **Verbindung** der Seite markiert die Verbindung, die deine Firma standardmäßig nutzt, mit **Standard**. Ein Job nutzt diese Verbindung, solange im Job keine andere gewählt ist.

### Was die Jobs übertragen

| Job | Was er tut |
|---|---|
| **Bestellungen zu SnelStart senden** | Überträgt Aufträge der letzten Tage (Standard 30) mit dem gewählten Bestellstatus (Standard `sent`) als Verkaufsaufträge. Den Kunden sucht er in SnelStart über E-Mail-Adresse, Kundennummer oder Name – oder legt ihn immer neu an. Unbekannte Artikel werden angelegt, oder der Auftrag wird mit Fehler markiert. Optional kommen die Versandkosten als eigene Zeile mit eigenem Artikelcode dazu. Der SnelStart-Prozessstatus kann z. B. *Order* oder *Factuur* sein (erzeugt direkt eine Rechnung). Preise gehen brutto oder netto hinüber; nach einer Anzahl fehlgeschlagener Versuche (Standard 5) wird der Auftrag nicht mehr wiederholt. |
| **Artikel zu SnelStart senden** | Legt deine Artikel in SnelStart an, wenn es sie dort noch nicht gibt (Standard 500 je Lauf). Name und EAN kommen aus den Artikel-Attributen, der Preis aus der letzten Auftragsposition, die die SKU verkauft hat. Artikel, die es in SnelStart schon gibt, werden nur verknüpft. |

Diese Werte stellst du im Job ein.

## Gut zu wissen / Fehlerbehebung

- Jeden Übertragungsfehler kann X-Sitter dir auch per Telegram melden (Benachrichtigung **SnelStart - Fehler**), siehe [Telegram-Benachrichtigungen](/account/telegram-notifications.md).
- Ein einmal übertragener Auftrag wird nicht noch einmal übertragen. Ein fehlgeschlagener Datensatz wird bei jedem Lauf wiederholt, bis die Höchstzahl an Versuchen erreicht ist; **erneut** setzt die Versuche zurück.

| Meldung | Ursache | Lösung |
|---|---|---|
| „Es ist keine SnelStart-Verbindung hinterlegt. …“ | Deine Firma hat keine Verbindung vom Typ SnelStart. | Leg sie wie in Schritt 1 beschrieben an. |
| „Subscription Key und Kopplungsschlüssel (oder Benutzerdaten) müssen hinterlegt sein“ | Die Verbindung ist unvollständig, z. B. weil die Kopplung noch nicht bestätigt ist. | Vervollständige die Verbindung oder schließe die Kopplung ab (Schritt 2). |
| „Die Echo-Anfrage an SnelStart ist fehlgeschlagen“ | SnelStart ist nicht erreichbar oder lehnt die Schlüssel ab. | Prüfe Subscription Key und Kopplungsschlüssel und teste erneut. |
| „Diese Verbindung gehört nicht zu deiner Firma“ | **Kopplung aktivieren** wurde für eine Verbindung geklickt, die eine andere Firma mit deiner geteilt hat. | Kopple die Verbindung in der Firma, der sie gehört. |
| Ein Zähler unter **Fehler** wächst | SnelStart hat Datensätze abgelehnt, z. B. weil ein Pflichtfeld fehlt. | Lies die Meldung unter **Letzte Fehler**, behebe die Ursache und klicke auf **erneut**. |
| **SnelStart aktiv: nein** | SnelStart ist für deine Firma nicht eingeschaltet. | Wende dich an den X-Sitter-Support. |
| Unter **Jobs** steht kein Job | Die SnelStart-Jobs sind noch nicht angelegt. | Lege sie unter **Administration › Jobs & Verbindungen** › **Neuer Job** an, Gruppe **SnelStart** (die SnelStart-Seite verlinkt dorthin). |