> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lieux

> Fonctionnement des lieux de test dans l'API Aniva : pharmacies et cabinets qui réalisent des prises de sang, horaires d'ouverture, disponibilités et prix publics.

Un lieu est un centre de test physique où des prises de sang sont effectuées par des professionnels de santé. Tu utilises l'`id` d'un lieu pour planifier des rendez-vous `practitioner`.

> [!NOTE]
>
> Ta clé API renvoie uniquement les lieux compris dans ton contexte d'accès partenaire. Utilise `GET
>     /api/v1/locations` pour lister tous les lieux qui te sont accessibles.

Un [webhook](https://docs.anivahealth.com/fr/concepts/webhooks.md) `location.*` t'avertit lorsqu'un lieu apparaît, change ou disparaît.

## Champs

**id** `string` *required*

UUID du lieu. Passe-le en tant que `location_id` lors de la création d'un rendez-vous.

**name** `string` *required*

Nom affiché du lieu.

**company\_name** `string`

Clinique ou entreprise qui exploite le lieu. Peut être null.

**street** `string`

Nom de la rue, sans le numéro. Peut être null.

**house\_number** `string`

Numéro de rue. Peut être null.

**address\_line\_2** `string`

Complément d'adresse — chez, bâtiment ou étage. Peut être null.

**city** `string`

Ville. Peut être null.

**state** `string`

État ou province (résolu via l'État rattaché à la ville). Peut être null lorsque la ville n'a pas
d'État rattaché.

**state\_code** `string`

Code [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html) de l'État sans le
préfixe pays (par ex. `BW` pour Baden-Württemberg). Peut être null.

**postal\_code** `string`

Code postal ou code ZIP. Peut être null.

**country\_name** `string`

Nom complet du pays (par ex. `Germany`). Peut être null.

**country\_code** `string`

Code pays à deux lettres selon [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
(par ex. `DE`, `US`). Peut être null.

**timezone** `string`

Identifiant de fuseau horaire IANA du lieu (par ex. `Europe/Berlin`, `America/New_York`). Utilise-le
pour afficher les horaires prévus à la bonne heure locale. Peut être null.

**latitude** `number`

Latitude de l'adresse en degrés décimaux (WGS 84). Peut être null.

**longitude** `number`

Longitude de l'adresse en degrés décimaux (WGS 84). Peut être null.

**contact\_phone** `string`

Numéro de téléphone du lieu. Peut être null.

**email** `string`

Adresse e-mail du lieu. Peut être null.

**website** `string`

URL du site web du lieu. Peut être null.

**google\_maps\_url** `string`

Lien direct vers le lieu sur Google Maps. Peut être null.

**image\_url** `string`

URL d'une photo du lieu. Peut être null.

**open\_hours** `object`

Horaires d'ouverture hebdomadaires du lieu. Chaque clé de jour (`monday`–`sunday`) renvoie à un
tableau de plages horaires `{ open, close }` au format `HH:MM` (24 h). Un tableau vide indique que
le lieu est fermé ce jour-là. Peut être null si les horaires ne sont pas disponibles pour ce lieu.

**default\_draw\_method** `string` *required*

Comment la prise de sang est effectuée lors d'un rendez-vous dans ce lieu, sauf si le rendez-vous
définit son propre `draw_method` : `capillary` (au bout du doigt ou dans le haut du bras, dans des
microtubes) ou `venous` (dans la veine, dans des tubes).

**draw\_methods** `string[]` *required*

Les méthodes de prise de sang pour lesquelles le lieu dispose de contenants, triées. Un
rendez-vous dans ce lieu ne peut définir que l'une d'entre elles comme `draw_method`.

> [!TIP]
>
> Utilise toujours le champ `timezone` pour convertir les dates et heures `scheduled_at` en heure
> locale avant de les afficher aux patients ou au personnel.

## Disponibilité

Le champ `open_hours` ci-dessus décrit les horaires d'ouverture hebdomadaires fixes. Pour afficher de vrais créneaux réservables — et éviter les doublons avec les rendez-vous Aniva existants — appelle [Obtenir les disponibilités](https://docs.anivahealth.com/fr/api/locations/get-availability.md) pour le lieu et passe-lui la plage de dates que tu veux afficher. Cet endpoint est la bonne source de vérité pour toute interface de réservation : il déploie `open_hours` sur la grille de créneaux du lieu, applique les exceptions par date, soustrait les rendez-vous déjà réservés et applique le [délai de préavis minimum](https://docs.anivahealth.com/fr/api/appointments/create-appointment.md#delai-minimum).

## Prix publics

Une pharmacie fixe son propre prix pour chaque panel et pour chaque biomarqueur individuel
qu'elle vend aux clients de passage. Tu ne vois un prix qu'une fois que la pharmacie le publie.
[Lister les prix publics](https://docs.anivahealth.com/fr/api/locations/list-retail-prices.md) les renvoie pour tous les lieux que tu
peux lire, et [Obtenir les prix publics](https://docs.anivahealth.com/fr/api/locations/get-retail-prices.md) les renvoie pour un seul
lieu. Les deux nécessitent le scope `retail_prices_view` ; `locations_view` ne les inclut pas.
Demande les deux scopes sur les mêmes lieux.

Un [webhook](https://docs.anivahealth.com/fr/concepts/webhooks.md) `location.retail_prices.updated` t'informe quand un prix change.
`location.created` et `location.deactivated` t'indiquent quand un lieu apparaît ou disparaît. Un
changement dans les panels proposés par un lieu peut te parvenir après un changement de prix, relis
donc Lister les prix publics une fois par jour.

## Exemple de lieu

```json theme={null}
{
  "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "name": "Mitte Health Center",
  "company_name": "Aniva Berlin GmbH",
  "street": "Friedrichstraße",
  "house_number": "100",
  "address_line_2": null,
  "city": "Berlin",
  "state": "Berlin",
  "state_code": "BE",
  "postal_code": "10117",
  "country_name": "Germany",
  "country_code": "DE",
  "timezone": "Europe/Berlin",
  "latitude": 52.531677,
  "longitude": 13.388042,
  "contact_phone": "+493012345678",
  "email": "berlin@anivahealth.com",
  "website": "https://anivahealth.com",
  "google_maps_url": "https://maps.google.com/?q=Friedrichstra%C3%9Fe+100+Berlin",
  "image_url": "https://anivahealth.com/images/locations/berlin-mitte.jpg",
  "open_hours": {
    "monday": [{ "open": "08:00", "close": "18:00" }],
    "tuesday": [{ "open": "08:00", "close": "18:00" }],
    "wednesday": [{ "open": "08:00", "close": "18:00" }],
    "thursday": [{ "open": "08:00", "close": "18:00" }],
    "friday": [{ "open": "08:00", "close": "16:00" }],
    "saturday": [],
    "sunday": []
  },
  "default_draw_method": "venous",
  "draw_methods": ["venous"]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.