---
title: "Adresses (annuaire des sites)"
module: platform
type: functional
status: active
updated: 2026-08-03
---

# Adresses (annuaire des sites)

> Doc fonctionnelle : décrit le **quoi** et le **pourquoi** (point de vue utilisateur / chef de projet).
> Le **comment** vit dans [`.claude/technical-docs/platform/addresses.md`](../../.claude/technical-docs/platform/addresses.md).

## À quoi ça sert

Une **adresse** représente un **site physique** rattaché à une entité (siège, agence,
établissement…). C'est une donnée de référence **transverse** : elle sert de point d'ancrage
géographique aux interventions (GMAO), au matériel (IT), aux données santé (Finess), à la
cartographie, aux exports et aux intégrations. Une même entité peut avoir plusieurs adresses.

> Une adresse n'est pas une donnée « CRM » au sens strict : elle est portée par l'entité
> (`Customer`) mais **consommée par la plupart des modules métier**. Elle est donc documentée au
> niveau du socle `platform`.

## Où on la trouve

Page **Adresses** (menu, droit `ANNU`), organisée en onglets :

| Onglet | Contenu |
|--------|---------|
| **Données internes** | Les adresses des entités du tenant courant. |
| **Données Clients / Partage** | Les adresses des clients partagés (accès prestataire), visible si offre prestataire premium. |

Chaque onglet est une **liste** (tableau ou cartes) filtrable et exportable.

## Ce qu'on peut faire

- **Consulter / rechercher / filtrer** les adresses (par type, entité, adresse principale…).
- **Créer, modifier, archiver** une adresse (archivage logique, jamais de suppression dure).
- **Modifier en masse** (mise à jour groupée) et **archiver en masse** une sélection.
- **Exporter / importer** les adresses (colonnes : lignes 1-4, ville, code postal, téléphone,
  e-mail, fax, responsable, coordonnées GPS, wifi…).
- **Géolocaliser** : latitude / longitude pour l'affichage cartographique.
- **Rattacher une adresse à une adresse « mère »** (hiérarchie site principal / sites rattachés).
- **Télécharger la vCard** d'une ligne (voir [vCard des adresses](#vcard-des-adresses)).

## Règles de gestion visibles

- **Adresse principale** (`blmaster`) : l'adresse de référence d'une entité.
- **Type d'adresse** : liste de valeurs (référentiel `134001`).
- **Hiérarchie mère / filles** : une adresse ne peut être rattachée à une mère que si elle n'est
  elle-même ni mère ni fille.
- **Profil limité** : un utilisateur au profil restreint ne voit que les adresses des entités
  autorisées.

## vCard des adresses

Chaque ligne de la liste propose un bouton de téléchargement d'une **vCard** (fichier `.vcf`)
importable dans un carnet de contacts (Outlook, téléphone…), pour récupérer en un clic les
coordonnées d'un site précis.

- La colonne **VCard** affiche une icône de carte de visite par ligne.
- Un clic télécharge un fichier `contact-<nom de l'entité>.vcf`.
- La vCard reflète les **coordonnées propres à la ligne d'adresse** :
  - adresse postale de la ligne (rue, ville, code postal) ;
  - téléphone et e-mail **de l'adresse** s'ils sont renseignés, sinon repli sur le
    téléphone / e-mail du client ;
  - nom, site web et intitulé issus du client rattaché.

**Changement de comportement** : auparavant, toutes les adresses d'un même client généraient la
**même** vCard (celle de l'adresse principale du client). Désormais, deux adresses distinctes d'un
même client produisent **deux vCards différentes**, chacune avec ses propres coordonnées.

L'accès suit les mêmes règles que la liste : adresses du tenant courant **et** adresses des clients
partagés (accès prestataire).