Siirry pääsisältöön
API

Näyteastioiden nimet ajanvarauksen esikatselussa muuttuvat tuotenimiksi

Seuraavasta julkaisusta alkaen containers[].name ajanvarauksen esikatselussa on putken tuotenimi. type ei muutu, joten lue type, jos sovelluksesi vertailee näyteastioita.
HallintapaneeliAPI

Aniva toimii nyt kaikilla EU-kielillä ja muutamalla muullakin

API

Yksi List Panels -päätepiste

  • List Panels palauttaa nyt biomarker_groups-kentän. Käytä sitä polun /api/v2/panels sijaan.
  • Create Panel on poistettu. Käytä hallintapaneelia.
API

Näytä laboratoriotulokset sovelluksessasi

Potilaasi voivat nyt nähdä laboratoriotuloksensa sovelluksessasi: biomarkkerilistan, kunkin biomarkkerin trendin sekä 3D-Twinin, jossa on arvosana jokaiselle terveysalueelle. Sivu käyttää brändiväriäsi ja logoasi vaaleassa tai tummassa tilassa.Tulossivu on maksullinen lisäosa, ja yhteyshenkilösi Anivalla kertoo sinulle hinnan. Create Embed Session näyttää, miten otat sen käyttöön.
API

List-API-lukupyynnöt tallennetaan välimuistiin enintään 5 minuutiksi

Nämä neljä päätepistettä tallentavat nyt vastauksensa välimuistiin enintään 5 minuutiksi, joten muutoksen näkyminen voi kestää enintään 5 minuuttia:Get-päätepisteet näyttävät muutokset edelleen suoraan.Jos kyselet API:lta toistuvasti muutoksia, käytä sen sijaan webhookeja. Webhook ilmoittaa sinulle jokaisesta muutoksesta heti sen tapahtuessa. Katso Toistuvat lukupyynnöt.
Hallintapaneeli

Näe, milloin kuriiri noutaa näytteesi

Hallintapaneeli näyttää nyt seuraavan kuriirinoudon vastaanotoltasi sekä seurannan ja lähetystarran.Hallintapaneeli, jonka yläreunassa on banneri: GO! saapuu huomenna ~10.00–12.00.Hallintapaneeli, jonka yläreunassa on banneri: GO! saapuu huomenna ~10.00–12.00.
API

Anivan viitealueet ovat nyt saatavilla

Tuloksesi voivat nyt sisältää Anivan viitealueet: yleisen viitealueen ja kapeamman viitealueen kullekin biomarkkerille sekä Anivan kirjaamat lähteet. Viitealueet vaihtelevat iän, sukupuolen ja raskausviikon mukaan.Saat ne käyttöön allekirjoittamalla lyhyen sopimuksen Anivan viitealueista. Kytkemme ne sen jälkeen päälle API-avaimellesi. Pyydä sopimus yhteyshenkilöltäsi Anivalla.Viitealueet ovat uudessa aniva_range-kentässä. Se korvaa reference_range_aniva-kentän, joka oli aina null. Viitealueet ovat yleistä tietoa. Ne eivät arvioi tulosta, eivätkä ne ole lääketieteellistä neuvontaa tai lääkinnällinen laite. Laboratorion viitealue säilyy standardina. Katso Anivan viitealueet.
API

Fluoridiputki on nyt fluoride

Preview Containers käyttää fluoridiputkesta nimeä fluoride. Vanha arvo oli naf. Jos koodisi vertaa container.type-kenttää arvoon naf, vaihda se arvoon fluoride.Kaksi uutta arvoa voi esiintyä: lihep_capillary ja fluoride_capillary. Ne ovat kapillaarinen litiumhepariiniputki ja kapillaarinen fluoridiputki.
API

Ei enää viimeisen ajan tuplavarauksia

Jos kaksi varausta aikavälin viimeiselle paikalle saapuu samaan aikaan, vain toinen onnistuu. Toinen saa vastauksen 409, kuten minkä tahansa täyden aikavälin kohdalla. Sama pätee, kun ajanvarausta muutetaan samalla kun sitä perutaan tai vahvistetaan.Confirm Blood Draw-päätepisteessä on kolme uutta 409-syytä:
  • remapped: koodi viittaa nyt eri paneeleihin kuin aiemmin.
  • sent_to_lab ja order_in_flight: laboratoriolla voi jo olla tilaus, joten koodin on pysyttävä putkessaan.
APIKotitestipakkaukset

Tiukemmat toimitusosoitteet kotitestipakkausten tilauksissa

Create Home Kit ja Update Home Kit tarkistavat delivery_address-kentän tiukemmin.
  • country_code hyväksyy pienet kirjaimet, esim. de. Aniva tallentaa ja palauttaa sen isoilla kirjaimilla.
  • Saksalainen osoite (DE) vaatii tarkalleen 5-numeroisen postal_code-arvon. Muut arvot palauttavat koodin 400.
  • Välilyönnit postal_code-arvon ympäriltä poistetaan ennen tallennusta.
HallintapaneeliKotitestipakkauksetAPI

Uusi pakkaus meille palautuneen tilalle

Kun kuljetusliike palauttaa pakkauksen meille, emme enää odota laatikon saapumista. Kerro meille, että haluat pakkauksen uudelleen, niin lähetämme uuden pakkauksen heti. Voit myös luoda sen itse: kutsu Luo kotitestipakkaus -päätepistettä ja aseta replaces_home_kit_order_id-arvoksi palautunut pakkaus. Uusi pakkaus on erillinen tilaus, jolla on uusi pakkauskoodi.Tarkistamme palautuneen laatikon sen saapuessa. Silloin palautuneen pakkauksen tilaksi muuttuu cancelled, ja näet, mitä laatikossa oli.
TuloksetAPIHallintapaneeli

Sähköposti tiimillesi, kun tulokset ovat valmiit

Pyydä meitä asettamaan profiiliryhmällesi oletussähköpostiosoite, esimerkiksi tiimisi postilaatikko. Se saa silloin sähköpostin, kun uuden varauksen tulokset ovat valmiit. Tämä kattaa varaukset hallintapaneelista, API:sta ja potilailtasi.Näin muutat sen yhtä varausta varten:
  • Hallintapaneeli: muokkaa sähköpostiosoitteita tai poista käytöstä “Lähetä minulle sähköpostia, kun tulokset ovat valmiit”.
  • API: lähetä lista results_ready_emails-kentässä, niin käytetään kyseisiä sähköpostiosoitteita. Jos haluat säilyttää oletussähköpostiosoitteesi, sisällytä se listaan. Lähetä [], jos et halua sähköpostia.
Katso Tulokset valmiit -sähköpostit.
APIKotitestipakkaukset

Potilas syöttää syntymäajan ja sukupuolen

Voimme nyt sallia profiiliryhmäsi luoda profiilin ilman kenttiä date_of_birth ja sex. Potilas syöttää molemmat pakkauksen aktivointisivulla ja kirjoittaa syntymäajan kahdesti. Pyydä meitä ottamaan toiminto käyttöön. Katso Profiilit.
Hallintapaneeli

Nopeampi hallintapaneeli

Hallintapaneeli näyttää nyt ensimmäisen sisällön noin ajassa 0,2 s aiemman 1,3 s sijaan. Ei enää latauskuvakkeita. Sivut täyttyvät sitä mukaa, kun tiedot saapuvat. Sivut alkavat latautua, kun viet kursorin linkin päälle.
HallintapaneeliKotitestipakkauksetWebhookit

Meille palautuneet pakkaukset

Kun kuljetusliike palauttaa pakkauksen meille, se näkyy nyt Kotitestipakkaukset-sivulla. Suodata tilalla Palautunut nähdäksesi kaikki kuljetusliikkeen meille palauttamat pakkaukset sekä kuljetusliikkeen syyn. Lähetys päättyy tilaan fault ja laukaisee tapahtuman shipment.fault, ei enää tilaa delivered. Kun avaamme laatikon, näet myös, mitä siinä oli: täydellinen, osa puuttuu tai avattu. Sen perusteella tiedät, saako asiakkaasi täyden hyvityksen.Haluatko, että lähetämme pakkauksen uudelleen? Laita meille viesti, jossa on pakkauskoodi ja oikea toimitusosoite. Lähetämme sen samalla pakkauskoodilla.
API

Logaritmiset yksiköt

Listaa yksiköt palauttaa kolmannen unit_type-arvon: logarithmic arvolle, joka on suureen logaritmi, kuten pH tai aterogeeninen indeksi. Käsittele sitä kuten arvoa physical, kun näytät sen. Älä skaalaa sitä: kaksi logaritmista yksikköä eroavat toisistaan siirtymällä, eivät kertoimella.
APIHinnoittelu

Kotitestipakkauksen hinta-arvio maksuineen

Laske ostoskorin hinta-arvio hyväksyy kentän fulfilment. Lähetä home_kit ja country_code, niin laskelmaan lisätään pakkausrivit, jotka kuukausilaskusi veloittaa yhdestä tilauksesta: pakkausmaksu, näytteenottovälineet, postikulut kyseiseen maahan ja takaisin, suojakuori sekä varalansettipussi. Oletuksena pysyy draw toimipisteessä ajanvarausmaksuineen. Vastaus kertoo hinnoitellun vaihtoehdon kentässä fulfilment.kind.
Concierge

Tässä on Aniva Concierge

Tästä lähtien muutoslokimme näkyy myös yhteisellä Slack-kanavallamme heti, kun julkaisemme jotain.Rakensimme myös Aniva Conciergen. Onko sinulla kysyttävää API:sta tai hallintapaneelista? Mainitse @Aniva Slackissa tai vastaa muutoslokijulkaisun alle. Se tarkistaa dokumentaatiomme ja kertoo, mistä klikkaat hallintapaneelissa tai mitä päätepistettä ja suodattimia käytät, ja antaa linkin sivulle.
APIAjanvaraukset

Listaa yhden päivän ajanvaraukset

Listaa ajanvaraukset hyväksyy kaksi uutta suodatinta. date (YYYY-MM-DD) palauttaa yhden kalenteripäivän kunkin ajanvarauksen toimipisteen aikavyöhykkeessä, aikaisin ensin. location_id palauttaa yhden testitoimipisteen. Käytä molempia nähdäksesi toimipisteen tämän päivän aikataulun.
APIProfiilit

Päällekkäiset profiilit hylätään

Luo profiili palauttaa nyt koodin 409 ja virheen error_name: "duplicate_profile_error", kun avaimesi näkemällä profiililla on sama etunimi, sukunimi, sukupuoli ja syntymäaika. Vastaus kertoo olemassa olevan profile_id-tunnisteen. Käytä sitä toisen profiilin luomisen sijaan. Sandbox-sukunimet ovat poikkeus.
Toimipisteet

Aniva Berlin Mitte sulkeutuu

Aniva Berlin Mitte (206e8e2e-1ae6-401b-9dfe-781d639210ed) ei enää tarjoa ajanvarauksia 1. marraskuuta 2026 alkaen. Lähin toimipiste on Aniva Berlin P-Berg | Mariposa (f7897229-5c37-409b-bb43-dc8b50687fbc), Kastanienallee 83, 10435 Berlin.
HallintapaneeliHinnoittelu

Testiluettelo omilla hinnoillasi

Hallintapaneelin uusi Testiluettelo listaa jokaisen biomarkkerin laboratorioineen, näyteputkineen ja hinnastosi mukaisine hintoineen.
APITulokset

Miksi tuloksella ei ole laboratorion viitealuetta

Jokaisessa kliinisessä tuloksessa päätepisteissä Hae tulokset ja kotitestipakkausten Hae laboratoriotulokset on nyt kenttä reference_range_lab_absent_reason. Se kertoo, miksi reference_range_lab on null:
  • not_provided: viitealuetta ei ole. Näytä “Ei sovellettavissa”.
  • lab_text_only: laboratorio tulosti vain tekstiä, kuten tavoitteen tai riskitason. Näytä lab_reported.reference_range.
  • not_measured: tulos on undeliverable.
Se on null, kun viitealue on olemassa. Katso Tulokset.
APIToimipisteet

Vähittäishinnat ja koordinaatit

  • Toimipisteillä on nyt state_code, latitude ja longitude.
  • Listaa vähittäishinnat ja Hae vähittäishinnat palauttavat kunkin paneelin hinnan, jolla apteekki myy sen ilman ajanvarausta saapuville asiakkaille.
  • location.retail_prices.updated-webhook kertoo, kun hinta muuttuu.
Vähittäishintojen päätepisteet ja tapahtuma vaativat retail_prices_view-käyttöoikeuden.
KotitestipakkauksetHallintapaneeli

Tilaa kotitestipakkauksia hallintapaneelissa

Voit nyt tilata kotitestipakkauksen potilaallesi hallintapaneelin Kotitestipakkaukset-sivulla. Valitse tai luo potilas, valitse pakkaus ja syötä toimitusosoite. Voit myös peruuttaa pakkauksen siellä.
APIHinnoittelu

Hinnasto ja hinta-arviot

  • Hae hinnasto palauttaa hintasi Aniva-luettelossa ja maksusi.
  • Hinnoittele ostoskori hinnoittelee paneelit ja biomarkkerit ilman ajanvarausta.
  • Hinnoittele ostoskori- ja Esikatsele ajanvaraus -päätepisteiden laskussa on nyt fees, total_with_fees_cents ja name jokaisella biomarkkeririvillä.
  • Listausten rate_card ottaa id-arvon Hae hinnasto -päätepisteestä.
Molemmat uudet päätepisteet vaativat prices_view-käyttöoikeuden.
APITulokset

Lisää asiakirjatietoja

Jokaisessa Hae tulokset -päätepisteen documents-kentän kohteessa on nyt:
  • file_name: nimi, jota Lataa asiakirja käyttää.
  • Uudet: original_file_name, origin, content_type, etag, size_bytes.
Korvattu PDF-raportti lähettää nyt results.updated-tapahtuman, esimerkiksi Labor Quaden lopullinen raportti (_E) alustavan (_V) jälkeen.
APIWebhookit

Webhookit

Aniva kutsuu nyt palvelintasi, kun ajanvaraus, kotitestipakkaustilaus, sen tulokset, toimipiste, profiili tai lähetys muuttuu. Sinun ei enää tarvitse tehdä säännöllisiä kyselyjä.
  • Rekisteröi HTTPS-URL päätepisteellä Luo webhook. Tarvitset webhooks_manage-käyttöoikeuden. Pyydä Anivaa lisäämään se avaimellesi tai määrittämään webhook puolestasi.
  • Tapahtumat kattavat ajanvarauksen ja kotitestipakkaustilauksen jokaisen tilan, uuden ajan tai toimipisteen sekä jokaisen tulosten muutoksen. results.completed kertoo, että tulokset ovat lopulliset.
  • location.*-, profile.*- ja shipment.*-tapahtumat kertovat, kun toimipiste, profiili tai lähetys lisätään, muuttuu tai poistuu. Lähetys lähettää myös shipment.<status>-tapahtuman jokaisen tilamuutoksen yhteydessä.
  • Tapahtumat sisältävät tunnisteet ja tilat, eivät koskaan laboratorioarvoja tai henkilötietoja. Hae tiedot tapahtuman url-osoitteesta.
  • Jokainen pyyntö allekirjoitetaan Standard Webhooks -menetelmällä.
  • Aniva yrittää epäonnistunutta toimitusta uudelleen 10 kertaa noin kolmen päivän aikana. Voit listata ja lähettää toimituksia uudelleen 30 päivän ajan.
  • Jokaisella Hae tulokset -päätepisteen tuloksella on nyt id, jotta voit päivittää tuloksen, johon results.updated-tapahtuma viittaa.
  • Hae toimipiste palauttaa yhden toimipisteen sen id-arvolla. location.*-tapahtuman url osoittaa siihen.
