Bloxs & Huurprijscheck.app integratie

Met deze integratie importeer je eenvoudig gebouwen en units vanuit Bloxs naar Huurprijscheck.app. Hierdoor kun je direct huurprijschecks aanmaken en uitvoeren. Na afronding van een check worden het puntentotaal, de huurprijs, het tijdvak en het rapport, automatisch gesynchroniseerd in jouw omgeving in Bloxs. In deze handleiding lees je hoe je de integratie activeert, gebouwen en units importeert vanuit Bloxs naar Huurprijscheck.app en eventueel koppelt met bestaande objecten die al zijn aangemaakt. Ook leggen we uit hoe je checks aanmaakt en synchroniseert.

Inhoud

1). Omschrijving API-koppeling.

2). Randvoorwaarden.

3). API-inrichting in Bloxs.

4). Configuratie in Huurprijscheck.app.

5). Beheer API-koppeling.

6). Ondersteuning.

1). Omschrijving API-koppeling

Uitgaande data: Inkomende data:

# Objecten (gebouwen en units) # Objecten (puntentelling)

# Relaties (personen)

Met deze integratie importeer je eenvoudig gebouwen en units vanuit Bloxs naar Huurprijscheck.app. Hierdoor kun je direct huurprijschecks aanmaken en uitvoeren. Na afronding van een check worden het puntentotaal, de huurprijs, het tijdvak en het rapport, automatisch gesynchroniseerd in jouw omgeving in Bloxs. In deze handleiding lees je hoe je de integratie activeert, gebouwen en units importeert vanuit Bloxs naar Huurprijscheck.app en eventueel koppelt met bestaande objecten die al zijn aangemaakt. Ook leggen we uit hoe je checks aanmaakt en synchroniseert.

2). Randvoorwaarden

Als voorbereiding op het opzetten van een API-koppeling dienen de volgende stappen uitgevoerd te worden door je applicatiebeheerder:

1. Activeren API

2. Activeren functionaliteit ‘Serviceaccounts'

Activeren van API en het aanzetten van de Serviceaccounts functionaliteit.

2.1). API-activatie

Op de Admin-pagina ga je naar het menu aan de linkerzijde en selecteer je:

· Koppelingen > API

· Op de API Admin-pagina activeer je de API’s

Rol toewijzen aan een gebruiker

Je kunt de rol "API Huurprijscheck.app", die je zojuist hebt aangemaakt toewijzen aan zowel een bestaande gebruiker als aan een nieuwe gebruiker.

Nieuwe gebruiker

Ga naar Toegangsbeheer → Accounts → [+ Account] (knop rechts bovenin)

Vul hier de vereiste velden in zoals E-mail, voornaam en achternaam. Selecteer de rol die je zojuist hebt aangemaakt ("API Huurprijscheck.app") en klik op de groene knop [Opslaan].

Bestaande gebruiker

Ga naar Toegangsbeheer → Accounts → [Kies de bestaande gebruiker].

Met knop [+ Rol toevoegen], voeg je de rol toe die je zojuist hebt aangemaakt ('API Huurprijscheck.app') en klik je op de groene knop [Wijzigen].

3. Integratie activeren in Huurprijscheck.app

Stappen:

  1. Ga in Huurprijscheck.app naar Instellingen → Integraties

  2. Klik bij de Bloxs integratie op Beheren

  3. Ga naar het tabblad Instellingen

  4. Vul de volgende velden in van onderdeel 1:

    • API-url

    • API key

    • API secret

  5. Zet het Status schuifje op actief.

  6. Klik op Opslaan

Stap 1 en 2
stap 3
stap 4 en 5
stap 6

4. Objecten importeren

  1. Ga naar het tabblad Objecten

  2. Klik op Objecten importeren

  3. Bevestig de pop-up

Via de optie: Objecten importeren worden alle objecten, behalve de gearchiveerde objecten (bij verkoop) vanuit Bloxs geïmporteerd. In principe wordt deze import eenmalig uitgevoerd. In geval van nieuwe objecten dient een nieuwe import plaats te vinden

Als je op een later moment nieuwe objecten in Bloxs toevoegt, dan zul je deze nieuwe objecten opnieuw dienen te importeren, zodat de nieuwe objecten ook beschikbaar worden.

De geïmporteerde objecten worden zichtbaar in de lijst. Je gebruikt geen credits voor het importeren van objecten.

1 objecten importeren knop
2 objecten importeren
3. objecten aan het laden

5. Objecten matchen

