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

# Rezultate

> Cum funcționează rezultatele și documentele de laborator în API-ul Aniva: valori ale biomarkerilor, intervale de referință, rapoarte de laborator și webhook-uri pentru rezultate.

După ce o recoltare de sânge este confirmată și laboratorul procesează probele, rezultatele devin disponibile în programare. Rezultatele se preiau prin `GET /api/v1/appointments/{id}/results` și includ rezultate de biomarkeri clinici, rezultate de biomarkeri genetici și documente descărcabile cu rapoarte de laborator.

## Statusul rezultatelor

Câmpul `status` de nivel superior din răspunsul cu rezultate indică progresul general al procesării:

| Status | Semnificație |
| - | - |
| `in_progress` | Unele trimiteri sunt încă procesate de laborator. |
| `completed` | Toate trimiterile s-au încheiat și cel puțin una a raportat. |
| `fault` | Fiecare trimitere a eșuat fără a raporta. Nu mai sunt așteptate rezultate. |

Rezultatele individuale din răspuns au propriul status per rezultat (vezi mai jos), astfel încât poți afișa rezultate parțiale cât timp statusul general este încă `in_progress`.

Pentru a afla când se modifică rezultatele, abonează-te la [webhook-uri](https://docs.anivahealth.com/ro/concepts/webhooks.md). `appointment.results.updated` se declanșează la fiecare modificare a corpului rezultatelor, iar `appointment.results.completed` se declanșează când statusul de nivel superior trece în `completed`. Comenzile de kituri de testare la domiciliu trimit aceleași evenimente cu prefixul `home_kit_order.`. Fiecare eveniment conține URL-ul rezultatelor de preluat. Poți în continuare să interoghezi periodic acest endpoint pentru reconciliere.

Array-ul `submissions` detaliază statusul de nivel superior pentru fiecare cerere de laborator. O recoltare de sânge care implică mai multe eprubete sau mai multe laboratoare are mai multe intrări, fiecare cu codul `lab_code` (codul de bare al eprubetei) sub care a fost înregistrată și propriul status `in_progress` / `completed` / `fault`. O intrare `fault` a fost respinsă sau abandonată la laborator și nu va raporta niciodată: proba a fost adesea mutată la alt laborator, care înregistrează apoi propria intrare. Statusul de nivel superior este `completed` când fiecare intrare s-a încheiat și cel puțin una a raportat. Fiecare rezultat primit și fiecare document poartă același `lab_code`, astfel încât poți ști din ce eprubetă provine o valoare.

## Rezultate clinice

Rezultatele clinice reprezintă măsurători standard de biomarkeri din sânge — lucruri precum nivelul de vitamina D, colesterolul, hormonii tiroidieni și așa mai departe.

Fiecare rezultat clinic include:

* **`id`** — identificatorul rândului de rezultat de laborator. Rămâne același când laboratorul corectează acel rând, așa că folosește-l pentru upsert. `null` pentru un rezultat `planned`.
* **`biomarker_name`** și **`category`** — ce s-a măsurat și categoria aferentă (de ex., Vitamine, Hormoni).
* **`lab_code`** — codul de laborator (codul de bare al eprubetei) sub care a fost înregistrat rezultatul, unul dintre codurile de laborator ale comenzii. `null` pentru un rezultat `planned` și pentru rezultatele raportate de laborator fără cod.
* **`value`** și **`value_operator`** — măsurătoarea efectivă. Operatorul este `eq` (egal) pentru valori exacte sau `lt`/`gt` când laboratorul raportează o valoare sub sau peste intervalul măsurabil.
* **`unit`** — unitatea de măsură (de ex., ng/mL, µIU/mL).
* **`reference_range_lab`** — limitele min/max normale și optime raportate de laborator pentru acest rezultat, convertite pe aceeași scară ca `value`. O limită lăsată deschisă de laborator este `null`, astfel că un interval unilateral precum `< 50` ajunge ca `normal_min: null, normal_max: 50`. Fiecare rezultat poartă intervalul față de care a fost măsurat, astfel încât un pacient cu rezultate din mai multe recoltări de sânge sau laboratoare primește intervalul corect pentru fiecare rezultat.
* **`reference_range_lab_absent_reason`** — motivul pentru care `reference_range_lab` este `null`. `null` când intervalul este prezent și pentru un rezultat `planned`. Vezi [Când nu există interval de laborator](#cand-nu-exista-interval-de-laborator).
* **`aniva_range`** — Valori de comparație compilate de Aniva, pe aceeași scară ca `value`. Diferă în funcție de vârstă, sex și săptămâna de sarcină. `normal_*` este intervalul general. `optimal_*` este un interval mai restrâns. Valorile au doar scop informativ. Nu sunt sfaturi medicale, nu sunt un diagnostic și nu reprezintă o evaluare a rezultatului. Aniva nu setează niciun indicator pe baza lor. Folosește `reference_range_lab` ca standard pentru rezultat. `null` când cheia ta nu are scope-ul `aniva_ranges_view` sau când Aniva nu are valori pentru acest biomarker.
* **`tested_at`** — data la care a fost efectuat testul.
* **`comment`** — adnotare de tip text liber de la laborator pentru acest rezultat specific (de ex., indicații privind intervalul de referință, avertizări privind calitatea probei). `null` când laboratorul nu a atașat niciuna.
* **`status_reason`** — motivul pentru care un rezultat `likely_wrong` este îndoielnic sau un rezultat `fault` ori `undeliverable` este inutilizabil. `null` pentru orice alt status. Distinct de `comment`, care este nota proprie a laboratorului și este adesea goală pentru rezultatele cu eroare.
* **`origin`** — cine a livrat documentul din care provine valoarea, aceleași valori ca `origin` al documentului de mai jos. O valoare dintr-un document încărcat (`member_upload`, `staff_upload`, `partner_upload`) provine din citirea fișierului de către Aniva, nu dintr-un raport de laborator: verific-o față de fișier înainte de utilizarea clinică. `null` pentru un rezultat `planned`.
* **`lab_reported`** — linia proprie de raportare a laboratorului care a efectuat analiza, exact așa cum a fost raportată și neconvertită. Vezi mai jos.

### Intervalele Aniva

`aniva_range` conține valori de comparație compilate de Aniva din surse publicate și
din selecția proprie. Intervalele diferă în funcție de vârstă, sex și săptămâna de sarcină.
`sources` enumeră sursele publicate pe care Aniva le-a înregistrat pentru aceste valori. Lista poate fi goală.

> [!WARNING]
>
> Valorile sunt informații generale. Nu sunt sfaturi medicale, nu sunt un diagnostic, nu sunt o
> constatare medicală și nu reprezintă o evaluare a unui rezultat. Aniva nu le oferă ca dispozitiv
> medical. Aniva nu compară un rezultat cu acestea și nu setează niciun indicator pe baza lor.
> `reference_range_lab` și evaluarea unui medic rămân standardul pentru un rezultat.

Reguli pentru produsul tău:

* Afișează intervalul Aniva doar în completarea intervalului de laborator, niciodată în locul acestuia.
* Dacă derivezi un indicator, o avertizare sau o recomandare din intervalul Aniva, faci acest lucru în
  nume propriu și pe propria răspundere.
* Afișează mențiunea din acordul tău cu Aniva oriunde afișezi intervalul Aniva.

Pentru a primi acces, semnează acordul scurt privind intervalele Aniva. Adăugăm apoi
scope-ul `aniva_ranges_view` la cheia ta. Valorile se pot modifica fără notificare prealabilă.

### Valori normalizate față de linia proprie a laboratorului

`value`, `unit` și `reference_range_lab` sunt normalizate: convertim fiecare măsurătoare în unitatea canonică a biomarkerului și o raportăm sub propria noastră denumire de biomarker, astfel încât același analit să fie comparabil între laboratoare și în timp. Asta îți dorești pentru urmărirea tendințelor și compararea între laboratoare, dar nu este ceea ce vede un medic evaluator pe PDF-ul laboratorului — fosfataza alcalină tipărită ca `48 U/l (40 - 129)` ajunge la tine ca `0.8 µkat/L`.

`lab_reported` poartă acea linie tipărită alături: denumirea și codul analitului din laborator, valoarea și unitatea așa cum au fost tipărite, intervalul de referință atât ca text (`< 50`, `> 55`, `40 - 129`), cât și ca limitele proprii neconvertite ale laboratorului, plus indicatorul de valoare anormală, statusul rezultatului și nota.

Folosește `lab_reported` când o persoană reconciliază datele tale cu raportul laboratorului, iar câmpurile canonice pentru tot ce este calculat. Sunt completate doar câmpurile pe care laboratorul le-a trimis efectiv; nimic din `lab_reported` nu este dedus, completat cu valori implicite sau convertit, iar întregul obiect este `null` când nu deținem o înregistrare brută pentru un rezultat.

### Când nu există interval de laborator

Când `reference_range_lab` este `null`, `reference_range_lab_absent_reason` îți spune de ce:

| Valoare | Semnificație | Afișează |
| - | - | - |
| `not_provided` | Nu există niciun interval. Laboratorul nu a trimis unul. | "Nu se aplică" |
| `lab_text_only` | Laboratorul a tipărit doar text, cum ar fi o țintă, un nivel de risc sau un interval pe etape de viață. | Textul din `lab_reported.reference_range` |
| `not_measured` | Rezultatul este `undeliverable`, deci nu există o valoare de comparat. | `status_reason` |

Unele laboratoare tipăresc o țintă sau un nivel de risc în locul unui interval de referință, de exemplu
`Ziel: <200. >240 hoch` sau `<5.7 neg >=6.5 pos`. Acestea nu intră în `reference_range_lab`, deci
limitele sale sunt `null`, iar motivul este `lab_text_only`. Afișează textul tipărit exact ca atare.

Un interval unilateral precum `< 20` este un interval. Ajunge în `reference_range_lab` cu o limită
`null`, iar motivul este `null`. Păstrează capătul deschis ca atare când îl afișezi.

### Statusurile rezultatelor clinice

| Status | Semnificație |
| - | - |
| `planned` | Testul este comandat, dar rezultatele nu au sosit încă de la laborator. |
| `received` | Laboratorul a returnat un rezultat. |
| `corrected` | Un evaluator uman a revizuit valoarea raportată de laborator. |
| `likely_wrong` | Verificarea automată a Aniva sau membrul are dubii privind valoarea. Neconfirmat: nu o afișa ca o constatare fără verificare. Vezi `status_reason`. |
| `fault` | Laboratorul a livrat un rezultat confirmat eronat — **nu îl utiliza clinic**. `value` conține încă cifra eronată; vezi `status_reason`. |
| `undeliverable` | Laboratorul nu a putut produce o valoare. `value` este `null`; vezi `status_reason`. |

> [!TIP]
>
> Când afișezi rezultatele pacienților, folosește direct câmpul `value` — acesta reflectă deja
> valoarea corectată atunci când există una.

> [!WARNING]
>
> Nu prezenta niciodată un rezultat `fault` ca o constatare — câmpul `value` este completat, dar confirmat incorect.

## Rezultate genetice

Rezultatele genetice reprezintă constatări la nivel de genă din analiza ADN. Fiecare rezultat corespunde unei gene (de ex., APOE, MTHFR) și include:

* **`id`** — identificatorul rândului de rezultat de laborator. Rămâne același când laboratorul corectează acel rând, așa că folosește-l pentru upsert. `null` pentru un rezultat `planned`.
* **`gene`** — simbolul genei.
* **`lab_code`** — codul de laborator (codul de bare al eprubetei) sub care a fost înregistrat rezultatul. `null` pentru un rezultat `planned` și pentru rezultatele raportate de laborator fără cod.
* **`genotype`** — genotipul detectat (de ex., E3/E4).
* **`clinical_significance`** — o clasificare a constatării bazată pe ACMG.
* **`risk_description`** — o explicație ușor de citit despre ce înseamnă genotipul.
* **`comment`** — adnotare de tip text liber de la laborator pentru acest rezultat specific. `null` când laboratorul nu a atașat niciuna.
* **`status_reason`** — motivul pentru care un rezultat `likely_wrong` este îndoielnic sau un rezultat `fault` ori `undeliverable` este inutilizabil. `null` pentru orice alt status.
* **`origin`** — cine a livrat documentul din care provine valoarea, la fel ca la rezultatele clinice.
* **`variants`** — variantele genetice specifice detectate, fiecare cu detalii la nivel de SNV.

### Valori pentru semnificația clinică

| Valoare | Categorie |
| - | - |
| `pathogenic`, `likely_pathogenic` | Care provoacă boli sau probabil provoacă boli |
| `uncertain` | Variantă cu semnificație incertă (VUS) |
| `likely_benign`, `benign` | Care nu provoacă boli |
| `high_risk`, `moderate_risk`, `low_risk` | Clasificare pe nivel de risc |
| `protective` | Variantă protectoare |
| `drug_response`, `poor_metabolizer`, `rapid_metabolizer` | Rezultate farmacogenomice |

### Statusurile rezultatelor genetice

| Status | Semnificație |
| - | - |
| `planned` | Testul este comandat, dar rezultatele nu au sosit încă. |
| `received` | Laboratorul a returnat un rezultat. |
| `likely_wrong` | Verificarea automată Aniva sau membrul are îndoieli privind genotipul. Neconfirmat. Vezi `status_reason`. |
| `fault` | Laboratorul a livrat un rezultat confirmat greșit — **nu îl folosi clinic**. Vezi `status_reason`. |
| `undeliverable` | Laboratorul nu a putut obține un genotip. Vezi `status_reason`. |

### Structura variantei

Fiecare rezultat genetic conține un array `variants`. Fiecare variantă include:

* **`name`** — denumirea comună (de ex., APOE E4).
* **`clinical_significance`** — semnificația la nivel de variantă (poate diferi de semnificația la nivel de genă).
* **`conditions`** — bolile/afecțiunile asociate, cu descrieri.
* **`snvs`** — variantele de un singur nucleotid aferente, fiecare cu `rs_id`, `allele`, `reference_allele` și notație HGVS opțională.

## Documente

Array-ul `documents` din răspunsul cu rezultate conține referințe la fișierele descărcabile ale rapoartelor de laborator. Fiecare document are:

* **`id`** — un UUID de fișier. Trimite-l către `GET /api/v1/documents/{id}` pentru a descărca fișierul.
* **`file_name`** — numele fișierului, același pe care îl trimite descărcarea (de ex., `20260405 - Quade Befund - 7642001234.pdf`).
* **`original_file_name`** — numele fișierului exact așa cum l-a livrat laboratorul sau persoana care l-a încărcat (de ex., `7642001234_B0012_FA_E.pdf`).
* **`origin`** — cine a livrat fișierul: `lab`, `member_upload`, `staff_upload` sau `partner_upload` (l-ai încărcat cu [Încarcă document](https://docs.anivahealth.com/ro/api/documents/upload-document.md)).
* **`content_type`** — tipul media al fișierului (de ex., `application/pdf`). Majoritatea rapoartelor sunt PDF-uri. Scanările încărcate pot fi imagini sau fișiere CSV.
* **`etag`** — versiunea conținutului fișierului; se schimbă ori de câte ori se schimbă octeții. Stocheaz-o și descarcă din nou doar când se schimbă. Este eticheta de entitate HTTP standard, așa cum este folosită de S3 sau Google Cloud Storage.
* **`size_bytes`** — dimensiunea fișierului în octeți.
* **`lab_code`** — codul de laborator (codul de bare al eprubetei) căruia îi aparține raportul; `null` când laboratorul nu a înregistrat niciunul.

> [!NOTE]
>
> Accesul la documente este validat în funcție de profilul care deține documentul.

## Trimiterea rezultatelor prin e-mail către client

Poți anunța clientul prin e-mail că rezultatele sale sunt gata. Apelează
[Trimite rezultatele prin e-mail](https://docs.anivahealth.com/ro/api/appointments/email-results.md) pentru o programare sau
[Trimite rezultatele prin e-mail](https://docs.anivahealth.com/ro/api/home-kit-orders/email-results.md) pentru o comandă de kit de testare la domiciliu. Fiecare apel trimite un e-mail.
Apelurile nu sunt deduplicate.

* E-mailul este trimis la adresa `email` a profilului. O adresă provizorie `@aniva.email` este refuzată.
* E-mailul afișează numele și logo-ul grupului principal de profiluri al profilului.
* E-mailul este în limba `language` a profilului, implicit engleză.
* Setează `with_reports` la `true` pentru a atașa rapoartele de laborator.
* Adaugă `note` pentru a afișa o notă personală în e-mail, de cel mult 1.000 de caractere.

Dacă profilul a dezactivat e-mailurile tranzacționale, apelul returnează `409` cu motivul
`unsubscribed`. Pentru a le activa din nou, setează `transactional_emails_enabled` pe `true` cu
[Actualizează profilul](https://docs.anivahealth.com/ro/api/profiles/update-profile.md).

## E-mailuri când rezultatele sunt gata

Poți primi un e-mail când rezultatele unei rezervări sunt gata. Setează `results_ready_emails` cu până la 5
adrese în [Creează programare](https://docs.anivahealth.com/ro/api/appointments/create-appointment.md) sau
[Creează comandă de kit de testare la domiciliu](https://docs.anivahealth.com/ro/api/home-kit-orders/create-home-kit.md). Modifică lista mai târziu cu
[Actualizează programarea](https://docs.anivahealth.com/ro/api/appointments/update-appointment.md) sau
[Actualizează comanda de kit de testare la domiciliu](https://docs.anivahealth.com/ro/api/home-kit-orders/update-home-kit.md); `[]` dezactivează e-mailurile.

* Roagă-ne să setăm adrese de e-mail implicite pentru grupul tău de profiluri. O rezervare creată fără
  `results_ready_emails` le primește pe acestea. O listă le înlocuiește pentru acea rezervare, așa că include adresa ta
  de e-mail implicită pentru a o păstra. `[]` nu trimite niciun e-mail.
* Fiecare adresă primește un e-mail, odată ce toate rezultatele de laborator ale rezervării sunt finale.
* O adresă adăugată după ce rezultatele sunt finale primește e-mailul imediat.
* E-mailul conține un link către pagina de rezultate din panoul de administrare Aniva. Clientul nu îl primește.
* Cheia ta are nevoie de acces `results_view` la pacient. Fără acesta, cererea returnează `403`.

## Afișează rezultatele în aplicația ta

[Creează sesiune embed](https://docs.anivahealth.com/ro/api/profiles/create-embed-session.md) returnează un URL de unică folosință pentru o pagină
de rezultate doar în citire. Deschide-l într-un WebView al aplicației tale, ca pacientul să vadă rezultatele fără autentificare.

* Cheia ta are nevoie de scope-urile `embed` și `results_view` pentru pacient. Cere de la Aniva scope-ul
  `embed`.
* Apelează-l de pe serverul tău de fiecare dată când pacientul deschide rezultatele. URL-ul funcționează o singură dată și timp de
  5 minute, iar apoi pagina menține o sesiune de 60 de minute.
* `route` deschide una dintre paginile pe care le punem la dispoziție: lista de biomarkeri, un biomarker sau Twin-ul 3D.
* `appearance` setează tema, culoarea butoanelor și a linkurilor și dacă se afișează logo-ul tău.
* `report` limitează pagina la o programare, o comandă de kit de testare la domiciliu sau un raport de laborator pe care
  l-ai încărcat cu `POST /api/v1/documents`. Pacientul vede atunci doar rezultatele acelui raport.
* Pagina afișează doar rezultate de laborator, la fel ca acest API. Nu afișează fișiere, chat sau setări.

## Exemplu de răspuns cu rezultate

```json theme={null}
{
  "status": "in_progress",
  "submissions": [
    {
      "lab_code": "7642001234",
      "status": "in_progress"
    }
  ],
  "clinical_results": [
    {
      "id": "3f2b8c1e-5d4a-4e7b-9a6c-2d1f0e8b7a54",
      "status": "received",
      "status_reason": null,
      "lab_code": "7642001234",
      "biomarker_id": 104,
      "biomarker_name": "Vitamin D",
      "category": "Vitamins",
      "value": 38.5,
      "value_operator": "eq",
      "unit_id": 1,
      "unit": "ng/mL",
      "reference_range_lab": {
        "normal_min": 30,
        "normal_max": 100,
        "optimal_min": null,
        "optimal_max": null
      },
      "reference_range_lab_absent_reason": null,
      "aniva_range": {
        "normal_min": 30,
        "normal_max": 100,
        "optimal_min": 30,
        "optimal_max": 60,
        "sources": [
          {
            "title": "Example source title",
            "url": "https://example.com/source"
          }
        ]
      },
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "lab_reported": {
        "name": "Vitamin D (25-OH)",
        "code": "vitd",
        "category": "Endokrinologie",
        "value": "38.5",
        "unit": "ng/ml",
        "reference_range": "30 - 100",
        "reference_range_min": 30,
        "reference_range_max": 100,
        "flag": "normal",
        "result_status": "final",
        "comment": null
      }
    },
    {
      "id": null,
      "status": "planned",
      "status_reason": null,
      "lab_code": null,
      "biomarker_id": 79,
      "biomarker_name": "Thyroid-Stimulating Hormone (TSH)",
      "category": "Hormones",
      "value": null,
      "value_operator": null,
      "unit_id": null,
      "unit": null,
      "reference_range_lab": null,
      "reference_range_lab_absent_reason": null,
      "aniva_range": null,
      "tested_at": null,
      "comment": null,
      "origin": null,
      "lab_reported": null
    }
  ],
  "genetic_results": [
    {
      "id": "b7e41d09-2c6f-4a83-8f15-6e9d3a0c4b21",
      "status": "received",
      "status_reason": null,
      "lab_code": "7642001234",
      "biomarker_id": 348,
      "gene": "APOE",
      "genotype": "E3/E4",
      "clinical_significance": "moderate_risk",
      "risk_description": "Carriers of one APOE E4 allele have a moderately increased risk of Alzheimer's disease.",
      "tested_at": "2026-04-05",
      "comment": null,
      "origin": "lab",
      "variants": [
        {
          "name": "APOE E4",
          "clinical_significance": "moderate_risk",
          "description": "The E4 allele is associated with increased Alzheimer's risk.",
          "hgvs_c": "c.388T>C",
          "hgvs_p": "p.Cys130Arg",
          "conditions": [
            {
              "condition": "Alzheimer's disease",
              "association_description": "Increased risk with one E4 allele",
              "badge": "Moderate Risk"
            }
          ],
          "snvs": [
            {
              "rs_id": "rs429358",
              "allele": "C",
              "reference_allele": "T",
              "hgvs_c": "c.388T>C",
              "hgvs_p": "p.Cys130Arg"
            }
          ]
        }
      ]
    }
  ],
  "documents": [
    {
      "id": "f8a1b2c3-d4e5-4f6a-7b8c-9d0e1f2a3b4c",
      "file_name": "20260405 - Quade Befund - 7642001234.pdf",
      "original_file_name": "7642001234_B0012_FA_E.pdf",
      "origin": "lab",
      "content_type": "application/pdf",
      "etag": "56104b36f860cfd5b41efc716fdf7b6f",
      "size_bytes": 258341,
      "lab_code": "7642001234"
    }
  ]
}
```


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