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

# Actualizează comanda de kit de testare la domiciliu

> Modifică un kit de testare la domiciliu trimis prin poștă

Actualizează adresa de livrare, panelul, metadatele sau e-mailurile pentru rezultate gata ale unei comenzi de kit de testare la domiciliu. Include doar câmpurile pe care vrei să le modifici.

Adresa de livrare și panelul pot fi modificate doar cât timp comanda este `pending`, deoarece kitul fizic pleacă la expediere. `metadata` este pentru evidența ta proprie și poate fi editat pe toată durata comenzii.

Nu există endpointuri de adăugare/eliminare de paneluri: un kit de testare la domiciliu conține exact un panel (corespunde 1:1 cu un produs de kit fizic), deci singura operațiune relevantă pentru panel este înlocuirea pe care o faci aici.

Necesită scope-ul `home_kit_orders_manage`.

## Cerere

### Parametri de cale

**id** `string` *required*

Identificator unic (UUID) al comenzii de kit de testare la domiciliu de actualizat.

### Parametri de corp

Toți parametrii din body sunt opționali — include doar câmpurile pe care vrei să le modifici.

**delivery\_address** `object`

Adresa la care se trimite kitul — în una dintre cele două forme: fie `{ location_id }`, care face referire la o locație de testare cunoscută, fie câmpurile de adresă inline (`name`, `street`, `city`, `postal_code`, `country_code`; opțional `company_name` / `house_number` / `address_line_2` / `state` / `phone` / `email` — același vocabular ca în API-ul de locații). Furnizează exact una dintre variante — o referință de locație sau o adresă inline, nu ambele.

**adresa de livrare**

