Met de integratie tussen TwinnTax en AdminPulse kan AdminPulse automatisch het laatst gekende saldo van de BTW-provisierekening ophalen uit TwinnTax en invullen in de juiste btw-taak.
Zo hoef je het bedrag niet meer manueel over te typen en vermijd je dubbele invoer of typfouten.
In dit artikel lees je hoe je de koppeling instelt en wanneer AdminPulse het saldo kan invullen.
Wat doet de TwinnTax-integratie?
AdminPulse haalt dagelijks het saldo van de BTW-provisierekening op uit TwinnTax. Daarna zoekt AdminPulse de relatie met hetzelfde ondernemingsnummer en vult het saldo in op de relevante openstaande btw-taak of btw-taken die het voorgedefinieerde veld BTW-provisierekening bevatten.
De koppeling is eenrichtingsverkeer: AdminPulse haalt alleen het saldo op uit TwinnTax. Er worden geen gegevens vanuit AdminPulse naar TwinnTax doorgestuurd en er worden geen andere gegevens uit TwinnTax gesynchroniseerd.
Voor je begint
Controleer eerst of je deze gegevens en rechten hebt:
- toegang tot TwinnTax met een actief account en abonnement;
- beheerrechten in TwinnTax om een API-koppeling aan te maken;
- toegang tot Instellingen > Geconnecteerde applicaties in AdminPulse;
- relaties in AdminPulse met een correct ingevuld ondernemingsnummer;
- een taaksjabloon met het voorgedefinieerde veld BTW-provisierekening.
AdminPulse rekent geen extra kosten aan voor deze koppeling.
Werk je met meerdere eigen bedrijven in AdminPulse? Dan stel je de koppeling per eigen bedrijf in.
De koppeling instellen
Stap 1: client-gegevens aanmaken in TwinnTax
Om de koppeling in AdminPulse te kunnen instellen, heb je eerst een Client ID en Client Secret uit TwinnTax nodig.
- Ga in TwinnTax naar Instellingen > Integraties > API instellingen.
- Maak een nieuwe OAuth API-sleutel aan.
- Geef de koppeling een herkenbare naam, bijvoorbeeld AdminPulse.
- Kies bij API Sleutel type voor AdminPulse en stel een vervaldatum in.
- Bewaar de Client ID en de Client Secret. Die heb je nodig in AdminPulse.
Stap 2: de koppeling activeren in AdminPulse
- Ga in AdminPulse naar Instellingen > Geconnecteerde applicaties.
- Zoek TwinnTax in de lijst met integraties en open de configuratie.
- Vul de Client ID en Client Secret in die je in TwinnTax hebt aangemaakt.
- Laat de optie Synchronize VAT balance from TwinnTax to AdminPulse actief. Die optie zorgt ervoor dat AdminPulse het saldo automatisch overneemt.
- Klik op Test connection om te controleren of de gegevens correct zijn.
- Klik op Save om de koppeling te bewaren.
👉 Krijg je een foutmelding bij het testen? Controleer dan eerst of de Client ID en Client Secret correct zijn overgenomen uit TwinnTax.
Taaksjabloon voorbereiden
AdminPulse kan het saldo alleen invullen op taken die het voorgedefinieerde veld BTW-provisierekening bevatten. Voeg dit veld daarom toe aan het taaksjabloon dat je voor je btw-aangiftes gebruikt.
- Ga naar Instellingen > Taaksjablonen.
- Open het taaksjabloon dat je voor de btw-aangifte gebruikt.
- Voeg een taakparameter toe van het type BTW-provisierekening (Velden openen > + Nieuw invulveld).
Staat dit veld al in je taaksjabloon? Dan hoef je hier niets extra te doen.
💡 In het verleden heette het voorgedefinieerde veld BTW-provisierekening nog Saldo BTW rekening courant.
Wanneer wordt het saldo ingevuld?
De synchronisatie gebeurt automatisch één keer per dag, 's nachts. Je hoeft ze dus niet manueel te starten. Een wijziging in TwinnTax is pas na de volgende synchronisatie zichtbaar in AdminPulse.
AdminPulse vult het saldo niet in op alle openstaande btw-taken. Bij elke synchronisatie kijkt AdminPulse naar de btw-taken die op dat moment relevant zijn:
- de openstaande btw-taak van de huidige periode, ook als de deadline maximaal 7 dagen verstreken is;
- de openstaande btw-taak van de volgende periode, als die al bestaat.
Daardoor kan AdminPulse het saldo op maximaal twee openstaande btw-taken invullen. Oudere taken worden overgeslagen.
Daarnaast moet aan deze voorwaarden voldaan zijn:
- de koppeling met TwinnTax is ingesteld en actief;
- de klant in TwinnTax heeft een btw-nummer en een saldo;
- er bestaat in AdminPulse een relatie met hetzelfde ondernemingsnummer;
- de btw-taak staat nog niet op Klaar;
- de btw-taak bevat het voorgedefinieerde veld BTW-provisierekening;
- het veld BTW saldo is nog leeg.
Is het veld BTW saldo al ingevuld? Dan slaat AdminPulse die taak over. AdminPulse gaat er dan van uit dat de btw-aangifte al gebeurd is.
👉 Wordt het saldo van de provisierekening niet ingevuld? Controleer dan eerst deze voorwaarden voordat je de koppeling opnieuw instelt.
💡 Goed om te lezen
Lees ook deze artikels voor meer uitleg over Admin-Connect, taakparameters en de berekening van btw-saldo’s: