> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Partner API:n muutosloki

> Uudet ominaisuudet, yhteensopivuuden rikkovat muutokset ja uudet verinäytteenottopaikat Aniva Partner API:ssa laboratoriotestejä, kotitestipakkauksia ja tuloksia varten.

**22. marraskuuta 2026**

## Näyteastioiden nimet ajanvarauksen esikatselussa muuttuvat tuotenimiksi

Seuraavasta julkaisusta alkaen `containers[].name` [ajanvarauksen esikatselussa](https://docs.anivahealth.com/fi/api/appointments/preview-containers.md)
on putken tuotenimi. `type` ei muutu, joten lue `type`, jos sovelluksesi vertailee näyteastioita.

| `type` | `name` nyt | `name` julkaisun jälkeen |
| - | - | - |
| `edta` | EDTA | Sarstedt S-Monovette K3E, 3.4 ml |
| `edta_capillary` | Capillary EDTA | BD Microtainer K2EDTA, lavender cap |
| `fluoride` | Fluoride | Sarstedt S-Monovette Fluoride/EDTA, 2.7 ml |
| `fluoride_capillary` | Capillary Fluoride | BD Microtainer FE, grey cap |
| `glucoexact` | GlucoEXACT | Sarstedt S-Monovette GlucoEXACT, 3.1 ml |
| `lihep` | LiHep | Sarstedt S-Monovette LH, 7.5 ml |
| `lihep_capillary` | Capillary LiHep | BD Microtainer LH, green cap |
| `serum` | Serum | Sarstedt S-Monovette Z-Gel, 7.5 ml |
| `serum_capillary` | Capillary Serum | BD Microtainer SST, gold cap |
| `serum_capillary_plain` | Capillary Serum (no gel) | BD Microtainer Z, red cap |
| `urine` | Urine | Disera VACUSERA Z urine tube, 10 ml |

**22. marraskuuta 2026**

## Aniva toimii nyt kaikilla EU-kielillä ja muutamalla muullakin

<video autoPlay muted loop playsInline src="https://mintcdn.com/anivahealth/MordyVwYr6Rg_ffP/images/changelog/languages-light.mp4?fit=max&auto=format&n=MordyVwYr6Rg_ffP&q=85&s=06e1d908a872e8704bf83dd8b6dd6269" poster="/images/changelog/languages-light.png" aria-label="32 lipun kehä pyörii hitaasti puhelimen ympärillä. Kun kukin lippu saavuttaa huipun, puhelimen sivu vaihtuu kyseiselle kielelle englannista ukrainaan." />

* **[Hallintapaneeli](https://anivahealth.com/admin), [verkkosivusto](https://anivahealth.com), [ohjekeskus](https://help.anivahealth.com) ja [dokumentaatio](https://docs.anivahealth.com/fi.md):** kaikilla 32 kielellä.
* **[Profiilit](https://docs.anivahealth.com/fi/api/profiles/update-profile.md):** aseta jokaisen potilaan kieli. [Tulossivu](https://docs.anivahealth.com/fi/api/profiles/create-embed-session.md) ja tulossähköpostit käyttävät sitä.

**20. marraskuuta 2026**

## Yksi List Panels -päätepiste

* [List Panels](https://docs.anivahealth.com/fi/api/panels/list-panels.md) palauttaa nyt `biomarker_groups`-kentän. Käytä sitä polun `/api/v2/panels` sijaan.
* Create Panel on poistettu. Käytä [hallintapaneelia](https://anivahealth.com/admin/panels).

**20. marraskuuta 2026**

## 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.

<video autoPlay muted loop playsInline src="https://mintcdn.com/anivahealth/jen65wFY5PNmsE8T/images/changelog/results-embed-light.mp4?fit=max&auto=format&n=jen65wFY5PNmsE8T&q=85&s=61a5fec18b829a3a011f1af000e030ab" poster="/images/changelog/results-embed-light.png" aria-label="Kolme puhelinnäkymää tulossivusta: biomarkkerilista, D-vitamiinin trendi ja pyörivä 3D-Twin, jossa sydän- ja verisuonialue on valittuna." />

Tulossivu on maksullinen lisäosa, ja yhteyshenkilösi Anivalla kertoo sinulle hinnan.
[Create Embed Session](https://docs.anivahealth.com/fi/api/profiles/create-embed-session.md) näyttää, miten otat sen käyttöön.

**19. marraskuuta 2026**

## 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:

* [List Shipments](https://docs.anivahealth.com/fi/api/shipments/list-shipments.md)
* [List Home Kit Orders](https://docs.anivahealth.com/fi/api/home-kit-orders/list-home-kits.md)
* [List Appointments](https://docs.anivahealth.com/fi/api/appointments/list-appointments.md)
* [List Profiles](https://docs.anivahealth.com/fi/api/profiles/list-profiles.md)

`Get`-päätepisteet näyttävät muutokset edelleen suoraan.

Jos kyselet API:lta toistuvasti muutoksia, käytä sen sijaan [webhookeja](https://docs.anivahealth.com/fi/api/webhooks/create-webhook.md).
Webhook ilmoittaa sinulle jokaisesta muutoksesta heti sen tapahtuessa. Katso
[Toistuvat lukupyynnöt](https://docs.anivahealth.com/fi/concepts/webhooks.md#toistuvat-haut).

**18. marraskuuta 2026**

## 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.](https://mintcdn.com/anivahealth/3R-RUSdQmYnR_d5s/images/changelog/pickup-banner-light.png?fit=max\&auto=format\&n=3R-RUSdQmYnR_d5s\&q=85\&s=f42667b37f5a05cda53c0430c32fcc06)

**16. marraskuuta 2026**

## 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](https://docs.anivahealth.com/fi/concepts/results.md#aniva-alueet).

**15. marraskuuta 2026**

## Fluoridiputki on nyt `fluoride`

[Preview Containers](https://docs.anivahealth.com/fi/api/appointments/preview-containers.md) 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.

**10. marraskuuta 2026**

## 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](https://docs.anivahealth.com/fi/api/appointments/confirm-blood-draw.md)-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.

**10. marraskuuta 2026**

## Tiukemmat toimitusosoitteet kotitestipakkausten tilauksissa

[Create Home Kit](https://docs.anivahealth.com/fi/api/home-kit-orders/create-home-kit.md) ja
[Update Home Kit](https://docs.anivahealth.com/fi/api/home-kit-orders/update-home-kit.md) 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.

**9. marraskuuta 2026**

## 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](https://docs.anivahealth.com/fi/api/home-kit-orders/create-home-kit.md) -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.

**2. marraskuuta 2026**

## 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](https://docs.anivahealth.com/fi/concepts/results.md#saehkoepostit-tulosten-valmistumisesta).

**28. lokakuuta 2026**

## 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](https://docs.anivahealth.com/fi/concepts/profiles.md#anna-potilaan-syoettaeae-syntymaeaika-ja-sukupuoli).

**27. lokakuuta 2026**

## 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.

**26. lokakuuta 2026**

## Meille palautuneet pakkaukset

Kun kuljetusliike palauttaa pakkauksen meille, se näkyy nyt
[**Kotitestipakkaukset**](https://anivahealth.com/admin/home-kits)-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.

**26. lokakuuta 2026**

## Logaritmiset yksiköt

[Listaa yksiköt](https://docs.anivahealth.com/fi/api/units/list-units.md) 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.

**23. lokakuuta 2026**

## Kotitestipakkauksen hinta-arvio maksuineen

[Laske ostoskorin hinta-arvio](https://docs.anivahealth.com/fi/api/pricing/quote-cart.md) 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`.

**23. lokakuuta 2026**

## 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.

**23. lokakuuta 2026**

## Listaa yhden päivän ajanvaraukset

[Listaa ajanvaraukset](https://docs.anivahealth.com/fi/api/appointments/list-appointments.md) 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.

**23. lokakuuta 2026**

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

[Luo profiili](https://docs.anivahealth.com/fi/api/profiles/create-profile.md) 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.

**22. lokakuuta 2026**

## 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.

**21. lokakuuta 2026**

## Testiluettelo omilla hinnoillasi

Hallintapaneelin uusi [**Testiluettelo**](https://anivahealth.com/admin/test-catalog) listaa
jokaisen biomarkkerin laboratorioineen, näyteputkineen ja hinnastosi mukaisine hintoineen.

**20. lokakuuta 2026**

## Miksi tuloksella ei ole laboratorion viitealuetta

Jokaisessa kliinisessä tuloksessa päätepisteissä [Hae tulokset](https://docs.anivahealth.com/fi/api/appointments/get-results.md) ja
kotitestipakkausten [Hae laboratoriotulokset](https://docs.anivahealth.com/fi/api/home-kit-orders/get-results.md) 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](https://docs.anivahealth.com/fi/concepts/results.md#kun-laboratorion-viitealuetta-ei-ole).

**20. lokakuuta 2026**

## Vähittäishinnat ja koordinaatit

* Toimipisteillä on nyt `state_code`, `latitude` ja `longitude`.
* [Listaa vähittäishinnat](https://docs.anivahealth.com/fi/api/locations/list-retail-prices.md) ja
  [Hae vähittäishinnat](https://docs.anivahealth.com/fi/api/locations/get-retail-prices.md) palauttavat kunkin paneelin hinnan, jolla apteekki
  myy sen ilman ajanvarausta saapuville asiakkaille.
* `location.retail_prices.updated`-[webhook](https://docs.anivahealth.com/fi/concepts/webhooks.md) kertoo, kun hinta
  muuttuu.

Vähittäishintojen päätepisteet ja tapahtuma vaativat `retail_prices_view`-käyttöoikeuden.

**19. lokakuuta 2026**

## Tilaa kotitestipakkauksia hallintapaneelissa

Voit nyt tilata kotitestipakkauksen potilaallesi hallintapaneelin
[Kotitestipakkaukset-sivulla](https://anivahealth.com/admin/home-kits). Valitse tai luo
potilas, valitse pakkaus ja syötä toimitusosoite. Voit myös peruuttaa pakkauksen siellä.

**18. lokakuuta 2026**

## Hinnasto ja hinta-arviot

* [Hae hinnasto](https://docs.anivahealth.com/fi/api/pricing/get-rate-card.md) palauttaa hintasi Aniva-luettelossa ja maksusi.
* [Hinnoittele ostoskori](https://docs.anivahealth.com/fi/api/pricing/quote-cart.md) hinnoittelee paneelit ja biomarkkerit ilman ajanvarausta.
* Hinnoittele ostoskori- ja [Esikatsele ajanvaraus](https://docs.anivahealth.com/fi/api/appointments/preview-containers.md) -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.

**16. lokakuuta 2026**

## Lisää asiakirjatietoja

Jokaisessa [Hae tulokset](https://docs.anivahealth.com/fi/api/appointments/get-results.md) -päätepisteen `documents`-kentän kohteessa on nyt:

* `file_name`: nimi, jota [Lataa asiakirja](https://docs.anivahealth.com/fi/api/documents/download-document.md) 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.

**16. lokakuuta 2026**

## 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](https://docs.anivahealth.com/fi/api/webhooks/create-webhook.md). 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](https://www.standardwebhooks.com) -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](https://docs.anivahealth.com/fi/api/appointments/get-results.md) -päätepisteen tuloksella on nyt `id`, jotta voit
  päivittää tuloksen, johon `results.updated`-tapahtuma viittaa.
* [Hae toimipiste](https://docs.anivahealth.com/fi/api/locations/get-location.md) palauttaa yhden toimipisteen sen `id`-arvolla. `location.*`-tapahtuman
  `url` osoittaa siihen.

Katso [Webhookit](https://docs.anivahealth.com/fi/concepts/webhooks.md).

**15. lokakuuta 2026**

## 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](https://anivahealth.com/admin/results) tai kahden uuden
päätepisteen kautta: [Lähetä tulokset sähköpostilla](https://docs.anivahealth.com/fi/api/appointments/email-results.md) ajanvarauksille ja
[Lähetä tulokset sähköpostilla](https://docs.anivahealth.com/fi/api/home-kit-orders/email-results.md) 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](https://docs.anivahealth.com/fi/api/appointments/create-appointment.md),
[Luo kotitestipakkaustilaus](https://docs.anivahealth.com/fi/api/home-kit-orders/create-home-kit.md),
[Päivitä ajanvaraus](https://docs.anivahealth.com/fi/api/appointments/update-appointment.md) ja
[Päivitä kotitestipakkaustilaus](https://docs.anivahealth.com/fi/api/home-kit-orders/update-home-kit.md).

**15. lokakuuta 2026**

## 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](https://docs.anivahealth.com/fi/api/home-kit-orders/create-home-kit.md).

**15. lokakuuta 2026**

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

Neljä uutta toimipistettä laskimoverinäytteenottoon. Katso [Listaa toimipisteet](https://docs.anivahealth.com/fi/api/locations/list-locations.md).

**13. lokakuuta 2026**

## Laboratoriotulokset-sivu

Hallintapaneelin uusi [Laboratoriotulokset-sivu](https://anivahealth.com/admin/results) 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.

**8. lokakuuta 2026**

## 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](https://docs.anivahealth.com/fi/api/home-kit-orders/activate-home-kit.md).

**30. syyskuuta 2026**

## 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](https://docs.anivahealth.com/fi/api/profiles/create-profile.md).

**27. syyskuuta 2026**

## 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](https://docs.anivahealth.com/fi/api/home-kit-orders/activate-home-kit.md).

**25. syyskuuta 2026**

## 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](https://docs.anivahealth.com/fi/api/appointments/get-results.md).

**21. syyskuuta 2026**

## 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](https://docs.anivahealth.com/fi/concepts/home-kit-orders.md).

**10. syyskuuta 2026**

## 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](https://docs.anivahealth.com/fi/concepts/pricing.md).

**3. syyskuuta 2026**

## 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](https://docs.anivahealth.com/fi/concepts/idempotency.md).

**1. syyskuuta 2026**

## 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](https://docs.anivahealth.com/fi/api/locations/list-locations.md) nähdäksesi,
mihin toimipisteisiin avaimesi voi varata aikoja.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.