Esabora ‐ SISH - MTES-MCT/histologe GitHub Wiki
Esabora est l'éditeur du logiciel PourMesDossiers, une solution de gestion de de dossiers. La solution PourMesDossiers SI-SH est utilisée par les ARS des territoires pour gérer des dossiers de signalement.
Pour éviter le double emploi des solutions, un interfaçage avec Histologe a été effectué par Esabora, basé sur des webservices (WS).
L'interfaçage permettra de :
- Créer un dossier dans un SAS intermédiaire à partir d'un signalement déposé sur Histologe.
- Interroger le statut des dossiers du SAS.
- Mettre à jour le signalement sur Histologe en y ajoutant des suivis automatiques à partir des infos récupérées sur le SAS.
- Demander la liste des visites associées à un dossier.
- Demander la liste des arrêtés associées à un dossier.
sequenceDiagram
Histologe->> SAS-I Esabora SI-SH: Envoi du dossier
SAS-I Esabora SI-SH->>SAS Esabora SI-SH: Dossier accepté
SAS-I Esabora SI-SH->>SAS Esabora SI-SH: Dossier refusé
Histologe-->>SAS Esabora SI-SH: Demande de statut du dossier
Note right of SAS Esabora SI-SH: CRON exécuté 1x/jour
SAS Esabora SI-SH->>Histologe: Envoi de statut dossier
Histologe->>Histologe: Mise à jour statut dossier pour ARS
Histologe->>Histologe: Ajout suivi automatique
Note left of SAS Esabora SI-SH: A traiter<br>Importé(en cours)<br>Importé(terminé)<br>Rejeté
Note left of Histologe: En attente<br>Accepté<br>Cloturé<br>Rejeté
Histologe-->>SAS Esabora SI-SH: Demande la liste des visites
Note right of SAS Esabora SI-SH: CRON exécuté 1x/jour
SAS Esabora SI-SH->>Histologe: Envoi de la liste des visites effectuées
Histologe->>Histologe: Ajout suivi automatique
Histologe->>Histologe: Création de visite
Histologe-->>SAS Esabora SI-SH: Demande la liste des arrêtés
Note right of SAS Esabora SI-SH: CRON exécuté 1x/jour
SAS Esabora SI-SH-->>Histologe: Envoi de la liste des arrêtés
Histologe->>Histologe: Ajout suivi automatique
Authentification
L'appel aux web-services doit s'effectuer via une authentification par token. L'URL du web-service ainsi que le token sont fournis par la DSI de l'ARS pour chaque environnement. L'administrateur et les responsables territoire peuvent éditer les informations d'authentification du partenaire ARS
Environnements
Environnement exploité par les équipes dans le cadre de l'interconnexion.
| SI Histologe | SI ARS SI-SH |
|---|---|
| histologe-prod | SI-SH prod |
| histologe-staging (Histologe-INT ) | SI-SH préprod |
Envoi des dossiers
[!NOTE] Pour les territoires où les ARS travaillent en collaboration avec la DDT pour la qualification des signalements, il est recommandé d'encourager la création d'un nouveau partenaires ARS et renommer le premier partenaire en ARS instruction SISH
- ARS supervision sans activer la partie Esabora.
- ARS instruction SISH pour envoi des dossiers au SAS
Pour envoyer un dossier à SI-SH depuis Histologe il est nécessaire d'affecter le partenaire ARS au dossier. Le dossier va contenir trois groupes d'informations:
- Les informations sur l’adresse (SISH_ADRESSE)
- Les informations générales sur le signalement ainsi que les pièces jointes éventuelles (SISH_DOSSIER)
- Les informations sur les différentes personnes liées au signalement (déclarant, occupant, propriétaire) (SISH_DOSSIER_PERSONNE)
Liste des informations transmises
Adresse du signalement
La liste des données envoyé à SISH_ADRESSE
| Fiche signalement | Champs esabora | Description |
|---|---|---|
| Référence technique de la fiche (UUID) | Reference_Adresse | |
| Numéro de l'adresse | Localisation_Numero | Seul le numéro de l'adresse |
| Adverbe adresse | Localisation_NumeroExt | BIS, TER, QUATER, ect... |
| Nom de la rue | Localisation_Adresse1 | Le nom de la voie sans le numéro et l'adverbe |
| Autre adresse | Localisation_Adresse2 | Autre adresse si existe |
| Code postal | Localisation_CodePostal | Code postal du logement |
| Ville | Localisation_Ville | Ville du logement |
| Code insee | Localisation_Insee | Code insee calculée depuis la BAN |
Informations générales
La liste des données envoyé à SISH_DOSSIER
| Fiche signalement | Champs esabora | Description |
|---|---|---|
| Sas_Adresse | Récupérer via SISH_ADRESSE | |
| Sas_LogicielProvenance | Toujours mettre H | |
| UUID du signalement | Reference_Dossier | Référence technique Histologe |
| Sas_DateAffectation | Date à laquelle ARS a été affecté | |
| Etage du logement | Localisation_Etage | |
| Escalier du logement | Localisation_Escalier | |
| Numéro de la porte | Localisation_NumPorte | |
| Nombre d'adulte occupant le logement | SitOccupant_NbAdultes | |
| Nombre d'enfant de moins de 6 ans | SitOccupant_NbEnfantsM6 | |
| Nombre d'enfant de plus de 6 ans | SitOccupant_NbEnfantsP6 | |
| Nombre d'occupant | SitOccupant_NbOccupants | |
| Numéro allocataire | SitOccupant_NumAllocataire | |
| Montant de l'allocation | SitOccupant_MontantAlloc | |
| Bail en cours | SitLogement_BailEncours | 0 (Non), 1 (Oui) |
| Date d’entrée dans le logement | SitLogement_BailDateEntree | JJ/MM/YY |
| Préavis de départ | SitLogement_PreavisDepart | 0 pour non et 1 pour oui |
| Demande de relogement en cours | SitLogement_Relogement | |
| Superficie du logement | SitLogement_Superficie | |
| Montant du loyer | SitLogement_MontantLoyer | |
| Effectué par autre que l'occupant | Declarant_NonOccupant | 0(Non), 1(Oui) |
| Nature du logement | Logement_Nature | appartement, maison, autre |
| Est ce un logement social | Logement_Social | |
| Année de construction du logement | Logement_AnneeConstr | |
| Construit avant 1949 | Logement_Avant1949 | 0 (Non), 1 (Oui) |
| Nombre de pièces du logement | Logement_NbPieces | |
| Nombre de chambres | Logement_NbChambres | |
| Nombre d'étages | Logement_NbNiveaux | |
| Propriétaire averti ? | Proprietaire_Averti | 0 (Non), 1 (Oui) |
| Date à laquelle le bailleur a été averti | Proprietaire_AvertiDate | |
| Par quel moyen | Proprietaire_AvertiMoyen | |
| Score de criticite | Signalement_Score | |
| Référence du signalement | Signalement_Numero | |
| Premier suivi partenaire | Signalement_Commentaire | |
| Date dépôt du signalement | Signalement_Date | |
| Message déposé par le déclarant | Signalement_Details | |
| Liste des désordres | Signalement_Problemes | |
| URL du signalement | Signalement_URL | |
| Liste des pièces jointes associés aux dossiers | PJ_Documents |
Personnes
La liste des données envoyé à SISH_DOSSIER_PERSONNE Ces information sont à envoyer pour tous les types de personnes
- Déclarant
- Occupant (A envoyer si les informations de l'occupant sont renseignées)
- Propriétaire (A envoyer si les informations du propriétaire sont renseignées)
| Fiche signalement | Champs esabora | Description |
|---|---|---|
| Type | Personne_Type | D pour déclarant, O pour occupant et P propriétaire |
| Nom | Personne_Nom | Nom de la personne |
| Prénom | Personne_Prenom | Prénom de la personne |
| Personne_Mail | Prénom de la personne | |
| Téléphone | Personne_Telephone | Téléphone de la personne |
| Structure | Personne_Structure | Structure de la personne (nom organisme) |
| Lien Occupant | Personne_LienOccupant | Lien entre l'occupant et le tiers déclarant |
| Adresse | Personne_Adresse | A envoyer uniquement pour le propriétaire |
Synchronisation des dossiers
Chaque nuit Histologe interroge le web service Esabora afin de récupérer des informations de statut de dossiers, la liste des visites et arrêtés. L'objectif de cette opération vise à assurer la synchronisation des données entre les deux systèmes.
Synchronisation des statuts
Le web service SISH_ETAT_DOSSIER_SAS permet d’obtenir l'état associé d'un dossier :
- A traiter
- Rejeté
- Importé
- en cours
- terminé
La synchronisation des statuts fonctionne dans un sens spécifique (Esabora vers Histologe uniquement). Elle déclenche une mise à jour de statut du dossier sur Histologe pour le partenaire ARS et ajoute un message de suivi.
Voici un tableau de correspondance de statut entre les deux systèmes.
| Déclencheur | Statut SISH | Statut Histologe | Message de suivi généré sur Histologe |
|---|---|---|---|
| Depuis l'application HISTOLOGE, un signalement (dossier) est affecté à un partenaire ARS depuis Histologe | A traiter | wait | ...remis en attente via SI-SH |
| Depuis l'application SISH, un agent ARS accepte un dossier | Importé - en cours | accepted | ...accepté via SI-SH |
| Depuis l'application SISH, un agent ARS clôture un dossier | Importé - terminé | closed | ...cloturé via SI-SH |
| Depuis l'application SISH, un agent ARS refuse un dossier en sélectionnant un motif | Rejeté | refused | ...refusé via SI-SH pour le motif suivant : ... |
[!IMPORTANT] La mise à jour des statuts doit donc être effectuée non pas sur Histologe mais sur Esabora. Si une validation est effectuée sur HIstologe, le signalement sera toujours remis en attente car le statut sur Esabora prévaut sur celui d'Histologe.
Liste des informations envoyés par SISH_ETAT_DOSSIER_SAS
| Données |
|---|
| Référence Histologe |
| Etat du dossier dans le SAS (A traiter / Importé / Rejeté) |
| Date et heure de décision prise sur l'intégration ou non du dossier dans SI-SH (renseignée uniquement pour les états Importé / Rejeté) |
| Cause du refus du dossier (renseignée uniquement pour l'état Rejeté) |
| Id technique du dossier créé dans SISH (si le dossier a été importé) |
| N° de dossier dans SISH (si le dossier a été importé) |
| Objet de dossier dans SISH (= adresse du dossier) |
| Date de clôture du dossier |
| Libellé abrégé du statut pour le dossier |
| Libellé du statut pour le dossier |
Synchronisation des visites
Le web service SISH_VISITES_DOSSIER_SAS permet d’obtenir la liste des visites effectuées à un dossier.
Si un dossier SISH ne contient aucune visite effectuée, la liste retournée sera vide. Dans le cas contraire le web service renverra la liste des visites qui impliquera la création de visites et la génération de suivi sur Histologe
Il existe 2 types de visite pour un dossier :
- une visite initiale
- une visite de contrôle
Liste des informations envoyés par SISH_ETAT_DOSSIER_SAS
| Données | Description |
|---|---|
| N° de dossier dans SISH | |
| Date et heure de la visite | |
| N° de la visite dans SISH | |
| Type de la visite | Visite initiale ou de contrôle |
| Service qui a effectué la visite | Vide / ARS / SCHS / SH / STH |
La conclusion de la visite ainsi que le rapport de visite ne sont pas envoyés.
Synchronisation des arrêtés
Le web service SISH_ARRETES_DOSSIER_SAS permet d’obtenir la liste des arrêtés associés à un dossier.
Si un dossier SISH ne contient aucun arrêtés, la liste retournée sera vide. Dans le cas contraire le web service renverra la liste des arrếtés sans document qui impliquera la création d'un suivi sur le dossier.
Exemple:
L'arrêté 2021-222-006 du 10/08/2019 dans le dossier de n°2021/DD04/00129. Type arrêté: Arrêté L.511-19 - Insalubrité
Liste des informations envoyés par SISH_ARRETES_DOSSIER_SAS
| Données |
|---|
| Date de l'arrêté |
| Numéro de l'arrêté dans SISH |
| Type d'arrếté |
| Date de l'arrêté de mainlevée |
| N° de l'arrêté de mainlevée dans SISH |
Documentation
La documentation sur les contrats d'interfaces de chaque web-service se trouve sur le drive :
https://bit.ly/48QTrHv (accès restreint aux utilisateurs autorisés)