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

# Szállítmány lemondása

> Szállítási megbízás lemondása

Mondj le egy szállítási rendelést. Ez meghívja a logisztikai szolgáltató API-ját a rendelés lemondásához, és `cancelled` értékre frissíti a küldemény státuszát.

Egy már `cancelled` státuszú küldemény lemondása `200`-at ad vissza az adott küldeménnyel, és a szolgáltatót csak egyszer hívja meg. A válaszban szerepel az `Idempotent-Replayed: true`, így meg tudod különböztetni az ismétlést a műveletet ténylegesen elvégző hívástól. Lásd: [Idempotencia](https://docs.anivahealth.com/hu/concepts/idempotency.md).

> [!WARNING]
>
> A küldemények a felvétel után már nem mondhatók le – ez `409 Conflict` hibát ad vissza.

Egy DHL-visszaküldési címke önmagában nem mondható le; ez szintén `409 Conflict` hibát ad vissza. Ehelyett mondd le
a kimenő csomagot. Egy kimenő DHL-csomag lemondása a hozzá tartozó `pending` visszaküldési
sorokat is lemondja. Mindegyik `cancelled` státuszú lesz, és egy `RETURN_LEG_CANCELLED` bejegyzés kerül a `status_updates` mezőbe. Lásd:
[Visszaküldési címkék](https://docs.anivahealth.com/hu/concepts/shipments.md#visszakueldesi-cimkek).

Egy több tesztkészletet tartalmazó dobozban minden készletnek saját kimenő sora és saját visszaküldési címkéje van, még
akkor is, ha a doboz egyetlen készlet címkéjével utazik. Egy készlet kimenő sorának lemondása az adott készlet
visszaküldési címkéjét is lemondja.

Egy otthoni tesztkészlet-csomag lemondásához minden kapcsolódó otthoni tesztkészlet-rendelésnek a hozzáférési kontextusodban kell lennie.
Ellenkező esetben a hívás `403`-at ad vissza. Lásd: [Hozzáférés](https://docs.anivahealth.com/hu/concepts/shipments.md#hozzaferes).

## Kérés

### Útvonalparaméterek

**id** `string` *required*

A küldemény hivatkozási azonosítója (pl. `P2611194821`).

## Válasz

Sikeres kérés esetén az API `200 OK` választ ad vissza a lemondott küldemény objektummal.

**id** `string` *required*

A küldemény referenciaazonosítója.

**status** `string` *required*

A küldemény életciklus-státusza. Sikeres lemondás után `cancelled` lesz.

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

Logisztikai szolgáltató. Lehetséges értékei: `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` vagy `dhl_express`. Az otthoni tesztkészlet-csomag `dhl_parcel`, illetve `dhl_warenpost`, ha külföldre megy
Warenpost International küldeményként.

**tracking\_number** `string`

A logisztikai szolgáltatótól kapott külső csomagkövetési szám. Lehet `null`.

**contents** `string`

A csomag tartalmának szabad szöveges leírása, ahogyan a létrehozáskor megadták. Lehet `null`.

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

Ki nyomtatta a címkét: `aniva` vagy `external`. Csak az `aniva` küldemények fogadják el ezt a hívást.

**paired\_with** `string`

A kétcsomagos szállítmány másik csomagjának referenciája. Egyirányú csomagnál `null`.

**origin** `object`

Felvételi cím. Lehet `null`.

**cím objektum**

**name** `string` *required*

Címzett, cég vagy helyszín neve.

**company\_name** `string`

Cég / c/o sor. Lehet `null`.

**street** `string` *required*

Utcanév, házszám nélkül.

**house\_number** `string`

Házszám. Lehet `null`.

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

Épület, lépcsőház vagy emelet. Lehet `null`.

**city** `string` *required*

Város.

**state** `string`

Állam vagy tartomány. Lehet `null`.

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

Irányítószám.

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

ISO 3166-1 alpha-2 országkód.

**phone** `string`

Kapcsolattartó telefonszáma. Lehet `null`.

**email** `string`

Kapcsolattartó e-mail-címe. Lehet `null`.

**destination** `object`

Kézbesítési cím. Ugyanolyan szerkezetű, mint az `origin`. Lehet `null`.

**pickup** `object`

Ütemezett felvételi időablak. Lehet `null`.

**pickup objektum**

**from** `string` *required*

A felvételi időablak kezdete UTC időpillanatként (ISO 8601, `Z` utótaggal).

**till** `string` *required*

A felvételi időablak vége UTC időpillanatként (ISO 8601, `Z` utótaggal).

**timezone** `string` *required*

A felvétel helyszínének IANA időzónája (pl. `Europe/Berlin`).

**notes** `string`

Opcionális megjegyzések. Lehet `null`.

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

A logisztikai szolgáltató időrendi életciklus-eseményei (a legrégebbitől kezdve). Minden elem
tartalmazza a `state`, `code`, `detail_code`, `status`, `description`, `location` és `time` mezőket. Az egyes mezőket lásd a [Küldemény
lekérdezése](https://docs.anivahealth.com/hu/api/shipments/get-shipment.md) oldalon. Üres tömb, ha még nem érkezett esemény.

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

A lemondás előtt ehhez a küldeményhez kapcsolt időpontok. Minden elem
`{ id, added_at }` formátumú; az egyes `id` értékeket az
[Időpont lekérdezése](https://docs.anivahealth.com/hu/api/appointments/get-appointment.md) végponttal vetheted össze.
Csak a hozzáférési körödbe tartozó időpontok szerepelnek a listában.

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

Az ehhez a küldeményhez kapcsolt otthoni tesztkészlet-rendelések, a legrégebben kapcsolttól kezdve, ugyanabban az `{ id, added_at }` szerkezetben.
Csak a hozzáférési körödbe tartozó rendelések szerepelnek a listában. Rendelői csomagok esetén üres tömb.

**synced\_at** `string`

Mikor történt a küldemény utolsó egyeztetése a futárszolgálattal, UTC időpillanatként. Az első
szinkronizálásig `null`.

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

Létrehozási időbélyeg (ISO 8601).

**updated\_at** `string`

Utolsó frissítés időbélyege (ISO 8601). Lehet `null`.

## Hibaválaszok

| Státusz | Leírás |
| - | - |
| `400` | Érvénytelen azonosítóformátum. |
| `403` | Tiltott — az API-kulcsod nem rendelkezik hozzáféréssel ehhez a művelethez, a küldemény a hozzáférési körödön kívül esik, vagy egy kapcsolt otthoni tesztkészlet-rendelés a hozzáférési körödön kívül esik. |
| `404` | A küldemény nem található. |
| `409` | A küldemény nem mondható le — már felvették vagy kézbesítették, vagy DHL-visszaküldési címke (helyette a kimenő csomagot mondd le). |
| `501` | A küldemény `external` típusú — nem az Aniva rendszerén keresztül rendelték meg, ezért itt nem mondható le. |
| `500` | Belső szerverhiba. |
| `502` | A logisztikai szolgáltató elutasította a kérést (pl. lejárt a lemondási határidő). Tartalmazza a szolgáltató hibaüzenetét. |

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