Przejdź do głównej treści
Lokalizacja to fizyczny punkt badań, w którym personel medyczny wykonuje pobrania krwi. Do umawiania wizyt practitioner używasz id lokalizacji.
Twój klucz API zwraca tylko lokalizacje w ramach twojego partnerskiego kontekstu dostępu. Użyj GET /api/v1/locations, aby wyświetlić listę wszystkich dostępnych dla ciebie lokalizacji.
Webhook location.* informuje cię, gdy lokalizacja się pojawia, zmienia lub znika.

Pola

string
wymagane
UUID lokalizacji. Przekaż tę wartość jako location_id podczas tworzenia wizyty.
string
wymagane
Wyświetlana nazwa lokalizacji.
string
Klinika lub firma prowadząca lokalizację. Może mieć wartość null.
string
Nazwa ulicy, bez numeru domu. Może mieć wartość null.
string
Numer domu. Może mieć wartość null.
string
Dodatkowa linia adresu — c/o, budynek lub piętro. Może mieć wartość null.
string
Miasto. Może mieć wartość null.
string
Stan lub województwo (ustalane na podstawie regionu powiązanego z miastem). Może mieć wartość null, gdy miasto nie ma powiązanego regionu.
string
Kod ISO 3166-2 stanu lub kraju związkowego bez prefiksu kraju (np. BW dla Baden-Württemberg). Może mieć wartość null.
string
Kod pocztowy lub kod ZIP. Może mieć wartość null.
string
Pełna nazwa kraju (np. Germany). Może mieć wartość null.
string
Dwuliterowy kod kraju według ISO 3166-1 alpha-2 (np. DE, US). Może mieć wartość null.
string
Identyfikator strefy czasowej IANA dla lokalizacji (np. Europe/Berlin, America/New_York). Użyj go, aby wyświetlać zaplanowane godziny we właściwym czasie lokalnym. Może mieć wartość null.
number
Szerokość geograficzna adresu w stopniach dziesiętnych (WGS 84). Może mieć wartość null.
number
Długość geograficzna adresu w stopniach dziesiętnych (WGS 84). Może mieć wartość null.
string
Numer telefonu lokalizacji. Może mieć wartość null.
string
Adres e-mail lokalizacji. Może mieć wartość null.
string
Adres URL strony internetowej lokalizacji. Może mieć wartość null.
string
Bezpośredni link do lokalizacji w Google Maps. Może mieć wartość null.
string
Adres URL zdjęcia lokalizacji. Może mieć wartość null.
object
Tygodniowe godziny otwarcia lokalizacji. Każdy klucz dnia tygodnia (monday–sunday) wskazuje na tablicę przedziałów czasowych { open, close } w formacie HH:MM (24h). Pusta tablica oznacza, że lokalizacja jest tego dnia zamknięta. Może mieć wartość null, jeśli godziny otwarcia lokalizacji są niedostępne.
string
wymagane
Sposób pobierania krwi podczas wizyty w tej lokalizacji, chyba że wizyta ustawia własne draw_method: capillary (z opuszki palca lub ramienia, do mikroprobówek) lub venous (z żyły, do probówek).
string[]
wymagane
Posortowane metody pobrania krwi, do których lokalizacja ma na stanie pojemniki. Wizyta w tej lokalizacji może ustawić tylko jedną z nich jako swoje draw_method.
Zawsze używaj pola timezone, aby przeliczać znaczniki czasu scheduled_at na czas lokalny przed wyświetleniem ich pacjentom lub personelowi.

Dostępność

Pole open_hours powyżej opisuje stały tygodniowy harmonogram otwarcia. Aby wyświetlić rzeczywiste terminy do rezerwacji — i uniknąć podwójnych rezerwacji z istniejącymi wizytami Aniva — wywołaj Get Availability dla danej lokalizacji i przekaż przedział dat, który chcesz wyświetlić. Ten endpoint jest właściwym źródłem danych dla każdego interfejsu rezerwacji: przekłada open_hours na siatkę terminów lokalizacji, uwzględnia wyjątki dla poszczególnych dat, odejmuje już zarezerwowane wizyty i stosuje minimalne wyprzedzenie.

Ceny detaliczne

Apteka ustala własną cenę dla każdego panelu i pojedynczego biomarkera, które sprzedaje klientom na miejscu. Cenę zobaczysz dopiero po jej opublikowaniu przez aptekę. List Retail Prices zwraca je dla każdej lokalizacji, do której masz dostęp do odczytu, a Get Retail Prices zwraca je dla jednej lokalizacji. Oba wymagają zakresu retail_prices_view; zakres locations_view ich nie obejmuje. Poproś o oba zakresy dla tych samych lokalizacji. Webhook location.retail_prices.updated informuje o zmianie ceny. location.created i location.deactivated informują o pojawieniu się lub zniknięciu lokalizacji. Zmiana paneli oferowanych przez lokalizację może dotrzeć do ciebie później niż zmiana ceny, więc odczytuj List Retail Prices ponownie raz dziennie.

Przykładowa lokalizacja