💡Deze pagina is ook van toepassing op de intracommunautaire lijst en de jaarlijkse listing van de btw-plichtige klanten.
In Mercator is het mogelijk om de maandelijkse of driemaandelijkse btw-aangifte te verzenden via de Intervat-site van de de (Belgische) Administratie. Hiervoor is geen enkele voorafgaande certificeringsprocedure vereist en het gebruik is bijzonder eenvoudig.
De btw-aangifte wordt op de klassieke manier opgesteld. Op het laatste tabblad kunt u via een Intervat-knop een XML-bestand genereren voor de actuele aangifte. Dit bestand wordt opgeslagen in de subdirectory INTERVAT van de Mercator-directory DATA.
Zodra het bestand opgemaakt is, start Mercator automatisch de internetverkenner op de Intervat-portaalsite van de Administratie.
Vanaf Mercator versie 12: aangiften verzenden via de API van de FOD Financiën
Vanaf Mercator 12.0 (MercatorUi.dll min. versie: 12.0.703) is het mogelijk om de hierboven vermelde btw-aangiften te verzenden zonder ze handmatig te moeten uploaden naar het Intervat-portaal. Om van deze mogelijkheid gebruik te maken, moet het menu "Boekhouding / BTW / API autoriseren" worden uitgevoerd. Hierbij wordt gevraagd om verbinding te maken met het portaal van de FOD Financiën door een persoon die bevoegd is om de btw-plichtige te vertegenwoordigen. Deze autorisatie wordt door Mercator op gebruikersniveau bewaard. Ze is gebaseerd op OAuth2.0.
Zodra de registratie met succes is voltooid, verschijnt in de schermen van de btw-aangiften een knop "Via API", waarmee de aangifte die momenteel wordt bewerkt, wordt verzonden.
💡 De registratie kan alleen worden uitgevoerd door een persoon die hiervoor daadwerkelijk gemachtigd is (bestuurder van een vennootschap of houder van een btw-nummer). Het toekennen van een eenvoudige rol (in de zin van de machtigingen die via MyMinFin kunnen worden verleend), waarmee een medewerker die zelf geen mandataris is handmatig btw-aangiften kan indienen via Intervat, volstaat niet. Dit recht kan vervolgens intern in Mercator aan de medewerker worden toegekend via zijn gebruikersprofiel, door gebruik te maken van het veld "API van de FOD Financiën gebruiken namens" op het tabblad "Profiel / Boekhouding".
⚠️ Het OAuth2.0-proces is gebaseerd op de uitwisseling van tokens met de servers van de FOD Financiën. Hiervoor is uiterlijk om de 7 dagen een vernieuwing vereist. Bij elke login controleert Mercator of het token van de gebruiker tijdens de huidige dag werd gegenereerd. Indien dit niet het geval is, wordt de vernieuwing volledig transparant uitgevoerd. Als de gebruiker gedurende 7 dagen of langer niet inlogt, moet hij de oorspronkelijke registratieprocedure opnieuw uitvoeren. Om deze situatie te vermijden, wordt aanbevolen om via de consolemodus van Mercator een geplande taak in te stellen die de volgende code uitvoert:
using System.Threading.Tasks;
namespace Main
{
public class Customizer
{
public async Task RenewAllMinFinBeTokensAsync()
{
string logEntry = await MercatorUi.Forms.Accounting.AccountingMinFinBe.AccountingMinFinBe.RenewAllTokensAsync();
MercatorUi.Globals.MercatorTasksToMain.Log(logEntry);
}
}
}
Het gebruik van deze dienst is onderworpen aan de aanvaarding van deze bijzondere voorwaarden, die worden weergegeven wanneer de gebruiker de functionaliteit activeert.
1. Doel van de dienst
Mercator ERP biedt voor bepaalde functionaliteiten toegang tot de platformen van de FOD Financiën via de door de FOD ter beschikking gestelde application programming interfaces (“API’s”). Deze functionaliteiten kunnen onder meer de authenticatie bij de FOD Financiën, de verzending van aangiften of documenten en de raadpleging van informatie die op zijn platformen beschikbaar is, mogelijk maken.
Het gebruik van deze functionaliteiten is onderworpen aan deze voorwaarden en aan de voorwaarden en regels die van toepassing zijn op de betrokken platformen van de FOD Financiën.
2. Rol van INEO en de FOD Financiën
INEO SRL, uitgever van Mercator ERP, treedt op als erkende gebruiker van de API’s van de FOD Financiën en staat in voor de technische integratie ervan in Mercator ERP.
De FOD Financiën biedt de gebruiker van Mercator ERP geen rechtstreekse ondersteuning met betrekking tot het gebruik van deze integratie of de API’s. Voor elk probleem met de werking van de integratie tussen Mercator ERP en de platformen van de FOD Financiën moet de gebruiker zich in eerste instantie wenden tot de Mercator-support of, indien van toepassing, tot zijn erkende Mercator-verdeler.
De informatie afkomstig van de FOD Financiën die in Mercator ERP wordt weergegeven, wordt aangeboden via de door INEO SRL gerealiseerde integratie.
3. Juistheid van de gegevens van de FOD Financiën
Wanneer een gebruiker een fout of een ontbrekend gegeven vaststelt in gegevens afkomstig van de FOD Financiën, moet hij dit melden aan de FOD Financiën via de officiële kanalen, met name via het algemene contactformulier.
INEO SRL kan gegevens waarvan de FOD Financiën de bron is, niet wijzigen of corrigeren.
4. Beveiliging van de toegang
De gebruiker moet alle redelijke maatregelen nemen om de middelen te beschermen waarmee via Mercator ERP toegang wordt verkregen tot de diensten van de FOD Financiën.
Zodra de gebruiker vaststelt of vermoedt dat een toegang mogelijk gecompromitteerd is, bijvoorbeeld als gevolg van verlies of diefstal van een computer, ongeoorloofde toegang tot zijn IT-omgeving of enig ander beveiligingsincident, moet hij INEO SRL daarvan zo snel mogelijk op de hoogte brengen, zodat de nodige maatregelen kunnen worden genomen, waaronder het blokkeren van de toegang tot de betrokken API’s.
De gebruiker verbindt zich ertoe het gebruik van de met de FOD Financiën verbonden diensten niet toe te staan aan personen die niet gemachtigd zijn om de betrokken verrichtingen uit te voeren.
5. Logging van de verrichtingen
Overeenkomstig de vereisten van de FOD Financiën implementeert INEO SRL een audittrail waarmee de via de API’s uitgevoerde verrichtingen kunnen worden gereconstrueerd.
Daartoe wordt bepaalde informatie over het gebruik van de dienst geregistreerd, waaronder de identiteit van de gebruiker, de betrokken onderneming, de datum en het tijdstip van de verrichting, de geraadpleegde dienst of API, het type verrichting, het resultaat ervan en de authenticatie- en verbindingspogingen of -fouten.
Deze informatie wordt gedurende ten minste 12 maanden bewaard, onder meer om te kunnen voldoen aan verzoeken om audit, controle of onderzoek zoals voorzien door de FOD Financiën.
Deze logging heeft niet tot doel een kopie te bewaren van de aangiften of documenten die aan de FOD Financiën worden verzonden.
6. Bescherming van persoonsgegevens
Het gebruik van de verbonden diensten kan de verwerking met zich meebrengen van persoonsgegevens die noodzakelijk zijn voor de authenticatie, de uitvoering van de gevraagde verrichtingen, de beveiliging ervan en de naleving van de door de FOD Financiën opgelegde loggingverplichtingen.
INEO SRL beperkt de in zijn audittrail geregistreerde gegevens tot wat voor deze doeleinden noodzakelijk is. Gevoelige authenticatiegegevens, zoals wachtwoorden en toegangstokens, worden niet in deze audittrail bewaard.
De loggegevens worden beschermd tegen ongeoorloofde toegang en worden uitsluitend gebruikt voor doeleinden die verband houden met de werking, de beveiliging, de ondersteuning, het bewijs van transacties en de naleving van de verplichtingen die aan INEO SRL zijn opgelegd in het kader van het gebruik van de API’s van de FOD Financiën.
De rechten met betrekking tot persoonsgegevens worden uitgeoefend overeenkomstig de toepasselijke regelgeving en het privacybeleid van INEO SRL. Bepaalde gegevens kunnen evenwel gedurende de vereiste periode moeten worden bewaard om te voldoen aan toepasselijke wettelijke, contractuele, beveiligings- of auditverplichtingen.
7. Gegevens en informatiedragers
De gebruiker wordt ervan in kennis gesteld dat de FOD Financiën, overeenkomstig de voorwaarden die van toepassing zijn op het gebruik van de API’s, de eindgebruiker kan verzoeken om alle of een deel van de informatiedragers waarop gegevens afkomstig van de FOD Financiën zijn opgeslagen, aan de FOD Financiën te bezorgen, binnen de grenzen en voorwaarden bepaald door de overeenkomst en de toepasselijke regelgeving.
8. Beschikbaarheid van de diensten
De werking van de verbonden diensten is onder meer afhankelijk van de beschikbaarheid van de platformen, API’s en authenticatiemechanismen van de FOD Financiën, evenals van de noodzakelijke netwerkverbindingen.
INEO SRL kan de permanente beschikbaarheid van de door de FOD Financiën geëxploiteerde diensten niet garanderen en kan niet aansprakelijk worden gesteld voor een onbeschikbaarheid of wijziging van deze diensten die buiten haar controle valt.
De gebruiker blijft verantwoordelijk voor de controle dat de door hem gevraagde verrichtingen, met name het indienen van een aangifte of document, daadwerkelijk zijn uitgevoerd en door de FOD Financiën zijn aanvaard.
9. Evolutie van de dienst
Deze voorwaarden kunnen worden aangepast om rekening te houden met wijzigingen aan de API’s, de platformen van de FOD Financiën, de met de FOD Financiën gesloten overeenkomst of de toepasselijke wettelijke en reglementaire vereisten. Wanneer de aard van de wijzigingen dit rechtvaardigt, kan een nieuwe aanvaarding worden gevraagd.
10. Aanvaarding
Door de met de FOD Financiën verbonden diensten te activeren, bevestigt de gebruiker dat hij kennis heeft genomen van deze voorwaarden en ze aanvaardt. Hij bevestigt tevens dat hij gemachtigd is om deze diensten te gebruiken voor rekening van de betrokken onderneming.