> ## 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.

# Sedi

> Come funzionano le sedi per gli esami nell'API di Aniva: farmacie e studi medici che effettuano prelievi di sangue, orari di apertura, disponibilità e prezzi al pubblico.

Una sede è un centro analisi fisico in cui il personale sanitario esegue i prelievi di sangue. Usi l'`id` di una sede per fissare appuntamenti `practitioner`.

> [!NOTE]
>
> La tua chiave API restituisce solo le sedi nel tuo contesto di accesso partner. Usa `GET
>     /api/v1/locations` per elencare tutte le sedi disponibili per te.

Un [webhook](https://docs.anivahealth.com/it/concepts/webhooks.md) `location.*` ti avvisa quando una sede compare, cambia o scompare.

## Campi

**id** `string` *required*

UUID della sede. Passalo come `location_id` quando crei un appuntamento.

**name** `string` *required*

Nome visualizzato della sede.

**company\_name** `string`

Clinica o azienda che gestisce la sede. Può essere null.

**street** `string`

Nome della via, senza il numero civico. Può essere null.

**house\_number** `string`

Numero civico. Può essere null.

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

Riga di indirizzo aggiuntiva — c/o, edificio o piano. Può essere null.

**city** `string`

Città. Può essere null.

**state** `string`

Stato o provincia (risolto tramite lo stato collegato alla città). Può essere null quando la città
non ha uno stato collegato.

**state\_code** `string`

Il codice [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html) dello stato senza il
prefisso del paese (es. `BW` per il Baden-Württemberg). Può essere null.

**postal\_code** `string`

Codice postale o CAP. Può essere null.

**country\_name** `string`

Nome completo del paese (es. `Germany`). Può essere null.

**country\_code** `string`

Codice paese a due lettere secondo [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
(es. `DE`, `US`). Può essere null.

**timezone** `string`

Identificatore del fuso orario IANA della sede (es. `Europe/Berlin`, `America/New_York`). Usalo
per mostrare gli orari programmati nell'ora locale corretta. Può essere null.

**latitude** `number`

Latitudine dell'indirizzo in gradi decimali (WGS 84). Può essere null.

**longitude** `number`

Longitudine dell'indirizzo in gradi decimali (WGS 84). Può essere null.

**contact\_phone** `string`

Numero di telefono della sede. Può essere null.

**email** `string`

Indirizzo email della sede. Può essere null.

**website** `string`

URL del sito web della sede. Può essere null.

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

Link diretto alla sede su Google Maps. Può essere null.

**image\_url** `string`

URL di una foto della sede. Può essere null.

**open\_hours** `object`

Orari di apertura settimanali della sede. Ogni chiave del giorno della settimana (`monday`–`sunday`)
corrisponde a un array di fasce orarie `{ open, close }` in formato `HH:MM` (24 ore). Un array vuoto
indica che la sede è chiusa quel giorno. Può essere null se gli orari non sono disponibili per la sede.

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

Come viene effettuato il prelievo di sangue durante un appuntamento in questa sede, salvo che l'appuntamento imposti il proprio `draw_method`:
`capillary` (dal polpastrello o dalla parte superiore del braccio, in microprovette) o `venous` (dalla vena, in provette).

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

I metodi di prelievo per cui la sede dispone di contenitori, ordinati. Un appuntamento in questa sede può impostare solo uno
di questi come `draw_method`.

> [!TIP]
>
> Usa sempre il campo `timezone` per convertire le date e gli orari di `scheduled_at` in ora locale
> prima di mostrarli ai pazienti o allo staff.

## Disponibilità

Il campo `open_hours` qui sopra descrive gli orari di apertura settimanali statici. Per mostrare gli slot realmente prenotabili — ed evitare doppie prenotazioni rispetto agli appuntamenti Aniva esistenti — chiama [Ottieni disponibilità](https://docs.anivahealth.com/it/api/locations/get-availability.md) per la sede e passa l'intervallo di date che vuoi mostrare. Quell'endpoint è la fonte di riferimento per qualsiasi interfaccia di prenotazione: espande `open_hours` sulla griglia di slot della sede, applica le eccezioni per singola data, sottrae gli appuntamenti già prenotati e applica il [preavviso minimo](https://docs.anivahealth.com/it/api/appointments/create-appointment.md#preavviso-minimo).

## Prezzi al pubblico

Ogni farmacia stabilisce il proprio prezzo per ciascun pannello e per ogni singolo biomarcatore che
vende ai clienti senza appuntamento. Vedi un prezzo solo dopo che la farmacia lo pubblica.
[Elenca prezzi al pubblico](https://docs.anivahealth.com/it/api/locations/list-retail-prices.md) li restituisce per ogni sede che puoi
leggere, mentre [Ottieni prezzi al pubblico](https://docs.anivahealth.com/it/api/locations/get-retail-prices.md) li restituisce per una
singola sede. Entrambi richiedono lo scope `retail_prices_view`; `locations_view` non li include.
Richiedi entrambi gli scope sulle stesse sedi.

Un [webhook](https://docs.anivahealth.com/it/concepts/webhooks.md) `location.retail_prices.updated` ti avvisa quando cambia un prezzo.
`location.created` e `location.deactivated` ti avvisano quando una sede viene aggiunta o rimossa.
Una modifica ai pannelli offerti da una sede può arrivarti dopo una variazione di prezzo, quindi
leggi di nuovo Elenca prezzi al pubblico una volta al giorno.

## Esempio di sede

```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.