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

# Profiluri

> Cum funcționează profilurile de pacienți în Aniva Partner API: creează, actualizează și asociază persoanele pentru care programezi analize de sânge și comanzi kituri de testare la domiciliu.

Un profil este o înregistrare care reprezintă un pacient sau un utilizator în sistemul Aniva. Fiecare programare, comandă de laborator și rezultat se asociază cu un profil.

## Grupuri de profiluri

Când creezi un profil, îl atribui unui **grup de profiluri** folosind parametrul `profile_group`. Un grup de profiluri organizează profilurile în contul tău de partener, asociindu-le unui anumit program sau unei anumite integrări.

Câmpul `profile_group` acceptă fie UUID-ul imuabil al grupului, fie slug-ul său ușor de citit. UUID-ul este referința stabilă — nu se schimbă niciodată și rămâne valabil și după redenumirea slug-ului. Slug-ul este destinat URL-urilor ușor de citit și integrărilor cu partenerii.

O valoare `profile_group` (UUID sau slug) este obligatorie la creare. Câmpul vechi `profile_group_slug` rămâne acceptat ca alias învechit.

## Câmpuri

**id** `string` *required*

UUID generat automat de Aniva. Folosește-l pentru a face referire la profil în alte apeluri API.

**handle** `string`

Un nume de utilizator sau handle opțional pentru profil. Poate fi null.

**first\_name** `string`

Prenumele pacientului. Doar caractere latine, 1–100 de caractere. Obligatoriu la creare.

**last\_name** `string`

Numele de familie al pacientului. Doar caractere latine, 1–100 de caractere. Obligatoriu la creare — laboratoarele
resping comenzile pentru un pacient fără nume de familie. Poate fi null pentru profilurile create înainte să devină obligatoriu.

**email** `string`

Adresa de e-mail a pacientului. Dacă nu furnizezi una la creare, Aniva generează automat o adresă
de e-mail de înlocuire.

**phone** `string`

Număr de telefon în [format E.164](https://www.itu.int/rec/T-REC-E.164/en) (de ex., `+14155552671`). Poate
fi null.

**sex** `integer`

Sexul biologic conform [ISO/IEC 5218](https://www.iso.org/standard/36266.html): `1` = masculin, `2` =
feminin. Obligatoriu la creare, cu excepția cazului în care grupul tău de profiluri permite pacientului să îl introducă (vezi mai jos).
Laboratorul are nevoie de el pentru intervalele de referință, deci o creare sau o actualizare cu `0` (necunoscut)
returnează `400`. Profilurile create înainte de 30 septembrie 2026 pot returna în continuare `0`.

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

Data nașterii în format `YYYY-MM-DD`. Obligatorie la creare, cu excepția cazului în care grupul tău de profiluri permite
pacientului să o introducă (vezi mai jos). Trebuie să fie în trecut, nu înainte de 1900, și să corespundă unei vârste între 16
și 100 de ani; valorile neverosimile sunt respinse cu `400`. Data nașterii este trimisă la laborator pe
comandă și nu poate fi modificată după plasarea comenzii.

**height** `number`

Înălțimea în centimetri. Poate fi null.

**weight** `number`

Greutatea în kilograme. Poate fi null.

**language** `string`

Limba preferată pentru comunicările către pacient. Valori acceptate: `en`, `de`, `fi`.

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

Indică dacă profilul primește e-mailuri tranzacționale, precum confirmările de programare și
notificările când rezultatele sunt gata. Separat de acordul pentru marketing. Null dacă nu a fost setat niciodată.

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

Marcaj temporal ISO 8601 al momentului în care a fost creat profilul.

**updated\_at** `string`

Marcaj temporal ISO 8601 al celei mai recente actualizări. Null dacă profilul nu a fost actualizat niciodată.

> [!NOTE]
>
> Câmpurile `first_name`, `last_name`, `sex`, `date_of_birth` și `profile_group` sunt obligatorii
> la crearea unui profil. Toate celelalte câmpuri sunt opționale. Câmpul vechi `profile_group_slug` este
> încă acceptat ca alias învechit pentru `profile_group`.

### Permite pacientului să introducă data nașterii și sexul

Putem activa o setare pentru grupul tău de profiluri. Astfel, poți crea un profil fără
`date_of_birth` și `sex`. Cere-ne să o activăm. Fără ea, o creare care omite oricare dintre cele două câmpuri
returnează `400`.

Pacientul le introduce pe ambele pe pagina de activare a kitului (`anivahealth.com/activate`), împreună cu codul
kitului. Pagina cere data nașterii de două ori, deoarece laboratorul nu o poate modifica ulterior. După
aceea, kitul se deschide doar cu acea dată a nașterii. Până când pacientul le introduce pe ambele, reținem
comanda de laborator. Folosește această setare doar pentru kituri de testare la domiciliu.

## Ciclul de viață

Profilurile urmează un ciclu de viață simplu:

1. **Creează** — înregistrează profilul cu câmpurile demografice obligatorii și un `profile_group` (UUID
   sau slug).
2. **Actualizează** (opțional) — adaugă sau modifică câmpuri precum `phone`, `height` sau `weight`.
3. **Asociază** — leagă profilul de programări folosind `id`-ul său ca `profile_id`.

Un [webhook](https://docs.anivahealth.com/ro/concepts/webhooks.md) `profile.*` te anunță când apare, se modifică sau este șters un profil.

## Exemplu de profil

```json theme={null}
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "handle": "jdoe42",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "jane.doe@example.com",
  "phone": "+14155552671",
  "sex": 2,
  "date_of_birth": "1990-06-15",
  "height": 168.0,
  "weight": 65.0,
  "language": "en",
  "transactional_emails_enabled": true,
  "created_at": "2026-03-01T09:00:00Z",
  "updated_at": "2026-03-10T14:32:00Z"
}
```


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