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

# Sendung stornieren

> Einen Versandauftrag stornieren

Storniere einen Versandauftrag. Dabei wird die API des Logistikanbieters aufgerufen, um den Auftrag zu stornieren, und der Sendungsstatus wird auf `cancelled` aktualisiert.

Das Stornieren einer Sendung, die bereits den Status `cancelled` hat, gibt `200` mit dieser Sendung zurück, und der Anbieter wird nur einmal aufgerufen. Die Antwort enthält `Idempotent-Replayed: true`, damit du eine Wiederholung von dem Aufruf unterscheiden kannst, der die Aktion ausgeführt hat. Siehe [Idempotenz](https://docs.anivahealth.com/de/concepts/idempotency.md).

> [!WARNING]
>
> Sendungen können nach der Abholung nicht mehr storniert werden – das gibt `409 Conflict` zurück.

Ein DHL-Retourenlabel kann nicht einzeln storniert werden; das gibt ebenfalls `409 Conflict` zurück. Storniere
stattdessen das ausgehende Paket. Beim Stornieren eines ausgehenden DHL-Pakets werden auch seine
Rücksende-Einträge mit dem Status `pending` storniert. Jeder davon erhält den Status `cancelled` mit einem
`RETURN_LEG_CANCELLED`-Eintrag in `status_updates`. Siehe
[Retourenlabels](https://docs.anivahealth.com/de/concepts/shipments.md#retourenlabels).

In einem Karton mit mehreren Kits hat jedes Kit einen eigenen Versand-Eintrag und ein eigenes Retourenlabel, selbst
wenn der Karton mit dem Label eines einzelnen Kits verschickt wird. Das Stornieren des Versand-Eintrags eines Kits storniert auch das
Retourenlabel dieses Kits.

Um ein Home-Kit-Paket zu stornieren, muss jede verknüpfte Home-Kit-Bestellung in deinem Zugriffskontext liegen.
Andernfalls gibt der Aufruf `403` zurück. Siehe [Zugriff](https://docs.anivahealth.com/de/concepts/shipments.md#zugriff).

## Anfrage

### Pfadparameter

**id** `string` *required*

Referenz-ID der Sendung (z. B. `P2611194821`).

## Antwort

Bei Erfolg gibt die API `200 OK` mit dem stornierten Sendungsobjekt zurück.

**id** `string` *required*

Referenz-ID der Sendung.

**status** `string` *required*

Status im Sendungslebenszyklus. Ist nach einer erfolgreichen Stornierung `cancelled`.

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

Logistikanbieter. Einer der Werte `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` oder `dhl_express`. Ein Home-Kit-Paket ist `dhl_parcel` oder `dhl_warenpost`, wenn es als
Warenpost International ins Ausland geht.

**tracking\_number** `string`

Externe Sendungsnummer des Logistikanbieters. Kann `null` sein.

**contents** `string`

Freitextbeschreibung des Paketinhalts, wie bei der Erstellung angegeben. Kann `null` sein.

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

Wer das Label gedruckt hat: `aniva` oder `external`. Nur `aniva`-Sendungen akzeptieren diesen Aufruf.

**paired\_with** `string`

Referenz des anderen Pakets bei einer Sendung mit zwei Paketen. `null` bei einem einfachen Paket.

**origin** `object`

Abholadresse. Kann `null` sein.

**Adressobjekt**

**name** `string` *required*

Empfänger-, Firmen- oder Standortname.

**company\_name** `string`

Firma / c/o-Zeile. Kann `null` sein.

**street** `string` *required*

Straßenname ohne Hausnummer.

**house\_number** `string`

Hausnummer. Kann `null` sein.

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

Gebäude, Eingang oder Etage. Kann `null` sein.

**city** `string` *required*

Stadt.

**state** `string`

Bundesland oder Provinz. Kann `null` sein.

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

Postleitzahl.

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

Ländercode nach ISO 3166-1 alpha-2.

**phone** `string`

Kontakt-Telefonnummer. Kann `null` sein.

**email** `string`

Kontakt-E-Mail-Adresse. Kann `null` sein.

**destination** `object`

Lieferadresse. Gleiche Struktur wie `origin`. Kann `null` sein.

**pickup** `object`

Geplantes Abholzeitfenster. Kann `null` sein.

**pickup-Objekt**

**from** `string` *required*

Beginn des Abholzeitfensters als UTC-Zeitpunkt (ISO 8601 mit `Z`-Suffix).

**till** `string` *required*

Ende des Abholzeitfensters als UTC-Zeitpunkt (ISO 8601 mit `Z`-Suffix).

**timezone** `string` *required*

IANA-Zeitzone des Abholstandorts (z. B. `Europe/Berlin`).

**notes** `string`

Optionale Notizen. Kann `null` sein.

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

Chronologische Statusereignisse des Logistikanbieters (ältestes zuerst). Jeder Eintrag enthält
`state`, `code`, `detail_code`, `status`, `description`, `location` und `time`. Siehe [Sendung
abrufen](https://docs.anivahealth.com/de/api/shipments/get-shipment.md) für die einzelnen Felder. Leeres Array, wenn noch keine Ereignisse vorliegen.

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

Termine, die vor der Stornierung mit dieser Sendung verknüpft waren. Jeder Eintrag hat die Form
`{ id, added_at }`; gleiche jede `id` über
[Termin abrufen](https://docs.anivahealth.com/de/api/appointments/get-appointment.md) ab.
Es werden nur Termine in deinem Zugriffskontext aufgeführt.

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

Home-Kit-Bestellungen, die mit dieser Sendung verknüpft sind (älteste Verknüpfung zuerst), in derselben Form `{ id, added_at }`.
Es werden nur Bestellungen in deinem Zugriffskontext aufgeführt. Leeres Array bei Praxispaketen.

**synced\_at** `string`

Zeitpunkt des letzten Abgleichs der Sendung mit dem Versanddienstleister als UTC-Zeitpunkt. `null` bis zur ersten
Synchronisierung.

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

Erstellungszeitstempel (ISO 8601).

**updated\_at** `string`

Zeitstempel der letzten Aktualisierung (ISO 8601). Kann `null` sein.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Ungültiges ID-Format. |
| `403` | Zugriff verweigert – dein API-Key hat keinen Zugriff auf diesen Vorgang, die Sendung liegt außerhalb deines Zugriffskontexts oder eine verknüpfte Home-Kit-Bestellung liegt außerhalb deines Zugriffskontexts. |
| `404` | Sendung nicht gefunden. |
| `409` | Sendung kann nicht storniert werden – sie wurde bereits abgeholt oder zugestellt, oder es handelt sich um ein DHL-Rücksendeetikett (storniere stattdessen das ausgehende Paket). |
| `501` | Die Sendung ist `external` – sie wurde nicht über Aniva gebucht und kann hier nicht storniert werden. |
| `500` | Interner Serverfehler. |
| `502` | Der Logistikanbieter hat die Anfrage abgelehnt (z. B. Stornierungsfrist überschritten). Enthält die Fehlermeldung des Anbieters. |

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