Esabora ‐ SISH

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

Loading

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
Email	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)