> [tab] Referință la o locație
>
> **location\_id** `string` *required*
>
> UUID-ul unei locații de testare cunoscute la care se expediază kitul. Corelează cu [Listează
> locațiile](https://docs.anivahealth.com/ro/api/locations/list-locations.md).

> [tab] Adresă inline
>
> **name** `string` *required*
>
> Numele destinatarului, al companiei sau al locației.
>
> **company\_name** `string`
>
> Compania care preia coletul pentru destinatar — un intermediar `c/o` sau un departament.
>
> **street** `string` *required*
>
> Numele străzii, fără numărul imobilului (de ex. `Wilhelmstraße`).
>
> **house\_number** `string`
>
> Numărul imobilului (de ex. `118` sau `12a`).
>
> **address\_line\_2** `string`
>
> Clădire, scară sau etaj.
>
> **city** `string` *required*
>
> **state** `string`
>
> Stat sau provincie. Opțional.
>
> **postal\_code** `string` *required*
>
> Cod poștal. O adresă din Germania (`country_code` `DE`) necesită exact 5 cifre, de ex. `10117`.
>
> **country\_code** `string` *required*
>
> Cod ISO 3166-1 alpha-2 (două litere, de ex. `DE`). Literele mici sunt acceptate și stocate ca
> majuscule.
>
> **phone** `string`
>
> Numărul de telefon al destinatarului, cu prefix de țară (de ex. `+4791234567`). Curierul îl folosește pentru a
> anunța destinatarul despre colet, de exemplu că îl așteaptă la un punct de ridicare. Omite-l
> și curierul nu primește niciun număr de telefon.
>
> **email** `string`
>
> Adresa de e-mail a destinatarului. Curierul o folosește la fel ca `phone`. Omite-o și curierul nu primește nicio
> adresă de e-mail.

> [!NOTE]
>
> **Packstation sau Postfiliale (doar în Germania):** setează `street` la `Packstation` sau `Postfiliale`,
> `house_number` la numărul de trei cifre al stației și `address_line_2` la DHL
> Postnummer al destinatarului (6–10 cifre, spațiile sunt permise). Fără Postnummer, expedierea coletului nu poate fi înregistrată.
> Postfach nu este acceptat.

**panel\_id** `string`

UUID-ul panelului de atașat în locul celui curent — cum există exact un panel per kit, înlocuirea
este singura operațiune relevantă. Posibilă doar cât timp comanda este `pending` și doar către un panel configurat
de Aniva cu un produs de kit pentru expediere (altfel `422`); înlocuirea cu panelul deja atașat
nu are niciun efect.

**metadata** `object`

Propriile tale perechi cheie/valoare. **Se combină** cu metadatele existente în loc să le înlocuiască: cheile pe care le
omiți se păstrează, o cheie trimisă cu valoarea `null` este ștearsă, iar un obiect gol `{}` șterge
tot. Limitele sunt aceleași ca la [Creare comandă de kit de testare la domiciliu](https://docs.anivahealth.com/ro/api/home-kit-orders/create-home-kit.md), iar
validarea este de tip totul-sau-nimic — dacă o cheie este respinsă, nu se salvează nimic. Nu pune niciodată date personale sau
clinice în `metadata` — acestea nu sunt tratate ca date ale pacientului.

**results\_ready\_emails** `string[]`

Înlocuiește lista de până la 5 adrese care primesc câte un e-mail odată ce toate rezultatele de laborator sunt finale.
Trimite `[]` pentru a dezactiva e-mailurile. Editabil în orice status, cu excepția `cancelled`. Cheia ta are nevoie de
acces `results_view` la pacient, altfel `403`. Vezi
[E-mailuri pentru rezultate gata](https://docs.anivahealth.com/ro/concepts/results.md#e-mailuri-cand-rezultatele-sunt-gata).

## Răspuns

La succes, API-ul returnează `200 OK` cu comanda de kit de testare la domiciliu actualizată și profilul său încorporat.

**id** `string` *required*

Identificatorul unic (UUID) al comenzii de kit de testare la domiciliu.

**profile\_id** `string` *required*

UUID-ul profilului căruia îi aparține această comandă de kit de testare la domiciliu.

**status** `string` *required*

Statusul curent al comenzii de kit de testare la domiciliu. Una dintre valorile `pending`, `dispatched`, `activated` sau `cancelled`.

**delivery\_address** `object` *required*

Adresa la care se trimite kitul — în una dintre două forme: fie `{ location_id }` cu referire la o locație de testare cunoscută, fie câmpurile de adresă inline (`name`, `street`, `city`, `postal_code`, `country_code`; `company_name` / `house_number` / `address_line_2` / `state` / `phone` / `email` opționale — același vocabular ca în API-ul de locații). Furnizează exact una dintre ele — o referință de locație sau o adresă inline, nu ambele.

**adresa de livrare**

> [tab] Referință de locație
>
> **location\_id** `string` *required*
>
> UUID-ul locației de testare la care se expediază kitul.

> [tab] Adresă inline
>
> **name** `string` *required*
>
> Numele destinatarului, al companiei sau al locației.
>
> **company\_name** `string`
>
> Compania care păstrează coletul pentru destinatar — o parte `c/o` sau un departament.
>
> **street** `string` *required*
>
> Numele străzii, fără număr (de ex. `Wilhelmstraße`).
>
> **house\_number** `string`
>
> Numărul casei (de ex. `118` sau `12a`).
>
> **address\_line\_2** `string`
>
> Clădire, scară sau etaj.
>
> **city** `string` *required*
>
> **state** `string`
>
> Stat sau provincie. Opțional.
>
> **postal\_code** `string` *required*
>
> **country\_code** `string` *required*
>
> Cod ISO 3166-1 alpha-2 (două litere, de ex. `DE`).
>
> **phone** `string`
>
> **email** `string`

**lab\_code** `string`

Codul de probă de laborator sub care sunt raportate rezultatele — tipărit pe kitul fizic, pe care
pacientul îl citește de pe cutie ca cod de activare. `null` până când kitul este ambalat.
Doar citire.

**activated\_at** `string` *required*

Marcajul temporal al recoltării raportat prin [Activează](https://docs.anivahealth.com/ro/api/home-kit-orders/activate-home-kit.md) — momentul în care
pacientul și-a recoltat proba. `null` până când kitul este activat.

**replaces\_home\_kit\_order\_id** `string`

Comanda de kit de testare la domiciliu pe care o înlocuiește aceasta, când este un kit de înlocuire. `null` pentru o comandă obișnuită. Vezi
[Creează comandă de kit de testare la domiciliu](https://docs.anivahealth.com/ro/api/home-kit-orders/create-home-kit.md).

**replacement\_reason** `string`

Motivul pentru care a fost trimis kitul de înlocuire. `null` pentru o comandă obișnuită.

**results\_ready\_emails** `string[]` *required*

Adresele care primesc fiecare câte un e-mail când toate rezultatele de laborator sunt finale, cu
litere mici. Gol când este dezactivat. Vezi
[E-mailuri pentru rezultate gata](https://docs.anivahealth.com/ro/concepts/results.md#e-mailuri-cand-rezultatele-sunt-gata).

**metadata** `object` *required*

Perechi cheie/valoare definite de partener, returnate exact așa cum au fost trimise. Întotdeauna prezent — `{}` când nu este setat.

**created\_at** `string` *required*

Marcajul temporal ISO 8601 al momentului în care a fost creată comanda de kit de testare la domiciliu.

**updated\_at** `string`

Timestamp ISO 8601 al ultimei actualizări. Poate fi `null`.

**profile** `object` *required*

Profilul pacientului asociat acestei comenzi de kit de testare la domiciliu.

**profil**

**id** `string`

Identificatorul unic al profilului (UUID).

**handle** `string`

Handle-ul profilului sau numele de utilizator. Poate fi `null`.

**first\_name** `string`

Prenume. Poate fi `null`.

**last\_name** `string`

Nume de familie. Poate fi `null`.

**email** `string`

Adresă de e-mail. Poate fi `null`.

**phone** `string`

Număr de telefon în format E.164. Poate fi `null`.

**sex** `integer`

Sex biologic conform ISO/IEC 5218. Poate fi `null`.

**date\_of\_birth** `string`

Data nașterii în format `YYYY-MM-DD`. Poate fi `null`.

**height** `number`

Înălțime în centimetri. Poate fi `null`.

**weight** `number`

Greutate în kilograme. Poate fi `null`.

**language** `string`

Limba preferată: unul dintre cele 32 de coduri din [Creează profil](https://docs.anivahealth.com/ro/api/profiles/create-profile.md).

**transactional\_emails\_enabled** `boolean`

Indică dacă acest profil primește e-mailuri tranzacționale (programatice). Poate fi `null`.

**created\_at** `string`

Timestamp ISO 8601 al creării profilului.

**updated\_at** `string`

Timestamp ISO 8601 al ultimei actualizări a profilului. Poate fi `null`.

**panels** `HomeKitOrderPanel[]` *required*

Panelul atașat acestei comenzi de kit de testare la domiciliu — întotdeauna exact unul (un kit de testare la domiciliu corespunde 1:1 cu un
produs de kit fizic), înlocuit direct când trimiți `panel_id`. Consultă detaliile panelului (nume,
biomarkeri) prin [Listare paneluri](https://docs.anivahealth.com/ro/api/panels/list-panels.md).

**Câmpuri pentru atașarea panelului**

**panel\_id** `string`

UUID-ul panelului — corelează cu [Listează panelurile](https://docs.anivahealth.com/ro/api/panels/list-panels.md).

**added\_at** `string`

Marcajul temporal ISO 8601 al momentului în care panelul a fost atașat prima dată la această comandă de kit de testare la domiciliu.

**individual\_biomarkers** `HomeKitOrderIndividualBiomarker[]` *required*

Biomarkeri individuali atașați acestei comenzi de kit de testare la domiciliu, în afara oricărui panel. Corelează fiecare
`biomarker_id` cu [Listare biomarkeri](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md) folosind `home_kit=true` pentru datele de afișare.

**Câmpuri pentru biomarkeri individuali**

**biomarker\_id** `integer`

Identificatorul biomarkerului — corelează cu
[Listează biomarkerii](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md) cu `home_kit=true`.

**added\_at** `string`

Marcajul temporal ISO 8601 al momentului în care biomarkerul a fost atașat prima dată la această comandă de kit de testare la domiciliu.

**shipments** `HomeKitOrderShipmentLink[]` *required*

Coletele asociate acestei comenzi de kit de testare la domiciliu, începând cu cea mai veche asociere — de obicei kitul către pacient
și proba înapoi la laborator. Gol până când centrul de expediere tipărește o etichetă. Citește
coletele complete cu [Listare expedieri](https://docs.anivahealth.com/ro/api/shipments/list-shipments.md) și `?home_kit_order_id=`.

**Câmpuri pentru asocierea expedierii**

**id** `string`

Referința expedierii — corelează cu [Obține expedierea](https://docs.anivahealth.com/ro/api/shipments/get-shipment.md).

**added\_at** `string`

Marcajul temporal ISO 8601 al momentului în care expedierea a fost asociată acestei comenzi de kit de testare la domiciliu.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Eroare de validare — de ex., format UUID invalid sau un câmp lipsă în `delivery_address`. |
| `403` | Interzis — cheia ta API nu are acces la această operațiune, comanda de kit de testare la domiciliu nu intră în permisiunile tale sau ai setat `results_ready_emails` fără acces `results_view` la pacient. |
| `404` | Comanda de kit de testare la domiciliu nu a fost găsită sau panelul din `panel_id` nu există. |
| `409` | Conflict — comanda nu mai este `pending`; adresa și panelul pot fi modificate doar înainte de expediere. |
| `409` | Conflict — comanda este un kit de înlocuire, care păstrează panelul comenzii pe care o înlocuiește. |
| `409` | Conflict — comanda este `cancelled` și ai trimis `results_ready_emails`. |
| `422` | Panelul nu poate fi comandat ca kit de testare la domiciliu — nu este configurat niciun produs de kit pentru expediere. |
| `500` | Eroare internă de server. |

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "delivery_address": {
      "name": "Maria Schmidt",
      "street": "Unter den Linden",
      "house_number": "77",
      "postal_code": "10117",
      "city": "Berlin",
      "country_code": "DE",
      "phone": "+4930123456789",
      "email": "maria.schmidt@example.com"
    }
  }'
```

```json 200 theme={null}
{
  "id": "d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "status": "pending",
  "delivery_address": {
    "name": "Maria Schmidt",
    "street": "Unter den Linden",
    "house_number": "77",
    "postal_code": "10117",
    "city": "Berlin",
    "country_code": "DE",
    "phone": "+4930123456789",
    "email": "maria.schmidt@example.com"
  },
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": "2026-04-01T13:10:00Z",
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-04-01T09:50:00Z"
    }
  ],
  "individual_biomarkers": [],
  "metadata": { "your_order_ref": "ORD-10482" },
  "replaces_home_kit_order_id": null,
  "replacement_reason": null,
  "results_ready_emails": [],
  "lab_code": null,
  "activated_at": null,
  "shipments": []
}
```

```json 400 theme={null}
{
  "error": "delivery_address: Invalid input"
}
```

```json 409 theme={null}
{
  "error": "Panels and biomarkers can only be changed while the home kit order is pending. Once it is dispatched, activated, or cancelled its composition is locked."
}
```

```json 404 theme={null}
{
  "error": "Home kit order not found"
}
```


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