# Comprendre les objets

Le vocabulaire commun à l’interface, à l’API et aux assistants.

## Relation client

| Terme | Signification |
|---|---|
| Organisation | Espace de travail isolé d'un client de Cercla |
| Société | Compte d'une entreprise, avec ses contacts et ses ventes |
| Contact | Personne physique, qui peut être liée à plusieurs sociétés ou acheter en son nom |
| Affiliation | Lien entre une personne et une société, avec un rôle et une période |
| Propriétaire | Utilisateur auquel une fiche est attribuée ; à distinguer des droits d'administration |
| Entité | Unité de vente, filiale, agence ou marque qui porte les opérations |
| Cycle | Période de vente, par exemple une année ou une saison |

## De la vente au règlement

Un **devis** porte la proposition et le pipeline commercial. Un **contrat** naît d'un devis signé et décrit l'engagement dans le temps. Un **avenant** passe par une nouvelle version signée du devis. Une **échéance** représente une part à facturer. Une **facture** est le document émis pour demander le règlement. Un **avoir** corrige une facture selon le parcours de facturation.

Une **commande** provient notamment de la boutique ou de l'acceptation au portail. La signature d'un devis dans le CRM ne signifie pas à elle seule qu'une commande boutique est créée.

## Travail quotidien

Une **requête** est une demande de service d'un client. Une **activité** est un appel, un rendez-vous ou une tâche à accomplir. Une **note** est un compte rendu dans le fil. Un **document rattaché** est un fichier placé sur une fiche ; un **document envoyé** est la version du PDF transmise au client.

## Intégrations

Une **app connectée** est une intégration machine avec des droits nommés **scopes**. Son **périmètre** limite les données accessibles. Un **webhook** notifie un système externe d'un événement. Le **MCP** donne à un assistant des outils pour lire et agir dans Cercla. Une **approbation** est une action en attente de validation humaine, pas une action déjà exécutée.

Dans les contrats techniques, les noms restent stables : `company`, `contact`, `quote`, `businessUnit`, `cycle`. Les noms affichés à l'utilisateur peuvent être adaptés par l'organisation.