Ajouter des métadonnées sur la fiche d'un convive – Innovorder

Besoin de stocker sur un convive une information qui n’a pas de champ dédié dans Innovorder : identifiant dans un logiciel tiers, origine d’un import, référence d’intégration… ? Depuis la fiche client du Backoffice, vous pouvez désormais ajouter des métadonnées : des données libres, au format texte ou JSON, rattachées au convive.

📋 Ce qu’il faut savoir
• Les métadonnées se gèrent dans l’onglet Informations de la fiche client (Backoffice), ou via l’API Innovorder.
• Seuls les comptes Enseigne peuvent ajouter ou modifier une métadonnée. Les comptes Restaurant les consultent en lecture seule.
• Elles se consultent convive par convive : elles n’apparaissent ni dans l’export de fin de mois, ni dans l’export de la base convives.

À quoi servent les métadonnées ?

Elles servent surtout aux intégrations : un logiciel connecté à Innovorder peut y déposer ses propres informations, puis les relire, sans détourner un champ standard (code tarif, commentaire…).

Exemple d’usage	Clé	Contenu
Identifiant dans un logiciel tiers	`integration.reference`	L’ID du convive dans l’outil externe
Traçabilité d’un import	`import.origine`	Import automatique, application, date de mise à jour…

Consulter les métadonnées d’un convive

1. Dans le Backoffice, cliquez sur Clients dans le menu de gauche, puis recherchez et ouvrez la fiche du convive.

2. Dans l’onglet Informations, descendez sous le bloc Coordonnées jusqu’au bloc Métadonnées (1). Le chiffre à côté du titre indique le nombre de métadonnées enregistrées pour ce convive.

Ajouter une métadonnée

3. Cliquez sur + Ajouter une métadonnée (2).

4. Dans le champ Clé (3), saisissez le nom de la donnée, par exemple integration.reference. La clé est unique pour un convive : vous ne pouvez pas créer deux métadonnées avec la même clé.

5. Choisissez le Format (4) :

Format	Quand l’utiliser	Exemple de contenu
Texte	Une valeur simple, conservée exactement telle que saisie.	`EXT-99887`
JSON	Plusieurs informations structurées dans une même métadonnée. Le contenu doit être un JSON valide.	`{"source": "import auto", "maj": "2026-09-21"}`

6. Renseignez le Contenu (5), puis cliquez sur Enregistrer (6). La métadonnée apparaît dans le bloc Métadonnées de la fiche.

⚠️ Bon à savoir
• Une clé ne peut pas être renommée après sa création : pour changer de clé, créez une nouvelle métadonnée.
• Si une métadonnée Traçabilité est présente, elle est gérée automatiquement par Innovorder (origine et dernière modification du convive) : elle est en lecture seule et ne peut pas être supprimée.

Utiliser les métadonnées via l’API

Vos intégrations peuvent lire, créer, modifier et supprimer les métadonnées d’un convive par API. Toute la documentation technique (clés, formats texte/JSON, gestion des conflits, traçabilité) est disponible sur le portail développeur.

Voir la documentation API

☝️ Pratique !
Les métadonnées évitent de détourner un champ standard pour y stocker une info technique (par exemple écrire une date d’import dans le code tarif) : vos données de fiche restent propres.