In dit artikel lees je hoe je de status van ingediende btw-aangiften vanuit Yuki kunt doorsturen naar AdminPulse. Met deze koppeling kan AdminPulse automatisch een taak of deeltaak voor de btw-aangifte op Klaar zetten.
De algemene Yuki-koppeling wordt niet in dit artikel uitgelegd. Meer uitleg over het instellen van de Yuki-koppeling vind je in: Yuki.
Voor je begint
Zorg ervoor dat de Yuki-koppeling in AdminPulse is ingesteld. Voor deze specifieke functionaliteit heb je ook de API-sleutel uit het Yuki-portaal nodig.
In Yuki vind je deze API-sleutel via het tandwiel rechtsboven: Instellingen > Webservices. Maak daar een nieuwe API-sleutel aan via + Voeg nieuwe API-sleutel toe.
Meer uitleg over webservices in Yuki vind je in de documentatie van Yuki: Waar vind ik in Yuki de API-sleutel en de Administratie-ID?
Status van ingediende btw-aangiften doorsturen naar AdminPulse
Om de status van ingediende btw-aangiften vanuit Yuki door te sturen naar AdminPulse, moet je in AdminPulse de juiste optie activeren in de Yuki-koppeling.
- Ga naar Algemene instellingen > Software koppelingen.
- Klik op Yuki.
- Vul bij PortaalApiKey de API-sleutel in die je in Yuki hebt aangemaakt voor de btw.
- Vink Sync VAT Listings from Yuki aan.
Taskflow instellen
De status van een ingediende btw-aangifte in een domein in Yuki wordt via de koppeling met Yuki doorgestuurd naar AdminPulse. Door een taskflow in te stellen, kun je de bijbehorende taak of deeltaak voor de btw automatisch op Klaar laten zetten.
- Ga naar Instellingen > Taskflow instellingen.
- Klik op +Toevoegen.
- Selecteer bij Start gebeurtenis: BTW-aangifte ingediend - Yuki.
- Selecteer de hoofdtaak en deeltaak voor de btw-aangifte.
- Selecteer de nieuwe status voor deze taak of deeltaak, bijvoorbeeld Klaar.
- Stel het begin van het zoekgebied in op 0 dagen en het einde van het zoekgebied op 30 dagen. Zo zoekt AdminPulse naar de btw-taak met een deadline van maximaal één maand na de datum van het btw-document.
👉 Let op: de datum in het aangiftetijdvak in het btw-document wordt gebruikt als documentdatum. Gaat het bijvoorbeeld om oktober 2022, dan wordt de documentdatum in AdminPulse 31-10-2022.
Hoe werkt dit?
Zodra de btw-aangifte in Yuki de status Afgesloten (historisch) heeft, wordt deze status doorgestuurd naar AdminPulse.
Uiterlijk één dag later zet AdminPulse, op basis van de ingestelde taskflow, de status van de gekoppelde taak of deeltaak automatisch op Klaar.
Taaksjabloon
Als de Yuki-koppeling is ingesteld, kun je gebruikmaken van het taaksjabloon BTW-aangifte (Yuki) in de bijlage. Dit kan een goede basis zijn om de juiste taakstructuur op te zetten.
💡 Goed om te lezen
- Wil je meer weten over het instellen van de algemene Yuki-koppeling in AdminPulse? Lees dan: Yuki.
- Wil je weten waar je in Yuki de API-sleutel en Administratie-ID vindt? Meer uitleg vind je in: Waar vind ik in Yuki de API-sleutel en de Administratie-ID?.