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

# Annuller forsendelse

> Annuller en forsendelsesordre

Annuller en forsendelsesordre. Dette kalder logistikudbyderens API for at annullere ordren og opdaterer forsendelsesstatus til `cancelled`.

Hvis du annullerer en forsendelse, der allerede er `cancelled`, returneres `200` med den pågældende forsendelse, og udbyderen kaldes kun én gang. Svaret indeholder `Idempotent-Replayed: true`, så du kan skelne en gentagelse fra det kald, der udførte handlingen. Se [Idempotens](https://docs.anivahealth.com/da/concepts/idempotency.md).

> [!WARNING]
>
> Forsendelser kan ikke annulleres efter afhentning – det returnerer `409 Conflict`.

En DHL-returlabel kan ikke annulleres alene; det returnerer også `409 Conflict`. Annuller den
udgående pakke i stedet. Når du annullerer en udgående DHL-pakke, annulleres dens `pending`
returrækker også. Hver af dem bliver `cancelled` med en `RETURN_LEG_CANCELLED`-post i `status_updates`. Se
[Returlabels](https://docs.anivahealth.com/da/concepts/shipments.md#returlabels).

I en kasse med flere kits har hvert kit sin egen udgående række og sin egen returlabel, selv
når kassen sendes på ét kits label. Når du annullerer et kits udgående række, annulleres også dette kits
returlabel.

For at annullere en hjemmekit-pakke skal hver tilknyttet hjemmekit-ordre være i din adgangskontekst.
Ellers returnerer kaldet `403`. Se [Adgang](https://docs.anivahealth.com/da/concepts/shipments.md#adgang).

## Forespørgsel

### Stiparametre

**id** `string` *required*

Forsendelsens reference-ID (f.eks. `P2611194821`).

## Svar

Ved succes returnerer API'et `200 OK` med det annullerede forsendelsesobjekt.

**id** `string` *required*

Forsendelsens reference-id.

**status** `string` *required*

Forsendelsens livscyklusstatus. Vil være `cancelled` efter en vellykket annullering.

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

Logistikudbyder. En af `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` eller `dhl_express`. En hjemmekit-pakke er `dhl_parcel`, eller `dhl_warenpost`, når den sendes til udlandet
som Warenpost International.

**tracking\_number** `string`

Eksternt sporingsnummer fra logistikudbyderen. Kan være `null`.

**contents** `string`

Fritekstbeskrivelse af pakkens indhold, som angivet ved oprettelsen. Kan være `null`.

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

Hvem der udskrev labelen: `aniva` eller `external`. Kun `aniva`-forsendelser accepterer dette kald.

**paired\_with** `string`

Reference til den anden pakke i en forsendelse med to pakker. `null` for en enkeltvejspakke.

**origin** `object`

Afhentningsadresse. Kan være `null`.

**adresseobjekt**

**name** `string` *required*

Navn på modtager, virksomhed eller sted.

**company\_name** `string`

Virksomheds- / c/o-linje. Kan være `null`.

**street** `string` *required*

Vejnavn uden husnummer.

**house\_number** `string`

Husnummer. Kan være `null`.

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

Bygning, opgang eller etage. Kan være `null`.

**city** `string` *required*

By.

**state** `string`

Delstat eller provins. Kan være `null`.

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

Postnummer.

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

ISO 3166-1 alpha-2-landekode.

**phone** `string`

Kontakttelefonnummer. Kan være `null`.

**email** `string`

Kontakt-e-mail. Kan være `null`.

**destination** `object`

Leveringsadresse. Samme struktur som `origin`. Kan være `null`.

**pickup** `object`

Planlagt afhentningstidsrum. Kan være `null`.

**pickup-objekt**

**from** `string` *required*

Start på afhentningstidsrummet som UTC-tidspunkt (ISO 8601 med `Z`-suffiks).

**till** `string` *required*

Slut på afhentningstidsrummet som UTC-tidspunkt (ISO 8601 med `Z`-suffiks).

**timezone** `string` *required*

IANA-tidszone for afhentningsstedet (f.eks. `Europe/Berlin`).

**notes** `string`

Valgfrie noter. Kan være `null`.

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

Kronologiske livscyklushændelser fra logistikudbyderen (ældste først). Hver post har
`state`, `code`, `detail_code`, `status`, `description`, `location` og `time`. Se [Hent
forsendelse](https://docs.anivahealth.com/da/api/shipments/get-shipment.md) for hvert felt. Tomt array, hvis der endnu ikke er registreret hændelser.

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

Tider, der var tilknyttet denne forsendelse før annullering. Hver post er
`{ id, added_at }`; slå hvert `id` op via
[Hent tid](https://docs.anivahealth.com/da/api/appointments/get-appointment.md).
Kun tider i din adgangskontekst vises.

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

Hjemmetestordrer tilknyttet denne forsendelse, ældste tilknytning først, i samme `{ id, added_at }`-format.
Kun ordrer i din adgangskontekst vises. Tomt array for praksispakker.

**synced\_at** `string`

Hvornår forsendelsen sidst blev afstemt med fragtfirmaet, som UTC-tidspunkt. `null` indtil første
synkronisering.

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

Tidsstempel for oprettelse (ISO 8601).

**updated\_at** `string`

Tidsstempel for seneste opdatering (ISO 8601). Kan være `null`.

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | Ugyldigt id-format. |
| `403` | Forbudt — din API-nøgle har ikke adgang til denne handling, forsendelsen er uden for din adgangskontekst, eller en tilknyttet hjemmetestordre er uden for din adgangskontekst. |
| `404` | Forsendelse ikke fundet. |
| `409` | Forsendelsen kan ikke annulleres — den er allerede afhentet eller leveret, eller det er en DHL-returlabel (annullér i stedet den udgående pakke). |
| `501` | Forsendelsen er `external` — den blev ikke booket gennem Aniva og kan ikke annulleres her. |
| `500` | Intern serverfejl. |
| `502` | Logistikudbyderen afviste anmodningen (f.eks. hvis annulleringsfristen er overskredet). Indeholder udbyderens fejlmeddelelse. |

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