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

# Zaktualizuj przesyłkę

> Zmień szczegóły przesyłki przed odbiorem

Zaktualizuj szczegóły przesyłki, takie jak harmonogram odbioru, liczba paczek lub uwagi. Jeśli zmieni się którekolwiek pole istotne logistycznie (data odbioru, godzina, liczba paczek lub waga), dotychczasowe zlecenie logistyczne zostanie anulowane i automatycznie utworzy się nowe. Pominięte pola zachowają wartości z istniejącej przesyłki. Zaktualizowane pola harmonogramu są sprawdzane zgodnie z [zasadami harmonogramu odbioru](https://docs.anivahealth.com/pl/concepts/shipments.md#zasady-harmonogramu-odbioru).

> [!WARNING]
>
> Przesyłek nie można modyfikować po odbiorze. Próba aktualizacji przesyłki, która została już
> odebrana, zwraca `409 Conflict`.

Paczka z domowym zestawem testowym ma już wydrukowaną etykietę, więc zmienić można tylko `notes`. Nowe okno odbioru
lub waga dla paczki z domowym zestawem testowym zwraca `409 Conflict`; zamiast tego anuluj ją i utwórz nową przesyłkę.

Aby zaktualizować paczkę z domowym zestawem testowym, każde powiązane zamówienie domowego zestawu testowego musi być w twoim kontekście dostępu.
W przeciwnym razie wywołanie zwraca `403`. Zobacz [Dostęp](https://docs.anivahealth.com/pl/concepts/shipments.md#dostep).

## Żądanie

### Parametry ścieżki

**id** `string` *required*

Identyfikator referencyjny przesyłki (np. `P2611194821`).

### Parametry treści

Wszystkie parametry w treści żądania są opcjonalne — podaj tylko pola, które chcesz zmienić.

**pickup\_date** `string`

Nowa data odbioru w formacie `YYYY-MM-DD`, interpretowana w strefie czasowej miejsca nadania.

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

Nowa najwcześniejsza godzina odbioru w formacie `HH:MM`, interpretowana jako czas lokalny w strefie
czasowej miejsca nadania.

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

Nowa najpóźniejsza godzina odbioru w formacie `HH:MM`, interpretowana jako czas lokalny w strefie czasowej
miejsca nadania.

**package\_count** `integer`

Nowa liczba paczek.

**weight** `number`

Nowa waga w kg.

**notes** `string`

Nowe uwagi lub komentarze. Maksymalnie 128 znaków.

## Odpowiedź

W razie powodzenia API zwraca `200 OK` ze zaktualizowaną przesyłką.

**id** `string` *required*

Identyfikator referencyjny przesyłki.

**status** `string` *required*

Status cyklu życia przesyłki. Jedna z wartości: `pending`, `in_transit`, `delivered`, `fault` lub `cancelled`.

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

Dostawca logistyczny. Jedna z wartości: `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` lub `dhl_express`. Paczka z zestawem domowym ma wartość `dhl_parcel` albo `dhl_warenpost`, gdy jest wysyłana za granicę
jako Warenpost International.

**tracking\_number** `string`

Zewnętrzny numer śledzenia od dostawcy logistycznego. Może mieć wartość `null`.

**contents** `string`

Dowolny opis tekstowy zawartości paczki podany podczas tworzenia. Może mieć wartość `null`.

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

Kto wydrukował etykietę: `aniva` lub `external`. To wywołanie jest obsługiwane tylko dla przesyłek `aniva`.

**paired\_with** `string`

Numer referencyjny drugiej paczki w przesyłce dwupaczkowej. `null` w przypadku paczki w jedną stronę.

**origin** `object`

Adres odbioru. Może mieć wartość `null`.

**obiekt adresu**

**name** `string` *required*

Nazwa odbiorcy, firmy lub lokalizacji.

**company\_name** `string`

Firma / linia c/o. Może mieć wartość `null`.

**street** `string` *required*

Nazwa ulicy bez numeru domu.

**house\_number** `string`

Numer domu. Może mieć wartość `null`.

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

Budynek, wejście lub piętro. Może mieć wartość `null`.

**city** `string` *required*

Miasto.

**state** `string`

Stan lub województwo. Może mieć wartość `null`.

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

Kod pocztowy.

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

Kod kraju ISO 3166-1 alpha-2.

**phone** `string`

Kontaktowy numer telefonu. Może mieć wartość `null`.

**email** `string`

Kontaktowy adres e-mail. Może mieć wartość `null`.

**destination** `object`

Adres dostawy. Taka sama struktura jak `origin`. Może mieć wartość `null`.

**pickup** `object`

Zaplanowane okno odbioru. Może mieć wartość `null`.

**obiekt pickup**

**from** `string` *required*

Początek okna odbioru jako znacznik czasu UTC (ISO 8601 z przyrostkiem `Z`).

**till** `string` *required*

Koniec okna odbioru jako znacznik czasu UTC (ISO 8601 z przyrostkiem `Z`).

**timezone** `string` *required*

Strefa czasowa IANA miejsca odbioru (np. `Europe/Berlin`). Użyj jej, aby wyświetlić `from` / `till` w czasie lokalnym miejsca odbioru.

**notes** `string`

Opcjonalne notatki. Może mieć wartość `null`.

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

Chronologiczne zdarzenia z cyklu życia przesyłki od dostawcy logistycznego (od najstarszych). Każdy wpis ma pola
`state`, `code`, `detail_code`, `status`, `description`, `location` i `time`. Szczegóły każdego pola znajdziesz w [Pobierz
przesyłkę](https://docs.anivahealth.com/pl/api/shipments/get-shipment.md). Pusta tablica, jeśli nie odnotowano jeszcze żadnych zdarzeń.

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

Wizyty powiązane z tą przesyłką, od najstarszego powiązania. Każdy wpis ma postać `{ id, added_at }`;
każdy `id` sprawdź w [Pobierz wizytę](https://docs.anivahealth.com/pl/api/appointments/get-appointment.md).
Na liście są tylko wizyty w twoim kontekście dostępu.

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

Zamówienia zestawów domowych powiązane z tą przesyłką, od najstarszego powiązania, w tym samym formacie `{ id, added_at }`.
Na liście znajdują się tylko zamówienia w twoim kontekście dostępu. Pusta tablica dla paczek z gabinetów.

**synced\_at** `string`

Czas ostatniego uzgodnienia stanu przesyłki z przewoźnikiem jako znacznik czasu UTC. `null` do pierwszej
synchronizacji.

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

Znacznik czasu utworzenia (ISO 8601).

**updated\_at** `string`

Znacznik czasu ostatniej aktualizacji (ISO 8601). Może mieć wartość `null`.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Błąd walidacji — np. nieprawidłowy format daty lub godziny. |
| `403` | Zabronione — twój klucz API nie ma dostępu do tej operacji, przesyłka znajduje się poza twoim kontekstem dostępu lub powiązane zamówienie zestawu domowego znajduje się poza twoim kontekstem dostępu. |
| `404` | Nie znaleziono przesyłki. |
| `409` | Nie można zmienić przesyłki po odbiorze lub jest to paczka z zestawem domowym z wydrukowaną etykietą, a żądanie zmienia więcej niż `notes`. |
| `501` | Przesyłka jest typu `external` — nie została zamówiona przez Aniva i nie można jej tutaj zmienić. |
| `500` | Wewnętrzny błąd serwera. |
| `502` | Operator logistyczny odrzucił żądanie (np. anulowanie lub ponowne utworzenie nie powiodło się). Zawiera komunikat błędu od operatora. |

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