Articles sur : Intégrations
Cet article est aussi disponible en :

Comment fonctionne l'intégration Mareon ?

Via paramètres > Intégrations > DICO, vous pouvez configurer des 'Message Services'. Des services externes (comme Mareon) peuvent ainsi envoyer des messages à Robaws. L'idée est que de tels messages pourront, dans une phase ultérieure, également être utilisés comme communication entre différents environnements Robaws.


Utilisation


1. Entretien (Mareon > Robaws)


Pour pouvoir envoyer des entretiens de Mareon vers Robaws, nous devons prévoir dans Robaws un endpoint que Mareon peut appeler. Cliquez pour cela sur '+' dans l'aperçu des DICO Endpoints afin d'ajouter un nouvel endpoint dans Robaws.


Pour créer un message service qui recevra des messages, vous choisissez l'option 'Entrant'. Actuellement, seuls les messages SOAP sont pris en charge ; choisissez donc le type 'SOAP générique'.



Dans le champ suivant, vous devez générer des informations d'identification qui seront ensuite communiquées à Mareon. Cliquez pour cela sur le crayon à côté de 'Informations d'identification' puis cliquez sur 'Générer de nouvelles informations d'identification'. Ces informations d'identification sont automatiquement enregistrées.


N'oubliez pas de copier les informations d'identification avant de fermer la fenêtre, car elles ne peuvent pas être récupérées ultérieurement. De nouvelles informations d'identification peuvent toutefois toujours être générées.



L''URL de base du service de messagerie' est par ailleurs également importante pour l'échange de messages.


En dernière étape, vous devez configurer un 'donneur d'ordre'. Dès qu'une commande d'entretien est reçue depuis Mareon dans Robaws, le donneur d'ordre est automatiquement lié comme client à la commande.


Une fois la configuration terminée, des messages peuvent être envoyés vers https://dico.robaws.com/services/MessageService31.
Les informations d'identification doivent être transmises via 'Basic Authentication' avec les messages. Sur la base de ces informations d'identification, Robaws sait à quel tenant le message est destiné. Une fois qu'un message a été traité, l'entretien se retrouve sous le module 'Commandes'.


2. Statut d'entretien


2.1 Statut d'entretien (Robaws > Mareon)


Une fois que nous avons reçu une commande depuis Mareon, nous pouvons également renvoyer des mises à jour de statut de cette commande vers Mareon.
Pour rendre cela possible, une 'URL pour les commentaires sur l'état' doit être configurée sur notre endpoint DICO récepteur.
Cette URL se présentera comme suit :



Une **** est toujours unique par client et doit être obtenue via Mareon.



Il est en outre également important de lier les statuts des commandes dans Robaws à un code DICO, qui doit être transmis avec le message de statut sortant. Vous faites cela via la fonction 'Mappage de l'état des commandes DICO' dans l'aperçu des Dico Endpoints :



Un écran pop-up s'affiche ensuite. Si vous souhaitez envoyer des mises à jour de statut depuis Robaws vers Mareon, vous ne devez tenir compte que des données de la colonne de droite 'Statut d'ordre > Code DICO sortant'. Dans ces champs, vous pouvez indiquer une traduction des statuts des commandes dans Robaws vers un code DICO.



Un aperçu des codes possibles et de leur signification :


Code

Description

ACC

Accepter

AFH

Rendez-vous locataire

AFR

Attendre la réponse de l'inspecteur

AFW

Attendre en raison du mauvais temps

ANN

Commande annulée

BBT

Locataire rappelle

BNT

Locataire absent

GER

Notification d'achèvement

MIB

Matériel en commande

TFC

À facturer

UIT

En cours

VBW

Demande du locataire

VER

Prolongation

WEI

Refuser


Si le statut d'une commande dans Robaws est modifié vers un statut pour lequel aucun code DICO sortant n'est configuré, aucun message de statut avec une mise à jour ne sera envoyé vers Mareon.


2.2 Statut d'entretien (Mareon > Robaws)


Il est également possible d'envoyer des messages de statut avec des mises à jour depuis Mareon vers Robaws. Pour rendre cela possible, vous devez également prévoir une traduction d'un code DICO entrant vers un statut de commande dans Robaws. Pour cela, vous pouvez faire appel à la colonne de gauche dans la fonction 'Mappage de l'état des commandes DICO' : 'Code DICO entrant > Statut d'ordre'.



Si un message de statut avec un code DICO est reçu dans Robaws, pour lequel aucun statut de commande Robaws n'est configuré, le statut actuel de la commande restera inchangé dans Robaws.

Mis à jour le : 06/07/2026

Cet article a-t-il répondu à vos questions ?

Partagez vos commentaires

Annuler

Merci !