CSV/XML woningaanbod importeren via Woning-Unie is de snelste manier om als makelaar of professionele verhuurder een groot woningportefeuille online te zetten. In deze handleiding lees je hoe het werkt, welk formaat vereist is en hoe je importfouten voorkomt.
Wat is CSV/XML importeren en wanneer gebruik je het
CSV/XML woningaanbod importeren is een functie voor makelaars, vastgoedbeheerders en professionele verhuurders met meerdere woningen in hun portefeuille. In plaats van elke woning handmatig in te voeren via het dashboard, upload je een gestructureerd bestand met alle woninggegevens in één keer. Een CSV-bestand (Comma Separated Values) is een tabelformaat dat je aanmaakt in Excel of Google Sheets. Een XML-bestand (eXtensible Markup Language) is een gestructureerd gegevensbestand dat vaker gebruikt wordt door vastgoedsoftware en CRM-systemen. Beide formaten worden ondersteund door Woning-Unie.
Stap 1: download het importsjabloon
Begin altijd met het downloaden van het officiële importsjabloon van Woning-Unie. Je vindt het sjabloon in je makelaarsdashboard onder het menu Woningen importeren. Gebruik altijd het meest recente sjabloon, want het veldformaat wordt periodiek bijgewerkt. Het CSV-sjabloon bevat alle vereiste kolommen met een headerrij en een voorbeeldrij. Het XML-sjabloon toont de vereiste tagstructuur met voorbeeldwaarden. Verwijder of hernoem nooit kolommen of tags, want het importalgoritme herkent het bestand op basis van de exacte veldnamen en structuur.
Stap 2: verplichte velden in het CSV-bestand
Het CSV-bestand voor woningimport vereist een aantal verplichte velden per woning. Zorg dat die altijd zijn ingevuld, want ontbrekende verplichte velden leiden tot een importfout. De verplichte velden zijn: titel (maximaal 100 tekens), slug (URL-vriendelijk, zonder spaties of speciale tekens), type woning (apartment, house, studio, villa of commercial), huurprijs of koopprijs per maand of totaal, land (ISO-landcode, bijv. NL, DE, ES, FR), stad, beschikbaarheidsdatum in het formaat JJJJ-MM-DD, en de status (1 voor actief, 0 voor inactief). Zorg dat decimalen altijd met een punt worden geschreven, niet met een komma.
Stap 3: optionele velden voor volledigere advertenties
Naast de verplichte velden zijn er optionele velden die de kwaliteit en vindbaarheid van je advertenties aanzienlijk verbeteren. De belangrijkste optionele velden zijn: omschrijving (aanbevolen minimaal 200 woorden), oppervlakte in vierkante meters, aantal slaapkamers, aantal badkamers, energielabel, postcode, breedtegraad en lengtegraad voor precieze kaartpositie, en de categorie (huur of koop). Voor het CSV-formaat geef je foto-URLs op als kommagescheiden lijst in één cel. Voor XML zijn aparte fototags beschikbaar per afbeelding. Hoe meer optionele velden je invult, hoe hoger je advertentie scoort in de zoekresultaten.
Stap 4: veelgemaakte fouten voorkomen
CSV/XML woningaanbod importeren gaat geregeld mis door een aantal veelgemaakte fouten. Ten eerste: sla je CSV-bestand altijd op met UTF-8 codering om problemen met accenten en speciale tekens te voorkomen. Ten tweede: gebruik het datumformaat JJJJ-MM-DD strikt, want andere formaten zoals DD/MM/JJJJ leiden tot fouten. Ten derde: zorg dat slugs uniek zijn en geen spaties, hoofdletters of speciale tekens bevatten. Ten vierde: controleer of alle verplichte velden zijn ingevuld voor elke rij. Ten vijfde: verwijder lege rijen aan het einde van je bestand, want die worden als foutieve records verwerkt.
Stap 5: upload en verwerk het bestand
Nadat je CSV- of XML-bestand klaar en gecontroleerd is, ga je naar je dashboard en klik je op Woningen importeren. Selecteer je bestand via de uploadknop en kies het juiste formaat (CSV of XML). Klik op Importeren starten en wacht tot het systeem de verwerking voltooit. Je ontvangt een verwerkingsrapport dat aangeeft hoeveel woningen succesvol zijn geïmporteerd, hoeveel zijn overgeslagen en welke foutmeldingen er zijn. Verwerk de foutmeldingen in je bronbestand en upload alleen de gecorrigeerde rijen in een nieuw importbestand. Je hoeft het volledige bestand niet opnieuw te verwerken voor correcties.
Stap 6: automatisch importeren via API of feed
Voor makelaars met een actieve portefeuille die regelmatig wijzigt, biedt Woning-Unie ook de mogelijkheid van automatische import via een API-koppeling of een XML-feed. Dat is bijzonder handig als je woningportefeuille beheerd wordt vanuit een CRM-systeem of vastgoedsoftware die automatisch een exportbestand genereert. De API-koppeling synchroniseert het aanbod op je dashboard automatisch met de gegevens in je eigen systeem, waardoor je altijd een actueel en consistent aanbod hebt. Neem contact op met het technische team van Woning-Unie voor de API-documentatie en de activatieprocedure voor automatische import.