Hoe werkt de Mareon integratie?
Via instellingen > Integraties > DICO kan je 'Message Services' configureren. Externe diensten (zoals Mareon) kunnen zo berichten sturen naar Robaws. De idee is dat zo'n berichten in een latere fase ook kunnen gebruikt worden als communicatie tussen verschillende Robaws omgevingen.
Om onderhoudsbeurten van Mareon naar Robaws te kunnen sturen, behoren we in Robaws een endpoint te voorzien dat Mareon kan aanroepen. Klik hiervoor op ‘+ʼ in het DICO Endpoints overzicht om een nieuwe endpoint toe te voegen in Robaws.
Om een message service te maken die berichten zal ontvangen, kies je voor de optie 'Binnenkomend'. Momenteel worden enkel SOAP berichten ondersteund, dus kies voor type 'Generische SOAP'.
In het volgende veld dien je inloggegevens te generen die vervolgens gecommuniceerd worden naar Mareon. Klik hiervoor op het potloodje naast 'Inloggegevens' en klik vervolgens op 'Nieuwe inloggegevens genereren'. Deze inloggegevens worden automatisch opgeslagen.
Vergeet de logingegevens niet te kopiëren alvorens het venster te sluiten, want deze kunnen niet opnieuw opgevraagd worden. Er kunnen wel steeds nieuwe inloggegevens gegenereerd worden.
De 'Basis-URL voor berichtenservice' is daarnaast ook belangrijk voor de uitwisseling van berichten.
Als laatste stap dien je een 'opdrachtgever' te configureren. Eenmaal er een onderhoudsorder wordt ontvangen vanuit Mareon in Robaws, zal de opdrachtgever automatisch als klant gekoppeld worden aan het order.
Eens de configuratie voltooid is, kunnen er berichten verstuurd worden naar https://dico.robaws.com/services/MessageService31.
Inloggegevens moeten via 'Basic Authentication' meegestuurd worden met de berichten. Op basis van deze inloggegevens weet Robaws voor welke tenant het bericht bestemd is. Eens een bericht werd verwerkt, zal de onderhoudsbeurt terug te vinden zijn onder de module 'Orders'.
Eens we een order hebben ontvangen vanuit Mareon, kunnen we ook status updates van dat order terugkoppelen naar Mareon.
Om dit mogelijk te maken moet er een 'URL voor status terugkoppeling' geconfigureerd worden op onze ontvangende DICO endpoint.
Deze URL zal er als volgt uitzien:
Test-omgeving: https://marx.mareon-test.nl/?APIMLD_OPDR_SALES005_1.0_MS31&APIKEY <API_KEY
Productie-omgeving: https://marx.mareon.nl/?APIMLD_OPDR_SALES005_1.0_MS31&APIKEY <API_KEY
Een <API_KEY> is steeds uniek per klant en moet via Mareon verkregen worden.
Verder is het ook belangrijk om de statussen van orders in Robaws te linken met een DICO code, die met het uitgaande statusbericht moet meegegeven worden. Dit doe je via de functie 'DICO status order mapping' in het Dico Endpoints overzicht:
Een pop-up scherm wordt vervolgens weergegeven. Wens je status updates te versturen vanuit Robaws naar Mareon, dan hoef je enkel rekening te houden met de gegevens in de rechterkolom 'Order status > Uitgaande DICO code'. In deze velden kan je een vertaling opgeven voor de statussen van de orders in Robaws naar een DICO code.
Een overzicht van mogelijke codes en hun betekenis:
Indien de status van een order in Robaws gewijzigd wordt naar een status, waarvoor er geen uitgaande DICO code geconfigureerd is, zal er geen statusbericht met een update gestuurd worden naar Mareon.
Het is ook mogelijk om statusberichten met updates te sturen vanuit Mareon naar Robaws. Om dit mogelijk te maken, behoor je ook een vertaling te voorzien voor een binnenkomende DICO code naar een orderstatus in Robaws. Hiervoor kan je beroep doen op de linkerkolom in de 'DICO order status mapping' functie: 'Binnenkomende DICO code > Order status'.
Indien er een statusbericht met een DICO code ontvangen wordt in Robaws, waarvoor er geen Robaws orderstatus geconfigureerd is, zal de huidige status van het order ongewijzigd blijven in Robaws.
Gebruik
1. Onderhoudsbeurt (Mareon > Robaws)
Om onderhoudsbeurten van Mareon naar Robaws te kunnen sturen, behoren we in Robaws een endpoint te voorzien dat Mareon kan aanroepen. Klik hiervoor op ‘+ʼ in het DICO Endpoints overzicht om een nieuwe endpoint toe te voegen in Robaws.
Om een message service te maken die berichten zal ontvangen, kies je voor de optie 'Binnenkomend'. Momenteel worden enkel SOAP berichten ondersteund, dus kies voor type 'Generische SOAP'.
In het volgende veld dien je inloggegevens te generen die vervolgens gecommuniceerd worden naar Mareon. Klik hiervoor op het potloodje naast 'Inloggegevens' en klik vervolgens op 'Nieuwe inloggegevens genereren'. Deze inloggegevens worden automatisch opgeslagen.
Vergeet de logingegevens niet te kopiëren alvorens het venster te sluiten, want deze kunnen niet opnieuw opgevraagd worden. Er kunnen wel steeds nieuwe inloggegevens gegenereerd worden.
De 'Basis-URL voor berichtenservice' is daarnaast ook belangrijk voor de uitwisseling van berichten.
Als laatste stap dien je een 'opdrachtgever' te configureren. Eenmaal er een onderhoudsorder wordt ontvangen vanuit Mareon in Robaws, zal de opdrachtgever automatisch als klant gekoppeld worden aan het order.
Eens de configuratie voltooid is, kunnen er berichten verstuurd worden naar https://dico.robaws.com/services/MessageService31.
Inloggegevens moeten via 'Basic Authentication' meegestuurd worden met de berichten. Op basis van deze inloggegevens weet Robaws voor welke tenant het bericht bestemd is. Eens een bericht werd verwerkt, zal de onderhoudsbeurt terug te vinden zijn onder de module 'Orders'.
2. Onderhoudsstatus
2.1 Onderhoudsstatus (Robaws > Mareon)
Eens we een order hebben ontvangen vanuit Mareon, kunnen we ook status updates van dat order terugkoppelen naar Mareon.
Om dit mogelijk te maken moet er een 'URL voor status terugkoppeling' geconfigureerd worden op onze ontvangende DICO endpoint.
Deze URL zal er als volgt uitzien:
Test-omgeving: https://marx.mareon-test.nl/?APIMLD_OPDR_SALES005_1.0_MS31&APIKEY <API_KEY
Productie-omgeving: https://marx.mareon.nl/?APIMLD_OPDR_SALES005_1.0_MS31&APIKEY <API_KEY
Een <API_KEY> is steeds uniek per klant en moet via Mareon verkregen worden.
Verder is het ook belangrijk om de statussen van orders in Robaws te linken met een DICO code, die met het uitgaande statusbericht moet meegegeven worden. Dit doe je via de functie 'DICO status order mapping' in het Dico Endpoints overzicht:
Een pop-up scherm wordt vervolgens weergegeven. Wens je status updates te versturen vanuit Robaws naar Mareon, dan hoef je enkel rekening te houden met de gegevens in de rechterkolom 'Order status > Uitgaande DICO code'. In deze velden kan je een vertaling opgeven voor de statussen van de orders in Robaws naar een DICO code.
Een overzicht van mogelijke codes en hun betekenis:
| 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 |
Indien de status van een order in Robaws gewijzigd wordt naar een status, waarvoor er geen uitgaande DICO code geconfigureerd is, zal er geen statusbericht met een update gestuurd worden naar Mareon.
2.2 Onderhoudsstatus (Mareon > Robaws)
Het is ook mogelijk om statusberichten met updates te sturen vanuit Mareon naar Robaws. Om dit mogelijk te maken, behoor je ook een vertaling te voorzien voor een binnenkomende DICO code naar een orderstatus in Robaws. Hiervoor kan je beroep doen op de linkerkolom in de 'DICO order status mapping' functie: 'Binnenkomende DICO code > Order status'.
Indien er een statusbericht met een DICO code ontvangen wordt in Robaws, waarvoor er geen Robaws orderstatus geconfigureerd is, zal de huidige status van het order ongewijzigd blijven in Robaws.
Bijgewerkt op: 19/09/2024
Dankuwel!