Twinfield 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 Twinfield-account dat toegang heeft tot de administratie die je wilt koppelen.
Tijd voor de eerste vulling: bij Twinfield kan die soms uren duren. Het gebeurt op de achtergrond; je hoeft niet te wachten.

Verbinden

Ga in APIboard naar Koppelen > Koppelingen.
Zoek Twinfield 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.
Klik op Verbind met Twinfield. Je gaat naar de inlogpagina van Twinfield.
Log in met het Twinfield-account dat toegang heeft tot de administratie en geef APIboard toestemming.
Kies de administratie die je wilt koppelen, als je er meerdere hebt (zie hieronder).
APIboard haalt direct de eerste gegevens op (Data wordt opgehaald…). Daarna zie je Verbonden met Twinfield, met de dashboards die klaarstaan. Op Koppelen > Koppelingen staat de pil Bezig met ophalen… tot de eerste volledige ronde klaar is; daarna staat er Actief.

Account of administratie kiezen

Heeft je login meerdere administraties, dan zie je Kies je administratie met de tekst “We vonden meerdere administraties bij je Twinfield-account. Kies welke je aan APIboard wilt koppelen.” Al gekoppelde administraties staan niet in de lijst; zijn ze allemaal gekoppeld, dan zie je “Alle beschikbare accounts zijn al gekoppeld.” Is er precies één administratie, dan zie je Koppeling bevestigen. Je kunt daar een Naam voor deze koppeling invullen en klikt op Koppelen of Bevestigen. Kies je niets, dan meldt APIboard “Kies een account.”

Meer administraties koppelen? Open de kaart van de koppeling en klik op + Account toevoegen (of kies Meer opties > Account toevoegen). In het venster kies je een administratie van een login die al gekoppeld is, zonder opnieuw in te loggen (onder het kopje Via Twinfield), of je kiest Ander account koppelen om met een andere login in te loggen. Elke administratie telt mee als account in je pakket.

Welke gegevens je krijgt

Onderwerp	Tabellen
Boekingen	Journaalposten, Transacties, Grootboeksaldi per periode (wordt berekend uit de journaalposten)
Relaties	Klanten, Leveranciers
Inrichting	Grootboekrekeningen, Kostenplaatsen, Projecten, Dagboeken, Btw-codes, Rapportagestructuren
Budgetten	Budgetten

Je vraagt de gegevens op via de API en ziet ze in de Datawerkbank. Alle tabellen en velden staan in de API-documentatie van Twinfield.

Hoe vaak vernieuwd

Stamgegevens worden bijgewerkt op basis van wat in Twinfield is gewijzigd. Journaalposten en transacties worden in de eerste vulling per boekjaar en periode opgehaald; daarna haalt APIboard alleen wijzigingen op en verwerkt het ook wat in Twinfield is verwijderd. Budgetten worden in de eerste ronde voor alle jaren van je pakket opgehaald, daarna alleen voor het huidige en vorige jaar (op de 1e van de maand weer volledig).

De eerste vulling van gegevens met een datum (zoals facturen, uren of mutaties) 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 of rekeningen) worden altijd volledig opgehaald. Wat al is opgehaald, verwijdert APIboard niet als je pakket kleiner wordt.

Hoe vaak dat gebeurt, hangt af van je pakket (Proefperiode, Basis, Team of Pro): zie Hoe vaak worden gegevens vernieuwd?.

Goed om te weten

De eerste vulling kan bij Twinfield soms uren duren. Twinfield beperkt het aantal aanroepen per minuut sterk, en APIboard houdt zich daaraan. De pil Bezig met ophalen… blijft zolang staan.
Is een administratie erg groot, dan kan het verversen van de grootboeksaldi per periode mislukken. Na meerdere pogingen krijgt APIboard daar zelf een melding van.
Upgrade je je pakket, dan vult APIboard de oudere jaren later aan.
Opnieuw verbinden vervangt alleen je inloggegevens. De koppeling, alle opgehaalde gegevens en de syncstand blijven staan, de status gaat terug naar Actief en de volgende synchronisatie haalt alleen wijzigingen op. Het verbindscherm opent direct, zonder bevestigingsvraag. Je logt opnieuw in bij Twinfield en geeft toestemming. Log je in met een ander account, dan weigert APIboard dat met de melding “Dit is een ander account dan de koppeling die je opnieuw verbindt. Log in met hetzelfde account.” Dan is het een nieuwe koppeling. Tijdens een lopende synchronisatie kan de melding “Twinfield wordt op dit moment gesynchroniseerd. Probeer het over een minuut opnieuw.” verschijnen; probeer het dan zo opnieuw.
Je vindt Opnieuw verbinden (pijlicoon) in het zijpaneel dat opent als je op de kaart van de koppeling klikt.
Een koppeling of account verwijderen (Koppeling verwijderen of het verwijderpictogram bij een account) wist ook alle opgehaalde gegevens. Dat kan niet ongedaan worden gemaakt.

Problemen oplossen

Koppelen mislukt. Controleer je gegevens en probeer het opnieuw. Dit is de standaardmelding. Meestal heeft het gebruikte Twinfield-account geen toegankelijke administratie, of is de toestemming niet volledig gegeven. Probeer het opnieuw met een account dat een administratie kan openen.
Je hebt geen toestemming gegeven. Probeer opnieuw en accepteer de gevraagde rechten. Je hebt in het venster van Twinfield de toestemming geweigerd. Start de koppeling opnieuw en geef APIboard toestemming.
OAuth-sessie verlopen, probeer opnieuw te verbinden. Je deed er langer dan 10 minuten over. Start de koppeling opnieuw en rond hem in één keer af.
Zoeken is niet gelukt. Probeer het later opnieuw. Of Toevoegen is niet gelukt. Probeer het later opnieuw. Dit komt bij Account toevoegen voor. Probeer het later opnieuw; houdt het aan, neem dan contact op met support.
Kon geen popup-venster openen. Sta pop-ups toe voor deze site. Sta pop-ups toe voor APIboard in je browser en klik opnieuw op Verbind met Twinfield.
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.
Dit account is al gekoppeld. Wat je probeert te koppelen, staat al in je organisatie. Zoek het op onder Koppelen > Koppelingen.
Je hebt je koppelingen-limiet bereikt voor je pakket. (of Je hebt je accounts-limiet bereikt voor je pakket.) Kies Bekijk abonnementen om te upgraden, of koop een extra koppeling of extra account.
De pil Fout bij de koppeling. Een synchronisatie is mislukt of de toegang is verlopen of ingetrokken. APIboard probeert het bij een tijdelijke fout later zelf opnieuw; bij een verlopen toegang gebruik je Opnieuw verbinden.