Katso Webhookit.
TuloksetHallintapaneeli

Lähetä tulokset asiakkaalle sähköpostilla

Voit nyt ilmoittaa asiakkaalle sähköpostilla, että hänen laboratoriotuloksensa ovat valmiit. Lähetä viesti hallintapaneelin Laboratoriotulokset-sivulta tai kahden uuden päätepisteen kautta: Lähetä tulokset sähköpostilla ajanvarauksille ja Lähetä tulokset sähköpostilla kotitestipakkaustilauksille.
  • Sähköpostiin voi liittää laboratorioraportit PDF-tiedostoina. Jokainen PDF on salasanasuojattu: salasana on asiakkaan syntymäaika 8 numerona (DDMMYYYY), ja siitä kerrotaan sähköpostissa.
  • Voit lisätä enintään 1 000 merkin henkilökohtaisen viestin.
  • Siinä näkyvät profiilin ensisijaisen profiiliryhmän nimi ja logo profiilin kielellä.
  • Jokainen lähetys on yksi sähköposti. Uusi yritys lähettää toisen. Tarvitset kyseiselle asiakkaalle results_view-käyttöoikeuden.

Sähköposti-ilmoitus, kun tulokset ovat valmiit

Kun teet ajanvarauksen tai tilaat korvaavan kotitestipakkauksen hallintapaneelissa, voit ottaa käyttöön asetuksen “Lähetä minulle sähköposti, kun tulokset ovat valmiit”. Lähetämme silloin yhden sähköpostin sinulle tai mihin tahansa syöttämääsi osoitteeseen, kun kaikki laboratoriotulokset ovat saapuneet. Sähköpostissa on linkki tulokseen hallintapaneelissa. Asiakas ei saa tätä sähköpostia. Tarvitset results_view-käyttöoikeuden kyseiselle asiakkaalle.API:n kautta voit asettaa enintään 5 osoitetta results_ready_emails-kenttään päätepisteissä Luo ajanvaraus, Luo kotitestipakkaustilaus, Päivitä ajanvaraus ja Päivitä kotitestipakkaustilaus.
Kotitestipakkaukset

Lähetä vastaanottajan puhelinnumero ja sähköposti jokaisen pakkauksen mukana

Jos kotitestipakkauksen delivery_address-kentässä on phone tai email, välitämme ne kuljetusyhtiölle. Kuljetusyhtiö ilmoittaa tällöin vastaanottajalle, kun paketti on matkalla tai odottaa noutopisteessä. Jos jätät ne pois, kuljetusyhtiö ei saa yhteystietoja, vaikka ne olisivat profiilissa. Sinä päätät, kuka saa kuljetusyhtiön ilmoitukset. Ilmoituksessa lähettäjänä voi näkyä Aniva Health.Katso Luo kotitestipakkaustilaus.
Toimipisteet

Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim ja Wiesbaden

Neljä uutta toimipistettä laskimoverinäytteenottoon. Katso Listaa toimipisteet.
Hallintapaneeli

Laboratoriotulokset-sivu

Hallintapaneelin uusi Laboratoriotulokset-sivu listaa jokaisen verinäytteenoton ja aktivoidun kotitestipakkauksen laboratorioraportteineen. Hae nimellä, syntymäpäivällä tai putken viivakoodilla. Tarvitset results_view-käyttöoikeuden sekä kotitestipakkausluvan nähdäksesi pakkaukset.
Kotitestipakkaukset

