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

# Ubicacions

> Com funcionen les ubicacions d'anàlisi a l'API d'Aniva: farmàcies i consultoris que fan extraccions de sang, horaris d'obertura, disponibilitat i preus de venda al públic.

Una ubicació és un centre físic de proves on professionals sanitaris fan extraccions de sang. Fas servir l'`id` d'una ubicació per programar cites `practitioner`.

> [!NOTE]
>
> La teva clau d'API només retorna les ubicacions del teu context d'accés de soci. Fes servir `GET
>     /api/v1/locations` per llistar totes les ubicacions disponibles per a tu.

Un [webhook](https://docs.anivahealth.com/ca/concepts/webhooks.md) `location.*` t'avisa quan una ubicació apareix, canvia o desapareix.

## Camps

**id** `string` *required*

UUID de la ubicació. Passa'l com a `location_id` quan creïs una cita.

**name** `string` *required*

Nom visible de la ubicació.

**company\_name** `string`

Clínica o empresa que gestiona la ubicació. Pot ser nul.

**street** `string`

Nom del carrer, sense el número de portal. Pot ser nul.

**house\_number** `string`

Número de portal. Pot ser nul.

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

Línia d'adreça addicional — a l'atenció de, edifici o planta. Pot ser nul.

**city** `string`

Ciutat. Pot ser nul.

**state** `string`

Estat o província (resolt a través de l'estat vinculat a la ciutat). Pot ser nul quan la ciutat no
té cap estat vinculat.

**state\_code** `string`

Codi [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html) de l'estat sense el
prefix del país (p. ex., `BW` per a Baden-Württemberg). Pot ser nul.

**postal\_code** `string`

Codi postal o ZIP. Pot ser nul.

**country\_name** `string`

Nom complet del país (p. ex., `Germany`). Pot ser nul.

**country\_code** `string`

Codi de país de dues lletres segons [ISO 3166-1 alfa-2](https://www.iso.org/iso-3166-country-codes.html)
(p. ex., `DE`, `US`). Pot ser nul.

**timezone** `string`

Identificador de fus horari IANA de la ubicació (p. ex., `Europe/Berlin`, `America/New_York`). Fes-lo servir
per mostrar les hores programades en l'hora local correcta. Pot ser nul.

**latitude** `number`

Latitud de l'adreça en graus decimals (WGS 84). Pot ser nul·la.

**longitude** `number`

Longitud de l'adreça en graus decimals (WGS 84). Pot ser nul·la.

**contact\_phone** `string`

Número de telèfon de la ubicació. Pot ser nul.

**email** `string`

Adreça electrònica de la ubicació. Pot ser nul·la.

**website** `string`

URL del lloc web de la ubicació. Pot ser nul·la.

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

Enllaç directe a la ubicació a Google Maps. Pot ser nul.

**image\_url** `string`

URL d'una foto de la ubicació. Pot ser nul·la.

**open\_hours** `object`

Horari d'obertura setmanal de la ubicació. Cada clau de dia de la setmana (`monday`–`sunday`) correspon a una matriu de
franges horàries `{ open, close }` en format `HH:MM` (24 h). Una matriu buida indica que la ubicació està tancada
aquell dia. Pot ser nul si l'horari no està disponible per a la ubicació.

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

Com es fa l'extracció de sang en una cita aquí, llevat que la cita defineixi el seu propi
`draw_method`: `capillary` (punta del dit o part superior del braç, en microtubs) o `venous` (de
la vena, en tubs).

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

Els mètodes d'extracció per als quals la ubicació disposa de contenidors, ordenats. Una cita aquí
només pot definir un d'aquests com a `draw_method`.

> [!TIP]
>
> Fes servir sempre el camp `timezone` per convertir les dates i hores `scheduled_at` a l'hora local abans
> de mostrar-les als pacients o al personal.

## Disponibilitat

El camp `open_hours` anterior descriu l'horari d'obertura setmanal estàtic. Per mostrar franges reals que es puguin reservar —i evitar reserves duplicades amb cites d'Aniva existents— crida [Obtenir la disponibilitat](https://docs.anivahealth.com/ca/api/locations/get-availability.md) per a la ubicació i passa-li l'interval de dates que vols mostrar. Aquest endpoint és la font de referència per a qualsevol interfície de reserva: desplega `open_hours` sobre la graella de franges de la ubicació, aplica les excepcions per data, resta les cites ja reservades i aplica l'[antelació mínima](https://docs.anivahealth.com/ca/api/appointments/create-appointment.md#antelacio-minima).

## Preus de venda al públic

Una farmàcia fixa el seu propi preu per a cada panell, i per a cada biomarcador individual, que ven a clients
de pas. Només veus un preu quan la farmàcia el publica.
[Llistar els preus de venda al públic](https://docs.anivahealth.com/ca/api/locations/list-retail-prices.md) els retorna per a cada ubicació que pots
llegir, i [Obtenir els preus de venda al públic](https://docs.anivahealth.com/ca/api/locations/get-retail-prices.md) els retorna per a una ubicació. Tots dos
necessiten l'abast `retail_prices_view`; `locations_view` no els inclou. Demana tots dos abastos per a
les mateixes ubicacions.

Un [webhook](https://docs.anivahealth.com/ca/concepts/webhooks.md) `location.retail_prices.updated` t'avisa quan canvia un preu.
`location.created` i `location.deactivated` t'avisen quan apareix o desapareix una ubicació. Un canvi en
els panells que ofereix una ubicació et pot arribar més tard que un canvi de preu, així que torna a consultar Llistar els preus de venda al públic
un cop al dia.

## Exemple d'ubicació

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