Saltar al contenido principal
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.
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 location.* te avisa cuando aparece, cambia o desaparece una ubicación.

Campos

string
requerido
UUID de la ubicación. Pásalo como location_id al crear una cita.
string
requerido
Nombre visible de la ubicación.
string
Clínica o empresa que gestiona la ubicación. Puede ser nulo.
string
Nombre de la calle, sin el número. Puede ser nulo.
string
Número de la calle. Puede ser nulo.
string
Línea adicional de dirección — c/o, edificio o planta. Puede ser nulo.
string
Ciudad. Puede ser nulo.
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.
string
Código ISO 3166-2 del estado sin el prefijo de país (p. ej., BW para Baden-Württemberg). Puede ser nulo.
string
Código postal o ZIP. Puede ser nulo.
string
Nombre completo del país (p. ej., Germany). Puede ser nulo.
string
Código de país de dos letras según ISO 3166-1 alpha-2 (p. ej., DE, US). Puede ser nulo.
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.
number
Latitud de la dirección en grados decimales (WGS 84). Puede ser nulo.
number
Longitud de la dirección en grados decimales (WGS 84). Puede ser nulo.
string
Número de teléfono de la ubicación. Puede ser nulo.
string
Dirección de correo electrónico de la ubicación. Puede ser nulo.
string
URL del sitio web de la ubicación. Puede ser nulo.
string
Enlace directo a la ubicación en Google Maps. Puede ser nulo.
string
URL de una foto de la ubicación. Puede ser nulo.
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.
string
requerido
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).
string[]
requerido
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.
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 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.

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 los devuelve para todas las ubicaciones que puedes leer, y Obtener precios de venta al público 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 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