Met de Yuki-verbinding in FinWizer wordt data (Administraties, Gebruikers, Toegang) automatisch uitgelezen via de Yuki API. De verbinding wordt per Yuki-portaal opgezet. Heb je meerdere portalen? Dan maak je voor elk portaal een aparte verbinding aan in FinWizer. Daarbij geef je aan welk portaal het hoofdportaal is en welke portalen als subportaal hieraan gekoppeld zijn.
Voor het ophalen van verbruiksdata — zoals actieve licenties per administratie — kan een aanvullende upload van de Yuki-factuurspecificatie gedaan worden. Dit wordt toegelicht in stap 3.
Voor het aanmaken van een API-sleutel in Yuki heb je een account nodig met de rol Portaalbeheerder.
De API-sleutel moet minimaal toegang hebben tot de webservices
De verbinding is nu actief en FinWizer begint automatisch met het ophalen van de data. Controleer of de verbinding succesvol is geautoriseerd via de melding Verbinding succesvol geautoriseerd op de verbindingspagina. Herhaal deze stappen voor elk Yuki-portaal dat je wil koppelen.
De Yuki API geeft geen details over actieve licenties per administratie. Om deze verbruiksdata toch beschikbaar te maken in FinWizer, upload je de Yuki-factuurspecificatie als CSV-bestand.
De verbruiksdata uit de factuurspecificatie wordt verwerkt voor zowel het hoofdportaal als alle gekoppelde subportalen.
Met de Basecone-verbinding in FinWizer wordt data (Administraties, Gebruikers, Toegang, Verbruik) automatisch uitgelezen via de Basecone API.
Voor het autoriseren van de verbinding heb je de volgende Basecone-gegevens nodig:
De verbinding is nu actief en FinWizer begint automatisch met het ophalen van de data. Controleer of de verbinding succesvol is geautoriseerd via de melding Verbinding succesvol geautoriseerd op de verbindingspagina.
Met de Visionplanner-verbinding in FinWizer kun je de verbruiksdata uit Visionplanner bijhouden per klant. De data wordt aangeleverd door periodiek een CSV-factuurspecificatie te uploaden uit Visionplanner.
De data wordt verwerkt en is na de upload beschikbaar in FinWizer.
Heeft jouw applicatie nog geen automatische koppeling met FinWizer? Dan zijn er drie manieren om data te importeren: Manual Import, Manual Import CRM en Custom API. In dit artikel lees je wanneer je welke optie gebruikt en hoe je ermee aan de slag gaat.
| Optie | Geschikt voor | Methode | |
| Manual Import | Administraties, gebruikers en verbruik | Excel-upload per periode | |
| Manual Import CRM | CRM-data als basis voor combinaties | Excel-upload, niet periodegebonden | |
| Custom API | Geautomatiseerde import van administraties en gebruikers | API-koppeling |
Voor alle drie de opties maak je eerst een verbinding aan in FinWizer:
Met de Manual Import laad je via een Excel-template periodieke data in voor een applicatie. Per periode kunnen administraties, gebruikers en verbruiksdata worden geïmporteerd.
De Manual Import past de volgende logica toe: zolang er geen nieuwe data wordt geïmporteerd, blijven de beschikbare administraties en gebruikers onveranderd in de daaropvolgende perioden. Wordt er wél data geïmporteerd voor een nieuwe periode, dan wordt elke administratie of gebruiker die niet voorkomt in de nieuwe import als verwijderd beschouwd vanaf die periode. Verbruiksdata is periode specifiek en moet per periode opnieuw worden aangeleverd.
De Manual Import CRM is specifiek bedoeld voor het importeren van CRM-data die als basis dient voor FinWizer-combinaties. De geïmporteerde data is niet gebonden aan een specifieke periode. De template heeft een iets andere opzet dan de reguliere Manual Import: naast administratiegegevens kunnen ook extra velden worden meegegeven, zoals tags en referenties.
Met de Custom API stel je een geautomatiseerde verbinding in waarmee administraties en gebruikers kunnen worden aangeleverd. Dit is de aangewezen optie als je de import wilt automatiseren vanuit een eigen systeem of script.
De beschikbare endpoints en technische documentatie zijn te vinden op: Custom API documentatie