Vain aktivointiin tarkoitetut API-avaimet

Uudella home_kit_orders_activate-käyttöoikeudella avain voi vain aktivoida kotitestipakkauksia, ei mitään muuta. Sillä ei voi luoda, muuttaa tai peruuttaa pakkausta. Pyydä Anivalta tällainen avain, jos erillinen järjestelmä aktivoi pakkauksesi.Katso Aktivoi kotitestipakkaustilaus.
APIRikkova muutos

Sukupuolen on oltava mies tai nainen

Luo profiili- ja Päivitä profiili -päätepisteet eivät enää hyväksy arvoa sex: 0 (tuntematon). Lähetä 1 miehelle tai 2 naiselle; 0 palauttaa koodin 400. Laboratorio tarvitsee sukupuolen viitealueita varten, eikä profiilin tilaus päässyt ilman sitä laboratorioon.Katso Luo profiili.
Kotitestipakkaukset

Pakkaukset, jotka saapuvat laboratorioon ilman aktivointia

Jos näyte saapuu laboratorioon ennen kuin sen pakkaus on aktivoitu, Aniva aktivoi pakkauksen. activated_at on palautuspaketin ensimmäisen seurantatapahtuman aamu tai aamu, jona näyte saapui laboratorioon, jos seurantaa ei ole. Myöhempi aktivointikutsu eri activated_at-arvolla palauttaa koodin 409.Katso Aktivoi kotitestipakkaustilaus.
API

Anivan viitealueet tuloksissa

Tulospäätepisteet täyttävät nyt reference_range_aniva-kentän Anivan kokoamilla vertailuarvoilla, jotka on muunnettu tuloksen yksikköön. Arvot vaihtelevat iän, sukupuolen ja raskausviikon mukaan. Avaimesi tarvitsee ANIVA_REFERENCE_RANGES_VIEW-käyttöoikeuden. Ilman sitä kenttä on null.Katso Hae ajanvarauksen tulokset.
APIKotitestipakkaukset

Korvaavat pakkaukset

Tilaa korvaava pakkaus, kun pakkauksesta ei saatu kaikkia tuloksia. Korvaava pakkaus on uusi tilaus, jossa on uusi laboratoriokoodi, ja se säilyttää alkuperäisen tilauksen paneelin. biomarker_ids määrittää, mitkä laboratorio analysoi uudelleen.Katso Kotitestipakkaustilaukset.
APIHinnoitteluRikkova muutos

Yksi hinta biomarkkeria ja paneelia kohden

Biomarkkereilla ja paneeleilla on yksi hinnastosi mukainen price_cents-hinta ja sen rinnalla retail_cents:
  • > 0: tilattavissa sellaisenaan.
  • 0: suhdeluku (katso requires) tai tilattavissa vain muiden markkereiden kanssa (katso positions).
  • null: ei hinnoiteltu, joten ei tilattavissa.
Rikkova muutos: groups[] poistetaan listauksista ja ajanvarauksen esikatselusta. Hintakentät retail ja yours poistetaan.Katso Hinnoittelu.
API

Idempotenssiavaimet

Profiilien, ajanvarausten, kotitestipakkausten tilausten ja lähetysten luontipäätepisteet hyväksyvät Idempotency-Key-otsikon. Uudelleenyritys samalla avaimella palauttaa ensimmäisen vastauksen eikä kirjoita mitään.Katso Idempotenssi.
Toimipisteet

Aniva Hannover, Düsseldorf, Duisburg ja Essen

Neljä uutta Aniva-toimipistettä Saksassa on avattu laskimoverinäytteenottoja varten: Hannover, Düsseldorf, Duisburg ja Essen. Kutsu Listaa toimipisteet nähdäksesi, mihin toimipisteisiin avaimesi voi varata aikoja.