Mappings

URL : /organizations/{orgId}/mappings • Menu : Suivi des activités ▸ Mappings • Permission requise : service_read (+ service_update pour éditer)

Règles de transformation appliquées aux données échangées entre votre organisation et la plateforme. Permettent de traduire votre format vers le format pivot ASACI, ou inversement.

Structure

Les mappings sont regroupés par service. Pour chaque service, vous voyez :

• un bloc avec le nom du service et un bouton « Modifier » ;
• la liste des règles déjà définies.

Sens d'un mapping

Sens	Code	Description
Requête	REQUEST (REQUETE (PLATEFORME → PARTENAIRE))	Transformation appliquée à la donnée envoyée.
Réponse	RESPONSE (REPONSE (PARTENAIRE → PLATEFORME))	Transformation appliquée à la donnée reçue.

Colonnes d'une règle

Colonne	Description
SOURCE	Chemin du champ source (ex. numeroCMU).
CIBLE	Chemin du champ cible (ex. beneficiaryNumber).
TRANSFORMATION	Règle à appliquer (voir tableau).
RESSOURCE	Code de la ressource ciblée par la règle (rights, claim, invoice, *…). Une même règle peut être restreinte à un type de ressource pour ne s'appliquer qu'aux flux concernés.
ORDRE	Ordre d'exécution (croissant) au sein du sens Requête / Réponse.

Sens (REQUETE / REPONSE)

Le sens d'une règle est porté par la section dans laquelle elle apparaît (en-tête « REQUETE (PLATEFORME → PARTENAIRE) » ou « REPONSE (PARTENAIRE → PLATEFORME) ») — pas par une colonne dédiée du tableau.

Règles de transformation

Règle	Expression requise	Description
TRIM	Non	Supprime les espaces aux extrémités.
UPPER	Non	Majuscules.
LOWER	Non	Minuscules.
TRIM_UPPER	Non	TRIM + UPPER.
DATE_FR_TO_ISO	Non	JJ/MM/AAAA → AAAA-MM-JJ.
DATE_ISO_TO_FR	Non	AAAA-MM-JJ → JJ/MM/AAAA.
DECIMAL_2	Non	Force 2 décimales.
DECIMAL_4	Non	Force 4 décimales.
MAP_STATUS_CODE	Oui	Mapping clé/valeur.
DEFAULT	Oui	Valeur par défaut si source vide.
REPLACE	Oui	Remplace un motif.
JSONATA	Oui	Expression JSONATA complète.
CUSTOM_JS	Oui	Déprécié — préférer JSONATA.

Modifier les mappings d'un service

Cliquez sur « Modifier » à droite du service. Un éditeur s'ouvre avec deux onglets : Mapping requête et Mapping réponse.

Vous pouvez :

• Ajouter une règle (bouton « Ajouter » en haut à droite).
• Modifier une règle existante (cliquer dessus).
• Supprimer une règle.
• Réordonner via le champ Ordre.

Cliquez sur « Enregistrer » pour valider. Les nouvelles règles sont immédiatement actives.

Erreur de mapping = échecs systémiques

Une règle erronée peut provoquer le rejet de toutes les transmissions sur le service concerné. Testez vos expressions sur des données réelles avant d'enregistrer en production.

Exemple JSONATA — pivot ASACI vers format CNAM

{
  "beneficiaryNumber": numeroCMU,
  "surname": $uppercase(nom),
  "name": $uppercase(prenom),
  "dateOfBirth": dateNaissance,
  "sexDescription": sexe = "M" ? "HOMME" : "FEMME",
  "coverageRate": (coverageTarifAmount / 100) & "%"
}

Bonnes pratiques

• Préférez les règles simples (TRIM, UPPER, DATE_FR_TO_ISO…) aux expressions JSONATA quand c'est possible — elles sont plus lisibles et plus rapides.
• Utilisez ORDRE pour contrôler l'enchaînement (TRIM avant UPPER).
• Vérifiez les transmissions après modification — voir Diagnostiquer un échec.

Voir aussi

• Services configurés — services associés aux mappings.
• Diagnostiquer un échec.