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

# Anuluj przesyłkę

> Anuluj zlecenie przesyłki

Anuluj zlecenie przesyłki. Wywołuje API dostawcy logistycznego w celu anulowania zlecenia i zmienia status przesyłki na `cancelled`.

Anulowanie przesyłki, która ma już status `cancelled`, zwraca `200` z tą przesyłką, a dostawca jest wywoływany tylko raz. Odpowiedź zawiera `Idempotent-Replayed: true`, dzięki czemu odróżnisz powtórzenie od wywołania, które faktycznie wykonało operację. Zobacz [Idempotencja](https://docs.anivahealth.com/pl/concepts/idempotency.md).

> [!WARNING]
>
> Przesyłek nie można anulować po odbiorze — takie żądanie zwraca `409 Conflict`.

Etykiety zwrotnej DHL nie można anulować osobno; to również zwraca `409 Conflict`. Zamiast tego anuluj
paczkę wychodzącą. Anulowanie wychodzącej paczki DHL anuluje też jej wiersze zwrotne o statusie
`pending`. Każdy z nich dostaje status `cancelled` z wpisem `RETURN_LEG_CANCELLED` w `status_updates`. Zobacz
[Etykiety zwrotne](https://docs.anivahealth.com/pl/concepts/shipments.md#etykiety-zwrotne).

W pudełku z kilkoma zestawami każdy zestaw ma własny wiersz wychodzący i własną etykietę zwrotną, nawet
gdy pudełko jest wysyłane na etykiecie jednego z zestawów. Anulowanie wiersza wychodzącego danego zestawu anuluje też jego
etykietę zwrotną.

Aby anulować paczkę z zestawem domowym, każde powiązane zamówienie zestawu domowego musi znajdować się w twoim kontekście dostępu.
W przeciwnym razie żądanie 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`).

## Odpowiedź

W przypadku powodzenia API zwraca `200 OK` wraz z obiektem anulowanej przesyłki.

**id** `string` *required*

Identyfikator referencyjny przesyłki.

**status** `string` *required*

Status cyklu życia przesyłki. Po pomyślnym anulowaniu będzie miał wartość `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`).

**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, które były powiązane z tą przesyłką przed anulowaniem. Każdy wpis ma format
`{ id, added_at }`; każde `id` sprawdź w
[Pobierz wizytę](https://docs.anivahealth.com/pl/api/appointments/get-appointment.md).
Na liście znajdują się 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` | Nieprawidłowy format ID. |
| `403` | Brak dostępu — twój klucz API nie ma uprawnień do tej operacji, przesyłka znajduje się poza twoim kontekstem dostępu albo powiązane zamówienie zestawu domowego jest poza twoim kontekstem dostępu. |
| `404` | Nie znaleziono przesyłki. |
| `409` | Nie można anulować przesyłki — została już odebrana lub dostarczona albo jest etykietą zwrotną DHL (zamiast tego anuluj paczkę wychodzącą). |
| `501` | Przesyłka jest oznaczona jako `external` — nie została zamówiona przez Aniva i nie można jej tutaj anulować. |
| `500` | Wewnętrzny błąd serwera. |
| `502` | Dostawca logistyczny odrzucił żądanie (np. przekroczono termin anulowania). Zawiera komunikat błędu od dostawcy. |

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