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

> Sendungsdetails vor der Abholung ändern

Aktualisiere Sendungsdetails wie Abholzeitplan, Paketanzahl oder Notizen. Wenn sich logistikrelevante Felder ändern (Abholdatum, Uhrzeit, Paketanzahl oder Gewicht), wird der bestehende Logistikauftrag storniert und automatisch ein neuer erstellt. Weggelassene Felder werden von der bestehenden Sendung übernommen. Aktualisierte Zeitplanfelder werden anhand der [Regeln für den Abholzeitplan](https://docs.anivahealth.com/de/concepts/shipments.md#regeln-fuer-abholzeiten) geprüft.

> [!WARNING]
>
> Sendungen können nach der Abholung nicht mehr geändert werden. Der Versuch, eine bereits
> abgeholte Sendung zu aktualisieren, gibt `409 Conflict` zurück.

Ein Heimtest-Kit-Paket hat bereits ein gedrucktes Etikett, daher kann nur `notes` geändert werden. Ein neues Abholzeitfenster
oder Gewicht bei einem Heimtest-Kit-Paket gibt `409 Conflict` zurück; storniere es stattdessen und erstelle eine neue Sendung.

Um ein Heimtest-Kit-Paket zu aktualisieren, muss jede verknüpfte Heimtest-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`).

### Body-Parameter

Alle Body-Parameter sind optional – gib nur die Felder an, die du ändern möchtest.

**pickup\_date** `string`

Neues Abholdatum im Format `YYYY-MM-DD`, interpretiert in der Zeitzone des Abholorts.

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

Neue früheste Abholzeit im Format `HH:MM`, interpretiert als Ortszeit in der Zeitzone
des Abholorts.

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

Neue späteste Abholzeit im Format `HH:MM`, interpretiert als Ortszeit in der Zeitzone
des Abholorts.

**package\_count** `integer`

Neue Anzahl der Pakete.

**weight** `number`

Neues Gewicht in kg.

**notes** `string`

Neue Notizen oder Bemerkungen. Maximal 128 Zeichen.

## Antwort

Bei Erfolg gibt die API `200 OK` mit der aktualisierten Sendung zurück.

**id** `string` *required*

Referenz-ID der Sendung.

**status** `string` *required*

Status der Sendung. Einer der Werte `pending`, `in_transit`, `delivered`, `fault` oder `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`). Nutze sie, um `from` / `till` in der Ortszeit des Abholstandorts anzuzeigen.

**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*

Mit dieser Sendung verknüpfte Termine, älteste Verknüpfung zuerst. Jeder Eintrag hat die Form `{ id, added_at }`;
gleiche jede `id` mit [Termin abrufen](https://docs.anivahealth.com/de/api/appointments/get-appointment.md) ab.
Es werden nur die Termine in deinem Zugriffskontext aufgelistet.

**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` | Validierungsfehler – z. B. ungültiges Datums- oder Zeitformat. |
| `403` | Zugriff verweigert – dein API-Schlüssel hat keinen Zugriff auf diese Operation, die Sendung liegt außerhalb deines Zugriffskontexts oder eine verknüpfte Home-Kit-Bestellung liegt außerhalb deines Zugriffskontexts. |
| `404` | Sendung nicht gefunden. |
| `409` | Die Sendung kann nach der Abholung nicht geändert werden, oder es ist ein Home-Kit-Paket, dessen Etikett gedruckt ist, und die Anfrage ändert mehr als `notes`. |
| `501` | Die Sendung ist `external` – sie wurde nicht über Aniva gebucht und kann hier nicht geändert werden. |
| `500` | Interner Serverfehler. |
| `502` | Der Logistikanbieter hat die Anfrage abgelehnt (z. B. Stornierung oder Neuerstellung fehlgeschlagen). Enthält die Fehlermeldung des Anbieters. |

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