> ## 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).

# 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](https://support.robaws.com/fr/article/comment-fonctionne-lintegration-dico-ufvgmk/) : 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](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/schermafbeelding-2024-09-19-om_1jo5nxb.png)

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

|| 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](https://support.robaws.com/fr/article/ordre-11dbv3r/).

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](https://support.robaws.com/fr/article/comment-fonctionne-lintegration-dico-ufvgmk/).

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

Ensuite, vous traduisez les [statuts](https://support.robaws.com/fr/article/utilisation-des-statuts-x1eu14/) 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](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/schermafbeelding-2024-09-19-om_ou48i7.png)

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

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

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