SnelStart

Aufträge, Kunden und Artikel an die niederländische Buchhaltungssoftware SnelStart übertragen – Verbindung einrichten, mit SnelStart koppeln und die Übertragungen im Blick behalten.

SnelStart 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“

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. 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

Öffne Administration › Jobs & Verbindungen, klicke auf Verbindungen und dann auf Neue Verbindung – siehe Jobs & Verbindungen.
Wähle den Typ SnelStart und trag eine Bemerkung ein, z. B. den Namen deiner Administration.
Trag den Subscription Key ein – den Primär- oder Sekundärschlüssel aus deinem Profil im SnelStart Developer-Portal.
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.
Klicke auf Speichern.

Screenshot: Verbindungsformular vom Typ SnelStart mit Subscription Key, Kopplungsschlüssel, AppShortName, Benutzer, Passwort und API Basis-URL

2. Verbindung mit SnelStart koppeln (nur Productie)

Öffne Buchhaltung › SnelStart.
Klicke in der Zeile der Verbindung auf Kopplung aktivieren. Der Knopf erscheint nur, wenn ein AppShortName hinterlegt ist.
X-Sitter leitet dich zu SnelStart Web weiter. Bestätige dort die Kopplung.
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.“
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

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.

Behebe die Ursache in SnelStart oder in X-Sitter (siehe Fehlermeldung).
Klicke in der Zeile auf erneut. Du siehst „Der Eintrag wird beim nächsten Lauf erneut übertragen“, und die Zeile verschwindet.
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“

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.

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.
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).