Op enkele uitzonderingen na moet u uw gegroepeerde aanvragen voor fiscale woonplaatsattesten indienen via XML-bestanden in MyMinfin.

Sinds 5 juni 2025 is er geen indieningsperiode meer. U kunt uw XML-bestanden het hele jaar door indienen

Uitzondering – Verzending op papier

U moet de gegroepeerde aanvragen van natuurlijke personen of natuurlijke personen - ondernemingen over een woonplaatsattest altijd versturen:

• voor een specifieke periode (meer bepaald voor inkomsten van een eerdere periode),
• met of zonder vermelding van de inkomstenbedragen.

Vul in dat geval de daarvoor bestemde formulieren in, voeg voor elke klant een volmacht toe en verstuur alles samen per post rechtstreeks naar de bevoegde dienst (selecteer ‘Internationale verdragen – woonplaatsattest').

• Als uw XML-bestand geen onregelmatigheden bevat, wordt het automatisch verwerkt.
• Als er zich een onregelmatigheid voordoet in een specifieke aanvraag, verwerken we die handmatig.

Als uw XML-bestand niet conform het XSD-schema is, kunt u het niet indienen en krijgt u de melding ‘Bestand is niet conform’.

Het overzicht van de aanvraag en het attest zijn in principe beschikbaar in het MyMinfin-dossier van uw klant binnen enkele uren na het indienen van de aanvraag via een XML-bestand.

Is het overzicht van de aanvraag beschikbaar in het MyMinfin-dossier van uw klant, maar het attest nog niet? Dat betekent dat uw aanvraag niet automatisch kon worden behandeld. In dat geval ontvangt u de uiteindelijke beslissing (attest of weigering) in het MyMinfin-dossier van uw klant volgens de volgende planning:

Is het overzicht van de aanvraag niet beschikbaar in het MyMinfin-dossier van uw klant binnen enkele uren?

Dan kan dit verschillende oorzaken hebben:

• De ingediende aanvraag kan fouten bevatten en uw tussenkomst vereisen (bijvoorbeeld als het nationaal nummer of het ondernemingsnummer niet bestaat). U moet ervoor zorgen dat alle gegevens van uw bestand juist zijn en dat er van uw kant geen correctie nodig is. Als u fouten vaststelt, moet u opnieuw indienen door uw aanvraag in een ander XML-bestand op te nemen, zodat deze kan worden verwerkt.
• Uw aanvraag wacht op verwerking. Het overzicht wordt gegenereerd zodra de aanvraag is verwerkt.

Om de beslissing te kunnen raadplegen moet u een actief mandaat hebben (informatie over de types mandaten) om als mandataris toegang te krijgen tot het MyMinfin-dossier van uw klant.

MyMinfin-API

U kunt ook het downloaden van de beslissingen van uw klanten automatiseren door de MyMinfin-API te gebruiken. U moet echter nog steeds een actief mandaat hebben om de besluiten van uw klanten via die API te kunnen weergeven.

Met uitzondering van bepaalde internationale inlichtingen, automatiseert de MyMinfin-API het downloaden van alle documenten die beschikbaar zijn in MyMinfin en die u kunt raadplegen in uw eigen naam en ook dankzij uw actieve mandaten. Als u die API alleen gebruikt voor fiscale woonplaatsattesten, is het belangrijk om de ontvangen documenten goed te organiseren en een doeltreffend intern systeem op te zetten om de toegang tot die documenten te beheren.

Meer informatie over de MyMinfin-API.

• Vul een XML-bestand in met alle aanvragen van klanten per doelgroep: een bestand voor de natuurlijke personen (waaronder ook de natuurlijke personen - ondernemingen) en een ander bestand voor de rechtspersonen.
  • Om het XML-bestand te valideren, moet u het XSD-schema gebruiken.
  • In tegenstelling tot het XML-bestand voor rechtspersonen, moet het XML-bestand voor natuurlijke personen alleen de attestaanvragen bevatten, zonder vermelding van een specifieke verblijfsperiode en zonder gegevens over het inkomen.
  • Vermeld in het XML-bestand ook uw postadres in België en een e-mailadres waarop we u kunnen bereiken.​

• In MyMinfin:
  • Meld u aan in naam van uw onderneming.
  • Kies 'Mijn interacties > Een document aanvragen > Fiscaal woonplaatsattest in België (276conv)'.
  • Selecteer ‘Ik upload een XML-bestand voor particulieren en/of zelfstandigen (natuurlijke personen)’ of ‘Ik upload een XML-bestand voor ondernemingen (rechtspersonen)’ afhankelijk van de doelgroep waarvoor u de groepsaanvraag indient.
  • Upload uw XML-bestand met de gegroepeerde attestaanvragen van klanten van dezelfde doelgroep.
    U moet geen rekening houden met de aangegeven limiet van 5.000 attestaanvragen per XML-bestand voor de XML-bestanden die in 2025 en tijdens het eerste kwartaal 2026  worden verzonden.
    
    U kunt meerdere XML-bestanden versturen, zonder rekening te hoeven houden met een indieningsperiode. Vermijd echter het meermaals indienen van dezelfde XML-bestanden om het proces zo efficiënt mogelijk te laten verlopen. Wanneer u correcties uitvoert die betrekking hebben op aanvragen in een XML-bestand, raden wij u aan om alleen de gecorrigeerde aanvragen te groeperen en ze via een nieuw XML-bestand in te dienen, apart van de andere aanvragen.

U kunt al uw aanvragen via een XML-bestand indienen. U kunt echter geen beslissingen (attest of weigering) raadplegen van klanten die geen actief mandaat hebben in de applicatie Mandaten. Ze moeten u zelf hun attest bezorgen.

Als u enkel in het buitenland geregistreerd bent, kunt u momenteel geen mandaat activeren noch toegang krijgen tot MyMinfin in naam van uw klanten die in België wonen.

Hun gegroepeerde aanvragen kunnen dus niet meer worden behandeld. Uw Belgische klanten moeten voortaan zelf hun woonplaatsattesten aanvragen en doorgeven.

Aanvragen voor minderjarigen zonder identiteitskaart (over het algemeen jonger dan 12 jaar) kunnen alleen per post worden verstuurd.

Meer informatie over de te volgen procedure voor het versturen per post.

Aanvragen voor personen onder voogdij kunnen uitsluitend per post worden verstuurd.

Meer informatie over de te volgen procedure voor het versturen per post.

Enkele voorbeelden van in het kader van deze indieningsprocedure te gebruiken bestanden:

• het XML-bestand dat moet worden ingevuld voor aanvragen van natuurlijke personen (inclusief natuurlijke personen - ondernemingen):  151-276conv-bulk-ipp.xml (ZIP, 556 bytes)
• het XML-bestand dat moet worden ingevuld voor aanvragen van rechtspersonen:  151-276conv-bulk-isoc.xml (ZIP, 892 bytes)
• de technische aanwijzingen via een XSD-schema voor elke doelgroep:  151-ipp.xsd (ZIP, 956 bytes) en  151-isoc.xsd (ZIP, 2.08 KB)
• het Word-document met de toelichting van de in te vullen velden per XML-bestand:  151-structured-xml-file-natural-persons.docx (DOCX, 26.3 KB) en  151-structured-xml-file-legal-entity.docx (DOCX, 28.5 KB)
• een  bestand met de overzichtstabel (DOCX, 131.65 KB) voor de uitzonderlijke stroom (natuurlijke personen of natuurlijke personen-ondernemingen die een woonplaatsattest nodig hebben met vermelding van de periode van verblijf (met name voor inkomsten uit een vorige periode) en/of de bedragen van de inkomsten)
• een  Excel-bestand met de verzendingsadressen (XLSX, 112.25 KB) voor de uitzonderlijke stroom (natuurlijke personen of natuurlijke personen – ondernemingen die een woonplaatsattest nodig hebben met vermelding van de periode van verblijf (met name voor inkomsten uit een vorige periode) en/of de bedragen van de inkomsten)
• de  lijst (28 maart 2023) met landen (XLSX, 25.02 KB) met een overeenkomst ter voorkoming van dubbele belasting