> ## 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ă expedierea

> Modifică detaliile expedierii înainte de ridicare

Actualizează detaliile expedierii, cum ar fi programul de preluare, numărul de colete sau observațiile. Dacă se modifică orice câmp relevant pentru logistică (data preluării, ora, numărul de colete sau greutatea), comanda logistică existentă este anulată și se creează automat una nouă. Câmpurile pe care le omiți se păstrează din expedierea existentă. Câmpurile actualizate ale programului sunt validate conform [regulilor privind programul de preluare](https://docs.anivahealth.com/ro/concepts/shipments.md#reguli-pentru-programul-de-ridicare).

> [!WARNING]
>
> Expedierile nu pot fi modificate după preluare. Încercarea de a actualiza o expediere care a fost
> deja preluată returnează `409 Conflict`.

Un colet cu kit de testare la domiciliu are deja eticheta tipărită, deci doar `notes` se poate modifica. Un nou interval de preluare
sau o nouă greutate pentru un colet cu kit de testare la domiciliu returnează `409 Conflict`; în schimb, anulează-l și creează o expediere nouă.

Pentru a actualiza un colet cu kit de testare la domiciliu, fiecare comandă de kit de testare la domiciliu asociată trebuie să fie în contextul tău de acces.
În caz contrar, apelul returnează `403`. Vezi [Acces](https://docs.anivahealth.com/ro/concepts/shipments.md#acces).

## Cerere

### Parametri de cale

**id** `string` *required*

ID-ul de referință al expedierii (de ex., `P2611194821`).

### Parametri de corp

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

**pickup\_date** `string`

Noua dată de preluare în format `YYYY-MM-DD`, interpretată în fusul orar al locației de origine.

**pickup\_time\_from** `string`

Noua oră minimă de preluare în format `HH:MM`, interpretată ca oră locală în fusul orar al locației
de origine.

**pickup\_time\_till** `string`

Noua oră maximă de preluare în format `HH:MM`, interpretată ca oră locală în fusul orar al locației
de origine.

**package\_count** `integer`

Noul număr de colete.

**weight** `number`

Noua greutate în kg.

**notes** `string`

Observații sau mențiuni noi. Maximum 128 de caractere.

## Răspuns

În caz de succes, API-ul returnează `200 OK` cu expedierea actualizată.

**id** `string` *required*

Identificatorul de referință al expedierii.

**status** `string` *required*

Starea expedierii în ciclul de viață. Una dintre valorile `pending`, `in_transit`, `delivered`, `fault` sau `cancelled`.

**logistics\_provider** `string` *required*

Furnizorul de logistică. Una dintre valorile `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` sau `dhl_express`. Un colet cu kit pentru acasă folosește `dhl_parcel` sau `dhl_warenpost` când pleacă în străinătate
ca Warenpost International.

**tracking\_number** `string`

Numărul extern de urmărire de la furnizorul de logistică. Poate fi `null`.

**contents** `string`

Descriere în text liber a conținutului coletului, așa cum a fost furnizată la creare. Poate fi `null`.

**booked\_by** `string` *required*

Cine a tipărit eticheta: `aniva` sau `external`. Doar expedierile `aniva` acceptă acest apel.

**paired\_with** `string`

Referința celuilalt colet dintr-o expediere cu două colete. `null` pentru un colet într-un singur sens.

**origin** `object`

Adresa de ridicare. Poate fi `null`.

**obiect adresă**

**name** `string` *required*

Numele destinatarului, al companiei sau al locației.

**company\_name** `string`

Linie companie / c/o. Poate fi `null`.

**street** `string` *required*

Numele străzii, fără numărul casei.

**house\_number** `string`

Numărul casei. Poate fi `null`.

**address\_line\_2** `string`

Bloc, scară sau etaj. Poate fi `null`.

**city** `string` *required*

Oraș.

**state** `string`

Stat sau provincie. Poate fi `null`.

**postal\_code** `string` *required*

Cod poștal.

**country\_code** `string` *required*

Cod de țară ISO 3166-1 alpha-2.

**phone** `string`

Număr de telefon de contact. Poate fi `null`.

**email** `string`

E-mail de contact. Poate fi `null`.

**destination** `object`

Adresa de livrare. Aceeași structură ca `origin`. Poate fi `null`.

**pickup** `object`

Intervalul programat de ridicare. Poate fi `null`.

**Obiectul pickup**

**from** `string` *required*

Începutul intervalului de ridicare ca moment UTC (ISO 8601 cu sufixul `Z`).

**till** `string` *required*

Sfârșitul intervalului de ridicare ca moment UTC (ISO 8601 cu sufixul `Z`).

**timezone** `string` *required*

Fusul orar IANA al locației de ridicare (de ex., `Europe/Berlin`). Folosește-l pentru a afișa `from` / `till` în ora locală a locației de ridicare.

**notes** `string`

Note opționale. Poate fi `null`.

**status\_updates** `object[]` *required*

Evenimente cronologice din ciclul de viață de la furnizorul de logistică (cele mai vechi primele). Fiecare intrare conține
`state`, `code`, `detail_code`, `status`, `description`, `location` și `time`. Vezi [Obține
expedierea](https://docs.anivahealth.com/ro/api/shipments/get-shipment.md) pentru fiecare câmp. Listă goală dacă nu s-au înregistrat încă evenimente.

**appointments** `ShipmentAppointmentLink[]` *required*

Programările asociate cu această expediere, în ordinea asocierii (cele mai vechi primele). Fiecare intrare este `{ id, added_at }`;
corelează fiecare `id` cu [Obține programarea](https://docs.anivahealth.com/ro/api/appointments/get-appointment.md).
Sunt listate doar programările din contextul tău de acces.

**home\_kit\_orders** `ShipmentHomeKitOrderLink[]` *required*

Comenzile de kituri pentru acasă asociate cu această expediere, de la cea mai veche asociere, în aceeași formă `{ id, added_at }`.
Sunt listate doar comenzile din contextul tău de acces. Listă goală pentru coletele de la cabinete.

**synced\_at** `string`

Momentul ultimei sincronizări a expedierii cu transportatorul, ca moment UTC. `null` până la prima
sincronizare.

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

Data și ora creării (ISO 8601).

**updated\_at** `string`

Data și ora ultimei actualizări (ISO 8601). Poate fi `null`.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Eroare de validare — de ex., format nevalid de dată sau oră. |
| `403` | Interzis — cheia ta API nu are acces la această operațiune, expedierea este în afara contextului tău de acces sau o comandă asociată de kit la domiciliu este în afara contextului tău de acces. |
| `404` | Expedierea nu a fost găsită. |
| `409` | Expedierea nu poate fi modificată după preluare sau este un colet de kit la domiciliu cu eticheta tipărită, iar cererea modifică mai mult decât `notes`. |
| `501` | Expedierea este `external` — nu a fost rezervată prin Aniva și nu poate fi modificată aici. |
| `500` | Eroare internă de server. |
| `502` | Furnizorul de logistică a respins cererea (de ex., anularea sau recrearea a eșuat). Include mesajul de eroare al furnizorului. |

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/shipments/P2611194821 \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "pickup_date": "2026-04-16",
    "pickup_time_from": "10:00",
    "pickup_time_till": "13:00"
  }'
```

```json 200 theme={null}
{
  "id": "P2611194821",
  "status": "pending",
  "logistics_provider": "go",
  "tracking_number": null,
  "contents": "Medizinisch freigestellte Probe",
  "booked_by": "aniva",
  "paired_with": null,
  "origin": {
    "name": "Aniva Berlin Mitte",
    "company_name": null,
    "street": "Unter den Linden",
    "house_number": "42",
    "address_line_2": null,
    "postal_code": "10117",
    "city": "Berlin",
    "state": null,
    "country_code": "DE",
    "phone": "+4930987654321",
    "email": "berlin-mitte@anivahealth.com"
  },
  "destination": {
    "name": "LabClinic GmbH",
    "company_name": null,
    "street": "Laborstraße",
    "house_number": "10",
    "address_line_2": null,
    "postal_code": "80331",
    "city": "München",
    "state": null,
    "country_code": "DE",
    "phone": null,
    "email": null
  },
  "pickup": {
    "from": "2026-04-16T08:00:00Z",
    "till": "2026-04-16T11:00:00Z",
    "timezone": "Europe/Berlin"
  },
  "notes": null,
  "status_updates": [],
  "appointments": [],
  "home_kit_orders": [],
  "synced_at": "2026-04-03T15:00:00Z",
  "created_at": "2026-04-03T14:30:00Z",
  "updated_at": "2026-04-03T15:10:00Z"
}
```

```json 409 theme={null}
{
  "error": "Shipment cannot be modified after pickup"
}
```

```json 502 theme={null}
{
  "error": "Logistics provider error: The cancellation notice period has already been exceeded. Cancellation is no longer possible via the web service. Please contact the GO! station.",
  "logistics_error_code": 4006
}
```


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