Tweede nieuwe API zijn beschikbaar en open voor gebruik bij Fod Financiën: grotere efficiëntie en meer gemak !

API staat voor ‘Application Programming Interface’. Het is een manier om een verbinding te maken tussen twee of meerdere losstaande softwareprogramma’s. API’s zorgen zo voor interacties tussen toepassingen, gegevens en apparaten. Via API’s kunt u makkelijk gegevens uitwisselen tussen verschillende toepassingen omdat zij een aantal afspraken, technische codes en definities bevatten.

Denk hierbij bijvoorbeeld aan het gebruik van Payconiq wanneer u tickets voor een evenement boekt. Payconiq haalt de betaalinformatie op bij de website van het evenement en koppelt die aan uw bankapp. Of denk aan het inloggen met itsme: itsme gebruikt ook API’s om personen te identificeren en toegang te geven tot heel wat toepassingen van overheden, banken, enz

API’s zijn alomtegenwoordig en vereenvoudigen het leven van de digitale gebruiker aanzienlijk. Doordat één of meerdere systemen met elkaar interageren, moet de gebruiker heel wat minder clicks en acties uitvoeren voor eenzelfde resultaat. Vergelijk het met een supermarkt waar u alles op één plek vindt in plaats van voor ieder soort product naar een andere winkel te moeten gaan.

Als overheid streven we ook naar een zo eenvoudig en positief mogelijke digitale ervaring. We hebben wettelijk verankerd dat we onze interacties met burgers, rechtspersonen en derden zullen digitaliseren. We richten ons met onze API’s in eerste instantie enkel op de professionele gebruiker en nog niet op de gewone burger. Andere initiatieven zullen volgen.

Bij het gebruik van deze API’s zijn verschillende partijen betrokken.

1. De API is een technische verbinding tussen de FOD Financiën (partij 1) en het softwarepakket X (van softwareonderneming X) (partij 2) die een onderneming Y of accountant Y gebruikt.
2. De accountant Y of onderneming Y (partij 3) gebruikt een softwarepakket voor het uitvoeren van zijn administratieve taken.
   • Ofwel is die 3de partij een onderneming Y die software gebruikt om eigen gegevens te raadplegen en te verwerken.
   • Ofwel is die 3de partij een mandataris, zoals een accountant Y, die de software gebruikt voor het behandelen van administratieve taken voor een eindklant Z (partij 4).
   • Het is dus die 3de partij die als eindgebruiker van een softwarepakket X gebruik zal kunnen maken van de functionaliteiten geboden door de opgezette API-verbinding.

Zoals hierboven gesteld, is er niet altijd een 4de partij. In sommige gevallen is er zelf geen 3de partij en zijn partijen 2, 3 en 4 dus dezelfde entiteit. Dat is het geval als een onderneming X eigen software heeft ontwikkeld en gebruik maakt van de API’s om eigen gegevens te raadplegen en verwerken

Het gebruik van de API’s staat open voor elke onderneming die:

• software ontwikkelt om dossiers en/of gegevens te bundelen, structureren, visualiseren, vereenvoudigen en/of automatiseren, en
• die software aanbiedt aan de professionele ondernemingen of die software zelf intern gebruikt.

Om een beveiligd gebruik te verzekeren, moet u:

1. uw onderneming registreren als erkende gebruiker, en
2. de bijhorende gebruikersovereenkomst aanvaarden.

U kunt de API’s pas aan uw software koppelen nadat u de registratie als erkende gebruiker hebt voltooid. Het is aan de wettelijke vertegenwoordiger om het registratieproces op te starten. Het registreren van uw onderneming is mogelijk via MyMinfin.

Volg deze stappen om uw onderneming te registreren:

1. Log in op MyMinfin.
   
2. Ga naar ‘Mijn professionele toepassingen’ en klik op ‘Aanvraag tot registratie van mijn onderneming als een erkende gebruiker van de API’s van de FOD Financiën’.
3. Vul de velden in en duid hier één of meerdere contactpersonen aan. Klik vervolgens op ‘verzenden’.
4. Opgelet: Als uw onderneming zich wilt registreren voor het gebruik van de Intervat-API, is een registratie voor beide API’s aangewezen. Om na indiening van de aangifte de ontvangstbevestiging te kunnen ophalen via API, moet de MMF-API namelijk worden gebruikt. Selecteer daarom beide API’s op het registratieformulier.
   Opgelet: Het is belangrijk om de juiste contactpersoon of contactpersonen in het formulier op te lijsten: zij krijgen toegang tot de technische documentatie en ontvangen de gegevens die nodig zijn om de API’s correct te koppelen aan de eigen software. Daarnaast krijgen zij toegang tot het technisch ondersteuningsportaal waar ze, na succesvolle integratie, ook de validatietesten kunnen aanvragen. De contactpersoon is dus best eerder een technisch profiel, iemand die instaat voor de technische integratie van de API(‘s).
5. U ontvangt enkele dagen later als wettelijke vertegenwoordiger een bericht in MyMinfin met daarin de te tekenen gebruikersovereenkomst en de technische documentatie. Neem de gebruikersovereenkomst grondig door en keur die goed/onderteken die door het aanvinken van het vakje in de begeleidende brief.
6. Bij ontvangst van de getekende overeenkomst, nemen wij intern verdere stappen om uw onderneming finaal te registreren. Wanneer de registratie is afgerond, nemen wij contact op met de door u opgegeven contactpersoon of contactpersonen.
7. De registratie is bij deze afgerond en uw onderneming kan het nodige doen om de API’s met uw software te integreren.

Opgelet: de registratie zorgt ervoor dat uw onderneming erkend wordt als gebruiker en toegang krijgt tot de technische documentatie en het API-ondersteuningsportaal. Dit wil niet zeggen dat uw onderneming die API’s al in productie kan en mag gebruiken. Voor het gebruik in productie moet uw onderneming de API’s eerst succesvol integreren en vervolgens een validatietest aanvragen via het technisch API-ondersteuningsportaal.

Ik ben een (software)onderneming – waar kan ik de technische informatie terugvinden?

De technische documentatie die nodig is om de API-koppeling te kunnen maken, staat niet openbaar en wordt enkel verstrekt binnen de registratieprocedure. Vanaf eind februari 2025 kan uw wettelijke vertegenwoordiger die procedure opstarten. U vindt meer informatie bij ’Ik ben een softwareonderneming – hoe kan ik de API’s koppelen?’.

Enkel wanneer u gebruik maakt van een softwarepakket dat de API(‘s) heeft gekoppeld, kunt u de extra functionaliteiten die voortkomen uit de API-koppeling gebruiken. U moet dus klant zijn van een geregistreerde softwareonderneming. Als uw onderneming eigen software heeft en die wilt koppelen, kan dat natuurlijk ook.

Softwareondernemingen kunnen zich sinds eind februari 2025 registreren via MyMinfin om de API aan hun software te koppelen. Na succesvolle testen met hen, zullen deze functionaliteiten voor hun klanten beschikbaar zijn. De klant zal hierover actief worden geïnformeerd en zal tegelijkertijd ook gevraagd worden om goedkeuring te geven en een aantal zaken te bevestigen aan de FOD Financiën via het daarvoor voorziene mechanisme.

In een later stadium publiceren we hier een lijst van alle softwareondernemingen met wie de API-koppeling succesvol is opgezet.

U kunt zich richten tot de klantendienst van uw softwarepakket voor meer informatie

Op dit moment richten we ons enkel op professionele gebruikers zoals accountants en ondernemingen. Als burger kunt u hier op dit moment nog geen gebruik van maken.