id de um local para agendar marcações practitioner.
A tua chave API só devolve locais dentro do teu contexto de acesso de parceiro. Usa
GET /api/v1/locations para listar todos os locais disponíveis para ti.location.* avisa-te quando um local aparece, muda ou desaparece.
Campos
Estado ou província (resolvido através do estado associado à cidade). Pode ser null quando a
cidade não tem estado associado.
Código ISO 3166-2 do estado sem o
prefixo do país (por ex.,
BW para Baden-Württemberg). Pode ser nulo.Código de país de duas letras segundo ISO 3166-1 alpha-2
(por ex.,
DE, US). Pode ser nulo.Identificador de fuso horário IANA do local (por ex.,
Europe/Berlin, America/New_York). Usa-o para
mostrar os horários marcados na hora local correta. Pode ser nulo.Horário de funcionamento semanal do local. Cada chave de dia da semana (
monday–sunday) corresponde a um array de
intervalos horários { open, close } no formato HH:MM (24h). Um array vazio significa que o local está fechado
nesse dia. Pode ser nulo se o horário não estiver disponível para o local.Como o sangue é colhido numa marcação neste local, a menos que a marcação defina o seu próprio
draw_method: capillary (ponta do dedo ou parte superior do braço, para microtubos) ou
venous (da veia, para tubos).Os métodos de colheita para os quais o local tem recipientes em stock, ordenados. Uma marcação
neste local só pode definir um destes como o seu
draw_method.Disponibilidade
O campoopen_hours acima descreve o horário de funcionamento semanal estático. Para mostrar horários reais disponíveis para marcação — e evitar marcações duplicadas com marcações Aniva já existentes — chama Obter disponibilidade para o local e passa o intervalo de datas que queres mostrar. Esse endpoint é a fonte de verdade certa para qualquer interface de marcação: expande open_hours na grelha de horários do local, aplica exceções por data, subtrai as marcações já feitas e aplica a antecedência mínima.
Preços de retalho
Uma farmácia define o seu próprio preço para cada painel, e para cada biomarcador individual, que vende a clientes sem marcação. Só vês um preço depois de a farmácia o publicar. Listar preços de retalho devolve-os para cada local que podes ler, e Obter preços de retalho devolve-os para um local. Ambos precisam do scoperetail_prices_view; locations_view não os inclui. Pede ambos os scopes para
os mesmos locais.
Um webhook location.retail_prices.updated avisa-te quando um preço muda.
location.created e location.deactivated avisam-te quando um local aparece ou desaparece. Uma alteração aos
painéis que um local oferece pode chegar-te mais tarde do que uma alteração de preço, por isso lê Listar preços de retalho
novamente uma vez por dia.