Siirry pääsisältöön
Toimipiste on fyysinen testauskeskus, jossa terveydenhuollon ammattilaiset tekevät verinäytteenottoja. Käytät toimipisteen id-tunnusta practitioner-ajanvarausten tekemiseen.
API-avaimesi palauttaa vain kumppanisi käyttöoikeuksiin kuuluvat toimipisteet. Listaa kaikki käytettävissäsi olevat toimipisteet kutsulla GET /api/v1/locations.
location.*-webhook ilmoittaa, kun toimipiste lisätään, muuttuu tai poistuu.

Kentät

string
vaadittu
Toimipisteen UUID. Välitä tämä location_id-kentässä ajanvarausta luodessasi.
string
vaadittu
Toimipisteen näyttönimi.
string
Toimipistettä ylläpitävä klinikka tai yritys. Voi olla null.
string
Kadunnimi ilman talonnumeroa. Voi olla null.
string
Talonnumero. Voi olla null.
string
Lisäosoiterivi — c/o, rakennus tai kerros. Voi olla null.
string
Kaupunki. Voi olla null.
string
Osavaltio tai maakunta (selvitetään kaupunkiin liitetyn osavaltion perusteella). Voi olla null, kun kaupunkiin ei ole liitetty osavaltiota.
string
Osavaltion ISO 3166-2-koodi ilman maaetuliitettä (esim. BW Baden-Württembergille). Voi olla null.
string
Postinumero. Voi olla null.
string
Maan koko nimi (esim. Germany). Voi olla null.
string
Kaksikirjaiminen maakoodi ISO 3166-1 alpha-2-standardin mukaan (esim. DE, US). Voi olla null.
string
Toimipisteen IANA-aikavyöhyketunniste (esim. Europe/Berlin, America/New_York). Käytä tätä varattujen aikojen näyttämiseen oikeassa paikallisajassa. Voi olla null.
number
Osoitteen leveysaste desimaaliasteina (WGS 84). Voi olla null.
number
Osoitteen pituusaste desimaaliasteina (WGS 84). Voi olla null.
string
Toimipisteen puhelinnumero. Voi olla null.
string
Toimipisteen sähköpostiosoite. Voi olla null.
string
Toimipisteen verkkosivuston URL-osoite. Voi olla null.
string
Suora linkki toimipisteeseen Google Mapsissa. Voi olla null.
string
Toimipisteen valokuvan URL-osoite. Voi olla null.
object
Toimipisteen viikoittaiset aukioloajat. Jokainen viikonpäiväavain (monday–sunday) sisältää taulukon { open, close }-aikavälejä HH:MM-muodossa (24 h). Tyhjä taulukko tarkoittaa, että toimipiste on suljettu kyseisenä päivänä. Voi olla null, jos toimipisteen aukioloaikoja ei ole saatavilla.
string
vaadittu
Miten verinäyte otetaan tämän toimipisteen ajanvarauksessa, ellei ajanvarauksessa ole asetettu omaa draw_method-arvoa: capillary (sormenpäästä tai olkavarresta mikroputkiin) tai venous (laskimosta näyteputkiin).
string[]
vaadittu
Verinäytteenottotavat, joihin toimipisteellä on näyteastioita varastossa, järjestettynä. Tämän toimipisteen ajanvarauksessa voi asettaa draw_method-arvoksi vain jonkin näistä.
Käytä aina timezone-kenttää scheduled_at-aikaleimojen muuntamiseen paikallisaikaan ennen kuin näytät ne potilaille tai henkilökunnalle.

Saatavuus

Yllä oleva open_hours-kenttä kuvaa staattista viikoittaista aukioloaikataulua. Jotta voit näyttää todelliset varattavat ajat – ja välttää päällekkäiset varaukset olemassa olevien Aniva-ajanvarausten kanssa – kutsu toimipisteelle päätepistettä Get Availability ja välitä sille näytettävä päivämääräväli. Kyseinen päätepiste on oikea tietolähde mille tahansa varauskäyttöliittymälle: se purkaa open_hours-kentän toimipisteen aikaruudukkoon, huomioi päiväkohtaiset poikkeukset, vähentää jo varatut ajanvaraukset ja soveltaa vähimmäisennakkoaikaa.

Vähittäishinnat

Apteekki määrittää itse hinnan jokaiselle paneelille ja yksittäiselle biomarkkerille, jota se myy ilman ajanvarausta tuleville asiakkaille. Näet hinnan vasta, kun apteekki on julkaissut sen. List Retail Prices palauttaa hinnat jokaiselta toimipisteeltä, johon sinulla on lukuoikeus, ja Get Retail Prices palauttaa ne yhdeltä toimipisteeltä. Molemmat vaativat retail_prices_view-käyttöoikeuden; locations_view ei sisällä niitä. Pyydä molemmat käyttöoikeudet samoille toimipisteille. location.retail_prices.updated-webhook kertoo, kun hinta muuttuu. location.created ja location.deactivated kertovat, kun toimipiste lisätään tai poistuu käytöstä. Muutos siihen, mitä paneeleja toimipiste tarjoaa, voi saapua myöhemmin kuin hinnanmuutos, joten lue List Retail Prices uudelleen kerran päivässä.

Esimerkkitoimipiste