SnelStart koppelen | Helpcentrum

Wat je nodig hebt

De rol Admin of Member in je organisatie. Viewers hebben geen toegang tot Koppelen. Zie Wie mag koppelen?.
Tweestapsverificatie (2FA) op je APIboard-account.
Een vrije plek in je pakket: Proefperiode en Basis 3 koppelingen, Team 7, Pro 10 (plus eventueel een gekochte extra koppeling).
Een SnelStart-account waarmee je de administratie kunt openen op web.snelstart.nl.
SnelStart inZicht of inControle. SnelStart geeft de maatwerkkoppeling alleen vrij vanaf die pakketten. Heeft je administratie een ander pakket, dan kun je geen koppelsleutel maken of werkt de sleutel niet.

Verbinden

Ga in APIboard naar Koppelen > Koppelingen.
Zoek SnelStart bij Beschikbare koppelingen (of typ de naam in het zoekveld) en klik op de kaart. Er opent een venster dat je stap voor stap begeleidt.
Log in op web.snelstart.nl met een account dat bij de administratie kan en ga naar Koppelingen.
Open de tegel Maatwerk en klik op sleutel genereren. Kopieer de sleutel.
Plak de sleutel in het veld Koppelsleutel in APIboard. Vul eventueel een naam voor de koppeling in.
Klik op Koppelen.
APIboard haalt direct de eerste gegevens op. Op Koppelen > Koppelingen staat de pil Bezig met ophalen… tot de eerste volledige ronde klaar is; daarna staat er Actief.

Eén sleutel per administratie

Een koppelsleutel hoort bij één SnelStart-administratie. Heb je meer administraties, maak dan voor elk een eigen sleutel en koppel ze apart (binnen de koppelingenlimiet van je pakket). Dezelfde administratie kun je niet twee keer koppelen: plak je opnieuw een sleutel van een administratie die al gekoppeld is, dan werkt APIboard de sleutel van die koppeling bij.

Per administratie kan er in SnelStart maar één maatwerkkoppeling zijn. Maak je in SnelStart een nieuwe sleutel, dan vervalt de vorige. Een bestaande koppeling in APIboard werkt dan niet meer tot je de nieuwe sleutel invoert met Opnieuw verbinden.

APIboard leest alleen. Er wordt nooit iets in je SnelStart-administratie gewijzigd.

Welke gegevens je krijgt

Onderwerp	Tabellen
Boekhouding	Grootboekrekeningen, Dagboeken, Kostenplaatsen, Grootboekmutaties, Btw-aangiftes
Verkoop	Verkoopfacturen, Verkooporders, Verkooporderregels
Inkoop	Inkoopfacturen
Bank en kas	Kas- en bankboekingen, Kas- en bankboekingsregels
Relaties en artikelen	Relaties, Artikelen, Artikelomzetgroepen
Beheer	Administratie

Codes en soorten komen ook als leesbare tekst mee (de kolommen met _label). Je vraagt de gegevens op via de API en ziet ze in de Datawerkbank.

De tabel Btw-aangiftes vult alleen als SnelStart je sleutel daarvoor toestemming geeft. Is dat niet zo, dan blijft de tabel leeg en probeert APIboard het een dag later opnieuw.

Wat we niet ophalen

Documenten en bijlagen haalt APIboard niet op. APIboard leest alleen en schrijft nooit iets terug naar SnelStart.

Hoe vaak vernieuwd

APIboard haalt de gegevens op per administratie, op de momenten die bij je pakket horen: Basis 1x per week, Team 1x per dag, Pro 3x per dag. Zie Hoe vaak worden gegevens vernieuwd?.

De eerste vulling van gegevens met een datum (zoals mutaties, facturen, bank- en kasboekingen en orders) begint op 1 januari van het jaar dat bij je pakket hoort: Proefperiode en Basis dit kalenderjaar, Team ook vorig jaar, Pro ook twee jaar terug. Stamgegevens (zoals relaties, grootboekrekeningen en dagboeken) worden altijd volledig opgehaald. Wat al is opgehaald, verwijdert APIboard niet als je pakket kleiner wordt.

Goed om te weten

Per administratie loopt er één synchronisatie tegelijk. SnelStart beperkt het aantal aanroepen; APIboard houdt zich daaraan en gaat zo nodig in een volgende ronde verder. De eerste vulling van een grote administratie kan daardoor langer duren.
Wijzigingen en verwijderingen. Een boeking die je in SnelStart aanpast, wordt in APIboard bijgewerkt, ook als SnelStart de onderliggende mutaties vervangt. Relaties, orders, facturen en mutaties die in SnelStart verdwijnen, markeert APIboard als verwijderd bij de bron. Dat gebeurt binnen de periode die bij je pakket hoort.
Artikelen. SnelStart geeft niet door of een artikel inactief of verwijderd is. APIboard haalt artikelen daarom wel op en werkt ze bij, maar markeert er geen als verwijderd.
Bij creditfacturen staan bedragen negatief, zoals SnelStart ze aanlevert.
Opnieuw verbinden vervangt alleen je koppelsleutel. De koppeling, alle opgehaalde gegevens en de syncstand blijven staan en de status gaat terug naar Actief. Gebruik een sleutel van dezelfde administratie; een sleutel van een andere administratie weigert APIboard. Je vindt Opnieuw verbinden in het zijpaneel dat opent als je op de kaart van de koppeling klikt.
Een koppeling verwijderen wist ook alle opgehaalde gegevens. Dat kan niet ongedaan worden gemaakt.

Problemen oplossen

Deze koppelsleutel werkt niet. Maak in SnelStart een nieuwe sleutel aan via Koppelingen, Maatwerk en plak die hier. De sleutel is verkeerd gekopieerd, is vervangen door een nieuwere of de administratie heeft geen inZicht of inControle. Controleer het pakket in SnelStart, maak een nieuwe sleutel en plak die.
Deze SnelStart-administratie is niet gevonden. SnelStart kent de administratie bij deze sleutel niet. Maak in SnelStart een nieuwe sleutel voor de juiste administratie.
SnelStart is tijdelijk niet beschikbaar voor nieuwe koppelingen. Probeer het later opnieuw.
SnelStart reageert nu niet. Probeer het over enkele minuten opnieuw.
De pil Fout bij de koppeling. De sleutel is vervangen of ingetrokken. Maak in SnelStart een nieuwe sleutel en gebruik Opnieuw verbinden.
Viewers kunnen geen koppelingen beheren. Je hebt de rol Viewer. Vraag een Admin van je organisatie om je de rol Member te geven, of om de koppeling te maken.
Je hebt je koppelingen-limiet bereikt voor je pakket. Kies Bekijk abonnementen om te upgraden, of koop een extra koppeling.
Een tabel is leeg. Bij Btw-aangiftes kan dat komen doordat SnelStart de toegang niet geeft. Bij andere tabellen: de administratie heeft er (in de periode van je pakket) nog niets in staan.

Meer meldingen staan bij Veelvoorkomende koppelfouten.