Artikelen over: Integraties
Dit artikel is ook beschikbaar in:

Hoe werkt de Mareon integratie?

Mareon is het platform van Aareon waarmee woningcorporaties onderhoudsopdrachten uitwisselen met hun onderhoudspartners. Robaws sluit daarop aan via de DICO-integratie: je maakt in Robaws een DICO-endpoint aan, Mareon stuurt daar zijn berichten naartoe, en Robaws zet die om in een order. Omgekeerd stuurt Robaws statuswijzigingen van dat order terug naar Mareon.


De DICO-standaard is een Nederlandse afspraak. Deze integratie is dus enkel bruikbaar voor klanten in Nederland.


Je vindt de configuratie via instellingen > integraties > DICO, in het overzicht Dico Endpoints.


Onderhoudsopdrachten ontvangen uit Mareon


Om onderhoudsopdrachten van Mareon te ontvangen, maak je in Robaws een endpoint aan dat Mareon kan aanroepen.


  1. Klik in het overzicht Dico Endpoints op de actieknop +.
  2. Zet Ingeschakeld aan en geef het endpoint een duidelijke naam.
  3. Kies bij Binnenkomend/Uitgaand de optie Binnenkomend.
  4. Kies bij Type de optie Generische SOAP. Voor binnenkomende berichten worden momenteel enkel SOAP-berichten ondersteund.
  5. Genereer de inloggegevens die je aan Mareon doorgeeft: klik op het potlood naast Inloggegevens en daarna op nieuwe inloggegevens genereren. Ze worden automatisch bewaard.
  6. Kies een opdrachtgever. Zodra er een onderhoudsopdracht uit Mareon binnenkomt, wordt die opdrachtgever automatisch als klant aan het order gekoppeld.
  7. Duid de order template aan waarmee het order opgebouwd wordt, en vul het bedrijf en de bijhorende dagboeken in.


Een binnenkomend DICO-endpoint van het type Generische SOAP


Kopieer de inloggegevens voor je het venster sluit. Je kan ze nadien niet meer opvragen. Je kan wel altijd nieuwe inloggegevens genereren, maar dan moet je die opnieuw aan Mareon doorgeven.


Inloggegevens genereren op het DICO-endpoint


Het veld Basis-URL voor berichtenservice wordt bij een binnenkomend endpoint automatisch ingevuld met https://dico.robaws.com/services/MessageService31 en kan je niet wijzigen. Dat is het adres waarnaar Mareon zijn berichten stuurt.


Mareon stuurt zijn berichten met Basic Authentication naar die URL. Op basis van de inloggegevens weet Robaws voor welke omgeving het bericht bestemd is. Een verwerkt bericht vind je terug als order in de module orders.


Welke informatie uit het bericht in welk veld van het order terechtkomt, bepaal je met vervangingscodes en extra velden op de order template. Dat staat volledig beschreven in het artikel over de DICO-integratie.


Statusupdates terugsturen naar Mareon


Heb je een order uit Mareon ontvangen, dan kan Robaws statuswijzigingen van dat order terugkoppelen.


Vul op hetzelfde binnenkomende endpoint het veld URL voor status terugkoppeling in. Die URL ziet er zo uit:


  • testomgeving: https://marx.mareon-test.nl/?API=MLD_OPDR_SALES005_1.0_MS31&APIKEY=<API_KEY>
  • productieomgeving: https://marx.mareon.nl/?API=MLD_OPDR_SALES005_1.0_MS31&APIKEY=<API_KEY>


De <API_KEY> is uniek per klant. Die vraag je op bij Mareon, samen met de bevestiging van de juiste URL. Hoort er ook een login bij, dan vul je die in bij Inloggegevens voor status terugkoppeling.


URL voor status terugkoppeling op het endpoint


Daarna vertaal je de statussen van je orders in Robaws naar een DICO-code. Dat doe je via de functie DICO order status mapping in het overzicht Dico Endpoints.


De functie DICO order status mapping


Voor het versturen van statusupdates gebruik je enkel de rechterkolom Order status > Uitgaande DICO code. Per orderstatus in Robaws vul je daar de DICO-code in die mee moet met het uitgaande bericht.


De rechterkolom: order status naar uitgaande DICO code


Wijzigt een order naar een status waarvoor geen uitgaande DICO-code ingesteld is, dan wordt er géén statusbericht naar Mareon gestuurd.


Beschikbare DICO-codes


Code

Omschrijving

ACC

Accepteren

AFH

Afspraak huurder

AFR

Afwachten, reactie opzichter

AFW

Afwachten in verband met weer

ANN

Opdracht geannuleerd

BBT

Bewoner belt terug

BNT

Bewoner niet thuis

GER

Gereedmelding

MIB

Materiaal in bestelling

TFC

Te factureren

UIT

In uitvoering

VBW

Verzoek bewoner

VER

Verlenging

WEI

Weigeren


Statusupdates ontvangen uit Mareon


Mareon kan ook statusupdates naar Robaws sturen. Daarvoor vertaal je de omgekeerde richting: van DICO-code naar orderstatus. Gebruik daarvoor de linkerkolom Binnenkomende DICO code > Order status in dezelfde functie DICO order status mapping.


De linkerkolom: binnenkomende DICO code naar order status


Komt er een statusbericht binnen met een DICO-code waarvoor geen orderstatus ingesteld is, dan blijft de status van het order in Robaws ongewijzigd.


Hulp nodig?


Gaat het over het endpoint, de mapping of de order template in Robaws? Neem contact op met support@robaws.com.


Gaat het over je API key, de terugkoppel-URL of de berichten die Mareon verstuurt? Neem dan contact op met de support van Mareon via aareon.nl/mareon.

Bijgewerkt op: 28/08/2026

Was dit artikel nuttig?

Deel uw feedback

Annuleer

Dankuwel!