> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.robaws.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://support.robaws.com/nl/article/hoe-werkt-de-dico-integratie-1h6oxz9/): 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](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/schermafbeelding-2024-09-19-om_1jo5nxb.png)

||| 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](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/schermafbeelding-2024-09-19-om_59empj.png)

|| 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](https://support.robaws.com/nl/article/order-16axa0j/).

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](https://support.robaws.com/nl/article/hoe-werkt-de-dico-integratie-1h6oxz9/).

## 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](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/schermafbeelding-2024-09-19-om_49xdai.png)

Daarna vertaal je de [statussen](https://support.robaws.com/nl/article/gebruik-van-statussen-1p16bus/) 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](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/schermafbeelding-2024-09-19-om_ou48i7.png)

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](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/rechterkolom_1se8zwt.png)

||| 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](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/linkerkolom_1ejajk7.png)

||| 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](mailto: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](https://www.aareon.nl/mareon).