Met de Fiscaal Gemak-verbinding in FinWizer wordt data (Administraties) automatisch uitgelezen via de Fiscaal Gemak API.
Vereisten
Voor het aanmaken van een API-koppeling heb je toegang nodig tot de beheeromgeving van Fiscaal Gemak.
Let op: De API-sleutel is maximaal één jaar geldig. Na het verlopen van de sleutel dient een nieuwe sleutel te worden aangemaakt en de verbinding in FinWizer te worden bijgewerkt.
Stap 1: API-koppeling aanmaken in Fiscaal Gemak
- Log in op Fiscaal Gemak en ga naar Uw account → Instellingen → Koppelingen → API-koppelingen.
- Klik op + API-koppeling toevoegen.
- Vul de volgende gegevens in:
- Naam — kies een herkenbare naam, bijv. FinWizer
- Omschrijving — bijv. Koppeling met FinWizer
- Gekoppelde gebruiker — selecteer de gebruiker waaronder de koppeling wordt aangemaakt
- Klik op Opslaan.
- Ga naar het tabblad Sleutel en klik op Sleutel toevoegen.
- Kopieer het gegenereerde ID en de Sleutel en sla deze veilig op. Let op: De sleutel is na het sluiten van dit venster niet meer te bekijken. Vink Ik heb de sleutel bewaard aan voordat je op OK klikt.
Noteer ook de API-URL van jouw omgeving. Deze is afhankelijk van de omgeving waarmee je inlogt:
- Inloggen via
app.fiscaalgemak.nl → API-URL: https://api-app.fiscaalgemak.nl
- Inloggen via
app2.fiscaalgemak.nl → API-URL: https://api-app2.fiscaalgemak.nl
- Inloggen via
app3.fiscaalgemak.nl → API-URL: https://api-app3.fiscaalgemak.nl
Stap 2: Verbinding aanmaken in FinWizer
- Ga in het linkermenu naar Verbindingen en klik rechtsonder op Verbinding toevoegen.
- Selecteer Fiscaal Gemak (in de categorie Fiscaal).
- Pas eventueel de applicatienaam aan of voeg een omschrijving toe.
- Vul de volgende gegevens in:
- API URL — de URL van jouw Fiscaal Gemak-omgeving (zie stap 1)
- API Key — de sleutel uit stap 1
- Klik op Bevestig.
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.
