Services

Menu : Suivi des activités ▸ Services • Permission requise : service_read (+ service_create, service_update, service_delete pour agir)

L'entrée Services du menu côté organisation donne accès à deux écrans distincts :

Écran	URL	Vocation
Catalogue des modules d'intégration	/services	Référence des modules disponibles sur la plateforme (lecture seule). C'est l'écran qui s'ouvre par défaut quand vous cliquez sur Services dans la sidebar.
Services configurés	/organizations/{orgId}/services	Vue détaillée des services activés pour votre organisation (URL, credential, mapping, timeout, circuit breaker). Accessible aussi depuis la fiche organisation, onglet Services.

Catalogue des modules d'intégration

Accessible directement par Services dans la sidebar (URL /services). Liste des modules publiés par la plateforme — pas spécifique à votre organisation.

Colonnes

Colonne	Description
Code module	Identifiant technique (mi-adjudication, mi-consultation-droits, mi-transmission…).
Nom	Libellé fonctionnel (ex. Module Adjudication, Module Transmission de Données).
Statut	Actif (🟢), Maintenance (🟠), Déprécié (⚪).
Version	Version contractuelle (ex. 1.0.0).
Date enregistrement	Date de publication du module.
Activé	Bascule on/off — lecture seule côté organisation (réservée à l'admin plateforme). Si un module passe en Maintenance, vos flux qui en dépendent seront coupés le temps de l'opération.
Actions	📄 Voir le contrat API — ouvre le volet Contrat API.

Volet Contrat API

Cliquez sur l'icône 📄 « Voir le contrat API » dans la colonne Actions (ou sur la ligne) pour ouvrir le volet « Contrat API » — il affiche la spécification OpenAPI 3.0 complète du module. Voir Catalogue des modules (admin) pour le détail des onglets Flux Métier / Administration et du bouton Authorize.

Services configurés (par organisation)

URL : /organizations/{orgId}/services (accessible aussi via la fiche organisation, onglet Services).

Vue détaillée des services activés pour votre organisation. Chaque ligne = une instance configurée d'un module (URL + credential + paramètres techniques).

Différence module / service

• Un module est le « modèle » fourni par la plateforme — visible dans le catalogue. Les trois modules courants :
  • mi-consultation-droits (resourceCode rights) — vérification en temps réel des droits d'un assuré.
  • mi-adjudication — décision de prise en charge d'actes de soin (endpoint /claims, resourceCode claim) et facturation de clôture (endpoint /invoices, resourceCode invoice).
  • mi-transmission — envoi batch asynchrone de données inter-organisations, typiquement la base d'adhérents (POPULATION).
• Un service est une instance configurée d'un module pour votre organisation : URL, credential, mapping, timeout, circuit breaker.

Une même organisation peut avoir plusieurs services pour le même module si elle gère plusieurs flux distincts (par exemple, un service /claims et un service /invoices pour l'adjudication).

Colonnes

Colonne	Description
Statut	Pastille ACTIVE (🟢) ou INACTIVE (⚪) du service.
Module	Code du module (mi-consultation-droits, mi-adjudication, mi-transmission…).
Connecteur	Code du connecteur (REST_SYNC, REST_ASYNC, SFTP_OUTBOUND…).
Direction	INBOUND (entrant dans la plateforme — l'org émet) ou OUTBOUND (sortant de la plateforme — la plateforme émet).
Ressource	Code ressource. Valeurs selon le module : rights, claim, invoice, POPULATION, ou * (toutes).
Credential	Credential associé (lien vers la page Credentials).
Url	Endpoint technique.
Méthode	Verbe HTTP (GET, POST, PUT, PATCH).
Timeout	Délai max en ms.
Circuit Breaker	ON / OFF.
Retry max	Nombre de ré-essais.
Actions	🖊️ Modifier • ⋮ Plus d'actions.

Filtres

Bouton Filtres : panneau latéral avec filtrage par Direction (INBOUND / OUTBOUND) et Module.

Modifier un service

Cliquez sur 🖊️ sur la ligne du service. Un volet d'édition s'ouvre. Selon votre rôle, vous pouvez modifier :

• L'URL d'endpoint.
• La méthode HTTP.
• Le timeout, le retry, le circuit breaker.
• Le credential associé.
• Pour un flux sortant : le fallback (interne ASACI + URL).

Modifications immédiates

Une modification d'URL ou de méthode HTTP est prise en compte dès le prochain appel. Prévenez votre équipe technique avant tout changement en production.

Direction d'un service

Direction	Signification
INBOUND (Entrant)	Entrant dans la plateforme : votre organisation émet la requête, la plateforme la reçoit. Cas typique : votre SI appelle l'API ASACI (consultation droits, dépôt d'adjudication…).
OUTBOUND (Sortant)	Sortant de la plateforme : la plateforme émet la requête, votre organisation la reçoit. Cas typique : ASACI pousse une transmission batch (population) vers votre endpoint.

Connecteurs typiques

Rappel : entrant = entrant dans la plateforme (org → plateforme) ; sortant = sortant de la plateforme (plateforme → org).

Code	Protocole	Usage
REST_SYNC	REST	Échange synchrone (entrant ou sortant selon la Direction) — réponse immédiate.
REST_ASYNC	REST	Échange asynchrone — réponse différée.
SFTP_OUTBOUND	SFTP	Sortant de la plateforme : la plateforme dépose un fichier sur le SFTP de l'organisation.
SFTP_INBOUND	SFTP	Entrant dans la plateforme : l'organisation dépose un fichier sur le SFTP exposé par la plateforme.

Champs spécifiques selon le type

REST

• endpointUrl, httpMethod, timeoutMs, retryMax
• circuitBreakerEnabled, fallbackEnabled, fallbackEndpointUrl

SFTP

• fileFormat (CSV, JSON, XML)
• fileNamingPattern
• allowDuplicateFiles
• scheduleCron

Voir aussi

• Credentials — gérer les jetons utilisés par les services.
• Mappings — règles de transformation des données.
• Renouveler un credential — parcours de rotation.