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

# Anulează expedierea

> Anulează o comandă de expediere

Anulează o comandă de expediere. Acest apel contactează API-ul furnizorului de logistică pentru a anula comanda și actualizează statusul expedierii la `cancelled`.

Anularea unei expedieri care are deja statusul `cancelled` returnează `200` cu acea expediere, iar furnizorul este apelat o singură dată. Răspunsul include `Idempotent-Replayed: true`, astfel încât să poți distinge o repetare de apelul care a efectuat acțiunea. Vezi [Idempotență](https://docs.anivahealth.com/ro/concepts/idempotency.md).

> [!WARNING]
>
> Expedierile nu pot fi anulate după ridicare — în acest caz se returnează `409 Conflict`.

O etichetă de retur DHL nu poate fi anulată separat; și acest lucru returnează `409 Conflict`. Anulează
coletul de dus în schimb. Anularea unui colet DHL de dus anulează și înregistrările sale de retur aflate
în starea `pending`. Fiecare devine `cancelled` cu o intrare `RETURN_LEG_CANCELLED` în `status_updates`. Vezi
[Etichete de retur](https://docs.anivahealth.com/ro/concepts/shipments.md#etichete-de-retur).

Într-o cutie cu mai multe kituri, fiecare kit are propria înregistrare de dus și propria etichetă de retur, chiar
dacă cutia circulă cu eticheta unui singur kit. Anularea înregistrării de dus a unui kit anulează și
eticheta de retur a acelui kit.

Pentru a anula un colet cu kit pentru acasă, fiecare comandă asociată de kit pentru acasă 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`).

## Răspuns

În caz de succes, API-ul returnează `200 OK` cu obiectul expedierii anulate.

**id** `string` *required*

Identificatorul de referință al expedierii.

**status** `string` *required*

Statusul ciclului de viață al expedierii. Va fi `cancelled` după o anulare reușită.

**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`).

**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 care au fost asociate cu această expediere înainte de anulare. Fiecare intrare are forma
`{ id, added_at }`; verifică fiecare `id` prin
[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` | Format invalid al ID-ului. |
| `403` | Interzis — cheia ta API nu are acces la această operațiune, expedierea se află în afara contextului tău de acces sau o comandă de kit pentru acasă asociată se află în afara contextului tău de acces. |
| `404` | Expedierea nu a fost găsită. |
| `409` | Expedierea nu poate fi anulată — a fost deja ridicată sau livrată, ori este o etichetă de retur DHL (anulează în schimb coletul expediat). |
| `501` | Expedierea este `external` — nu a fost rezervată prin Aniva și nu poate fi anulată aici. |
| `500` | Eroare internă de server. |
| `502` | Furnizorul de logistică a respins cererea (de ex., termenul-limită de anulare a fost depășit). Include mesajul de eroare al furnizorului. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/shipments/P2611194821 \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "id": "P2611194821",
  "status": "cancelled",
  "logistics_provider": "go",
  "tracking_number": "GO1234567890",
  "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-15T07:00:00Z",
    "till": "2026-04-15T10: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-03T16:45:00Z"
}
```

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

```json 409 (return label) theme={null}
{
  "error": "Shipment K260904P3XD is the return label of K2609041FQ7. DHL cannot cancel a return label on its own. Cancel the outbound parcel while it is pending. After the outbound parcel ships, the label stays valid and Aniva closes this shipment manually."
}
```

```json 403 (Aniva-managed parcel) theme={null}
{
  "error": "Access denied: only Aniva can change this parcel."
}
```

```json 404 theme={null}
{
  "error": "Shipment not found"
}
```

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