# Adresses

L’API Addresses est un système flexible piloté par type. Chaque adresse possède un champ `type` qui définit sa portée et son usage ; les mêmes endpoints prennent en charge tous les types.

## Types d’adresse

| Type | Portée | Description |
|---|---|---|
| `shipping_address` | Par utilisateur | Adresse personnelle de livraison du client |
| `billing_address` | Par utilisateur | Adresse de facturation du client |
| `storage_hub` | À l’échelle du tenant | Point de retrait, entrepôt, magasin ou autre lieu de collecte partagé |

> **Le type `storage_hub` est particulier :** il est associé au tenant et non à un utilisateur. Tout client peut récupérer les hubs de stockage sans être connecté. Utilisez-les pour le retrait en magasin, les listes d’entrepôts, les points de dépôt ou tout lieu physique exploité par votre entreprise.

## Utilisations possibles de `storage_hub`

- **Click & collect** — afficher les magasins comme points de retrait au paiement
- **Réseau d’entrepôts** — exposer les centres d’expédition pour la logistique ou les processus B2B
- **Magasins de revendeurs** — permettre aux vendeurs d’inscrire leur magasin comme point de collecte
- **Réseau de dépôt** — proposer des lieux tiers ou franchisés

Consultez le guide complet des [hubs de stockage](/fr/addresses/storage-hubs).

## Objet adresse

| Champ | Type | Description |
|---|---|---|
| `id` | integer | Identifiant unique de l’adresse |
| `name` | string | Nom du contact ou du lieu |
| `phone_number` | string | Numéro de téléphone du contact |
| `address_line_1` | string | Adresse de rue |
| `address_line_2` | string | Appartement, étage ou bâtiment |
| `city` | string | Ville |
| `state` | string | État ou région |
| `post_code` | string | Code postal |
| `country` | string | Nom du pays |
| `country_code` | string | Code pays ISO |
| `landmark` | string | Point de repère ou indication à proximité |
| `formatted_address` | string | Adresse complète à afficher |
| `type` | string | Type d’adresse ; voir le tableau ci-dessus |
| `current_address` | boolean | Indique s’il s’agit de l’adresse actuellement sélectionnée par l’utilisateur (types associés à un utilisateur uniquement) |
| `coordinates.latitude` | number | Latitude GPS |
| `coordinates.longitude` | number | Longitude GPS |