Na de import van de objecten zijn er 2 verschillende manieren om te matchen:

  1. Automatische koppeling is mogelijk, eerst op het niveau van de Verblijfsobject-ID/ VBO-ID (via de Kadaster koppeling of handmatig ingevuld op tabblad: Details) en daarna op het niveau van adres (straat, huisnummer, postcode, plaats).

  2. Geen koppeling als er geen match is. In dat geval bestaan er 2 matchopties:

    • Handmatige koppelen aan een bestaand object.

    • Kiezen voor 'Aanmaken als nieuw object'’

Opmerkingen:

  • In Bloxs heb je een veld om handmatig een BAG-ID in te vullen.

Match hier de objecten die niet automatisch gekoppeld zijn maar wel al bestaan in Huurprijscheck.app
klik op de knop "objecten matchen"
voorbeeld van matchen
overzicht van de objecten die gematcht zijn

6. Huurprijscheck aanmaken

Wanneer alle gebouwen en units vanuit Bloxs zijn geïmporteerd in Huurprijscheck.app als object kun je van start gaan.

  1. Klik op Check invullen bij een object

  2. Selecteer of het gaat om een:

    • Zelfstandige woning

    • Onzelfstandige woning

  3. Klik op Check aanmaken

  4. Vul de volledige check in zoals gebruikelijk.

⚠️ Let op: Zorg ervoor dat je voldoende credits hebt in je Huurprijscheck.app account om de checks aan te kunnen maken. Mocht je onvoldoende credits hebben dan kun je altijd extra credits aanschaffen. Neem hiervoor contact op met Huurprijscheck.app (zie onderdeel 9)

Check invullen
Kiezen zelfstandig of onzelfstandig

7. Synchronisatie

Na afronding van een check worden het puntentotaal; de huurprijs; het tijdvak en het rapport, automatisch gesynchroniseerd met het gebouw of de unit in Bloxs. De puntentelling in Bloxs is terug te vinden in het tabblad: Puntentelling van een gebouw of unit.

Als er voor een bestaand gebouw of unit al een actieve puntentelling beschikbaar is in Bloxs dan wordt die gearchiveerd. In het geval dat er een nieuwe puntentelling voor datzelfde object wordt geïmporteerd is de nieuwe puntentelling actief.

Op het tabblad: Puntentelling worden de resultaten (puntentelling; huurprijs; tijdvak en rapport) getoond. Met de knop: 'Downloaden' is het mogelijk om het rapport te exporteren als PFD-bestand.

Daarnaast komt op diezelfde pagina het rapport beschikbaar onder het tabblad: 'Bestanden'. (Huurprijscheck.app genereert alleen rapporten in het Nederlands.)

Je kunt de check ook handmatig synchroniseren naar Bloxs:

  • Ga in Huurprijscheck.app naar Instellingen → Integraties → Bloxs → Objecten

  • Klik op Synchroniseer bij het object

  • Hier kun je ook zien wanneer de check voor het laatst gesynchroniseerd is.

8. Integratie beheren of verwijderen

Uitschakelen

Ga naar Instellingen → Integraties → Bloxs -> Instellingen

  • Zet de schakelaar op inactief → De checks worden niet meer automatisch doorgestuurd naar Bloxs.

Verwijderen

  1. Ga naar het tabblad Instellingen

  2. Klik op Verwijderen

  3. Bevestig met je wachtwoord

⚠️ Objecten die al zijn geïmporteerd blijven bewaard.

9. Ondersteuning Huurprijscheck.app

Heb je hulp nodig? Neem contact op met ons supportteam!

E-mail:

[email protected] Vermeld je bedrijfsnaam, beschrijving van het probleem en een eventueel screenshot.

Of neem telefonisch contact met ons op:

+31 (0) 10 700 97 33

10. Beveiliging

Beveiliging van Huurprijscheck.app Huurprijscheck.app maakt gebruik van beveiligde verbindingen (SSL/TLS) voor alle dataverkeer. Toegang tot de applicatie en API is beveiligd met authenticatie en autorisatie op gebruikers- en organisatieniveau. Gegevens worden versleuteld opgeslagen en back-ups worden dagelijks gemaakt en versleuteld bewaard.

Serverlocatie De servers van Huurprijscheck.app zijn ondergebracht in een streng beveiligd datacenter in Nederland (Eemshaven). Hierdoor blijven alle gegevens binnen de EU en voldoet de hosting aan de AVG-richtlijnen (GDPR).

Last updated