Data importeren zonder automatische verbinding

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.

Verbinding aanmaken

Voor alle drie de opties maak je eerst een verbinding aan in FinWizer:

1. Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
2. Selecteer de gewenste optie: Manual Import, Manual Import CRM of Custom API.
3. Vul een herkenbare applicatienaam en optioneel een omschrijving in en klik op Bevestig.

Manual Import

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.

1. Open de aangemaakte verbinding en ga naar het tabblad Verbinding.
2. Klik op Download template om de Excel-template op te halen.
3. Vul de template in met de juiste gegevens.
   1. • Id en Name zijn verplichte velden; het Id moet een unieke waarde zijn.
      • Het veld Amount in de verbruikstabel geeft de producttelling aan en moet een geheel getal zijn.
4. Ga naar het tabblad Facturen, zoek de juiste periode op en upload het ingevulde bestand via het upload-icoon naast de betreffende periode.

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.

Manual Import CRM

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.

1. Open de aangemaakte verbinding en ga naar het tabblad Verbinding.
2. Klik op Download template om de Excel-template op te halen.
3. Vul de template in met de gewenste administraties, inclusief eventuele tags en referenties.
4. Klik op Gegevens uploaden om het bestand te importeren.

Custom API

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.

1. Open de aangemaakte verbinding. Onder Verbinding autorisatie vind je de gegenereerde API key.
2. Kopieer de API key en sla deze veilig op.
   Let op: De API key wordt maar eenmalig getoond. Is de key kwijtgeraakt? Klik dan op Maak nieuwe API key aan om een nieuwe te genereren. De oude key komt daarmee te vervallen.
3. Gebruik de API key voor de authenticatie in jouw integratie.

De beschikbare endpoints en technische documentatie zijn te vinden op: Custom API documentatie