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

Comment fonctionne l'intégration Mareon ?

Mareon est la plateforme d'Aareon avec laquelle les sociétés de logement échangent des ordres d'entretien avec leurs partenaires d'entretien. Robaws s'y connecte via l'intégration DICO : vous créez dans Robaws un endpoint DICO, Mareon y envoie ses messages, et Robaws les convertit en ordre. Inversement, Robaws renvoie les modifications de statut de cet ordre vers Mareon.


La norme DICO est une convention néerlandaise. Cette intégration n'est donc utilisable que pour les clients aux Pays-Bas.


Vous trouvez la configuration via paramètres > intégrations > DICO, dans l'aperçu Dico Endpoints.


Recevoir des ordres d'entretien depuis Mareon


Pour recevoir les ordres d'entretien de Mareon, vous créez dans Robaws un endpoint que Mareon peut appeler.


  1. Dans l'aperçu Dico Endpoints, cliquez sur le bouton d'action +.
  2. Activez Activé et donnez un nom clair à l'endpoint.
  3. Choisissez l'option Entrant dans Entrant/Sortant.
  4. Choisissez l'option SOAP générique dans Type. Pour les messages entrants, seuls les messages SOAP sont pris en charge actuellement.
  5. Générez les informations d'identification que vous transmettez à Mareon : cliquez sur le crayon à côté d'informations d'identification puis sur générer de nouvelles informations d'identification. Elles sont automatiquement enregistrées.
  6. Choisissez une partie contractante. Dès qu'un ordre d'entretien arrive depuis Mareon, cette partie contractante est automatiquement liée comme client à l'ordre.
  7. Indiquez le modèle de commande avec lequel l'ordre est construit, et complétez l'entreprise et les journaux correspondants.


Un endpoint DICO entrant du type SOAP générique


Copiez les informations d'identification avant de fermer la fenêtre. Vous ne pouvez plus les consulter ensuite. Vous pouvez toujours générer de nouvelles informations d'identification, mais vous devez alors les transmettre à nouveau à Mareon.


Générer des informations d'identification sur l'endpoint DICO


Le champ URL de base du service de messagerie est automatiquement complété pour un endpoint entrant avec https://dico.robaws.com/services/MessageService31 et n'est pas modifiable. C'est l'adresse vers laquelle Mareon envoie ses messages.


Mareon envoie ses messages vers cette URL avec Basic Authentication. Sur la base des informations d'identification, Robaws sait à quel environnement le message est destiné. Un message traité se retrouve comme ordre dans le module ordres.


Quelle information du message arrive dans quel champ de l'ordre, vous le déterminez avec des codes de remplacement et des champs supplémentaires sur le modèle de commande. Tout cela est décrit dans l'article sur l'intégration DICO.


Renvoyer des mises à jour de statut vers Mareon


Si vous avez reçu un ordre depuis Mareon, Robaws peut renvoyer les modifications de statut de cet ordre.


Complétez sur ce même endpoint entrant le champ URL pour les commentaires sur l'état. Cette URL se présente comme suit :


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


La <API_KEY> est unique par client. Vous la demandez à Mareon, en même temps que la confirmation de l'URL correcte. Si un login y est également associé, complétez-le dans informations d'identification pour les commentaires sur l'état.


URL pour les commentaires sur l'état sur l'endpoint


Ensuite, vous traduisez les statuts de vos ordres dans Robaws vers un code DICO. Vous faites cela via la fonction Mappage de l'état des commandes DICO dans l'aperçu Dico Endpoints.


La fonction Mappage de l'état des commandes DICO


Pour l'envoi de mises à jour de statut, vous utilisez uniquement la colonne de droite Statut d'ordre > Code DICO sortant. Pour chaque statut d'ordre dans Robaws, vous y complétez le code DICO qui doit être transmis avec le message sortant.


La colonne de droite : statut d'ordre vers code DICO sortant


Si un ordre passe à un statut pour lequel aucun code DICO sortant n'est configuré, aucun message de statut n'est envoyé vers Mareon.


Codes DICO disponibles


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


Recevoir des mises à jour de statut depuis Mareon


Mareon peut également envoyer des mises à jour de statut vers Robaws. Pour cela, vous traduisez le sens inverse : du code DICO vers le statut d'ordre. Utilisez pour cela la colonne de gauche Code DICO entrant > Statut d'ordre dans la même fonction Mappage de l'état des commandes DICO.


La colonne de gauche : code DICO entrant vers statut d'ordre


Si un message de statut arrive avec un code DICO pour lequel aucun statut d'ordre n'est configuré, le statut de l'ordre dans Robaws reste inchangé.


Besoin d'aide ?


Votre question porte sur l'endpoint, le mappage ou le modèle de commande dans Robaws ? Prenez contact via support@robaws.com.


Votre question porte sur votre API key, l'URL de retour de statut ou les messages que Mareon envoie ? Prenez alors contact avec le support de Mareon via aareon.nl/mareon.

Mis à jour le : 28/08/2026

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

Partagez vos commentaires

Annuler

Merci !