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

# Ubicaciones

> Cómo funcionan las ubicaciones de análisis en la API de Aniva: farmacias y consultas que hacen extracciones de sangre, horarios de apertura, disponibilidad y precios al público.

Una ubicación es un centro físico de análisis donde profesionales sanitarios realizan extracciones de sangre. Usas el `id` de una ubicación para programar citas `practitioner`.

> [!NOTE]
>
> Tu API key solo devuelve ubicaciones dentro de tu contexto de acceso de partner. Usa `GET
>     /api/v1/locations` para listar todas las ubicaciones disponibles para ti.

Un [webhook](https://docs.anivahealth.com/es/concepts/webhooks.md) `location.*` te avisa cuando aparece, cambia o desaparece una ubicación.

## Campos

**id** `string` *required*

UUID de la ubicación. Pásalo como `location_id` al crear una cita.

**name** `string` *required*

Nombre visible de la ubicación.

**company\_name** `string`

Clínica o empresa que gestiona la ubicación. Puede ser nulo.

**street** `string`

Nombre de la calle, sin el número. Puede ser nulo.

**house\_number** `string`

Número de la calle. Puede ser nulo.

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

Línea adicional de dirección — c/o, edificio o planta. Puede ser nulo.

**city** `string`

Ciudad. Puede ser nulo.

**state** `string`

Estado o provincia (resuelto a partir del estado vinculado a la ciudad). Puede ser nulo cuando la
ciudad no tiene ningún estado vinculado.

**state\_code** `string`

Código [ISO 3166-2](https://www.iso.org/iso-3166-country-codes.html) del estado sin el
prefijo de país (p. ej., `BW` para Baden-Württemberg). Puede ser nulo.

**postal\_code** `string`

Código postal o ZIP. Puede ser nulo.

**country\_name** `string`

Nombre completo del país (p. ej., `Germany`). Puede ser nulo.

**country\_code** `string`

Código de país de dos letras según [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html)
(p. ej., `DE`, `US`). Puede ser nulo.

**timezone** `string`

Identificador de zona horaria IANA de la ubicación (p. ej., `Europe/Berlin`, `America/New_York`). Úsalo para
mostrar las horas programadas en la hora local correcta. Puede ser nulo.

**latitude** `number`

Latitud de la dirección en grados decimales (WGS 84). Puede ser nulo.

**longitude** `number`

Longitud de la dirección en grados decimales (WGS 84). Puede ser nulo.

**contact\_phone** `string`

Número de teléfono de la ubicación. Puede ser nulo.

**email** `string`

Dirección de correo electrónico de la ubicación. Puede ser nulo.

**website** `string`

URL del sitio web de la ubicación. Puede ser nulo.

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

Enlace directo a la ubicación en Google Maps. Puede ser nulo.

**image\_url** `string`

URL de una foto de la ubicación. Puede ser nulo.

**open\_hours** `object`

Horario semanal de apertura de la ubicación. Cada clave de día de la semana (`monday`–`sunday`) corresponde a un array de
franjas `{ open, close }` en formato `HH:MM` (24 h). Un array vacío indica que la ubicación está cerrada
ese día. Puede ser nulo si no hay horario disponible para la ubicación.

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

Cómo se realiza la extracción de sangre en una cita aquí, salvo que la cita defina su propio
`draw_method`: `capillary` (de la yema del dedo o la parte superior del brazo, en microtubos) o
`venous` (de la vena, en tubos).

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

Los métodos de extracción para los que el centro dispone de recipientes, ordenados. Una cita aquí
solo puede definir uno de ellos como su `draw_method`.

> [!TIP]
>
> Usa siempre el campo `timezone` para convertir las fechas y horas de `scheduled_at` a hora local antes de
> mostrárselas a los pacientes o al personal.

## Disponibilidad

El campo `open_hours` anterior describe el horario semanal de apertura estático. Para mostrar franjas reservables reales —y evitar reservas duplicadas con citas de Aniva ya existentes—, llama a [Obtener disponibilidad](https://docs.anivahealth.com/es/api/locations/get-availability.md) para la ubicación y pásale el rango de fechas que quieras mostrar. Ese endpoint es la fuente de verdad adecuada para cualquier interfaz de reservas: despliega `open_hours` en la cuadrícula de franjas de la ubicación, aplica las excepciones por fecha, resta las citas ya reservadas y aplica la [antelación mínima](https://docs.anivahealth.com/es/api/appointments/create-appointment.md#antelacion-minima).

## Precios de venta al público

Una farmacia fija su propio precio para cada panel y cada biomarcador individual que vende a clientes
sin cita. Solo ves un precio cuando la farmacia lo publica.
[Listar precios de venta al público](https://docs.anivahealth.com/es/api/locations/list-retail-prices.md) los devuelve para todas las ubicaciones que puedes
leer, y [Obtener precios de venta al público](https://docs.anivahealth.com/es/api/locations/get-retail-prices.md) los devuelve para una ubicación. Ambos
necesitan el scope `retail_prices_view`; `locations_view` no los incluye. Solicita ambos scopes para
las mismas ubicaciones.

Un [webhook](https://docs.anivahealth.com/es/concepts/webhooks.md) `location.retail_prices.updated` te avisa cuando cambia un precio.
`location.created` y `location.deactivated` te avisan cuando aparece o desaparece una ubicación. Un cambio en
los paneles que ofrece una ubicación puede llegarte más tarde que un cambio de precio, así que vuelve a consultar Listar precios de venta al público
una vez al día.

## Ubicación de ejemplo

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