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.location.* te avisa cuando aparece, cambia o desaparece una ubicación.
Campos
Estado o provincia (resuelto a partir del estado vinculado a la ciudad). Puede ser nulo cuando la
ciudad no tiene ningún estado vinculado.
Código ISO 3166-2 del estado sin el
prefijo de país (p. ej.,
BW para Baden-Württemberg). Puede ser nulo.Código de país de dos letras según ISO 3166-1 alpha-2
(p. ej.,
DE, US). Puede ser nulo.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.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.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).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.Disponibilidad
El campoopen_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 scoperetail_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.