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

# Opdater forsendelse

> Rediger forsendelsesoplysninger før afhentning

Opdater forsendelsesoplysninger som afhentningstidspunkt, antal pakker eller noter. Hvis logistikrelevante felter ændres (afhentningsdato, tidspunkt, antal pakker eller vægt), annulleres den eksisterende logistikordre, og der oprettes automatisk en ny. Felter, du udelader, bevares fra den eksisterende forsendelse. Opdaterede felter for afhentningstidspunkt valideres mod [reglerne for afhentningstidspunkter](https://docs.anivahealth.com/da/concepts/shipments.md#regler-for-afhentningstidspunkt).

> [!WARNING]
>
> Forsendelser kan ikke ændres efter afhentning. Forsøg på at opdatere en forsendelse, der allerede er
> afhentet, returnerer `409 Conflict`.

En hjemmetestkitpakke har allerede fået udskrevet sin label, så kun `notes` kan ændres. Et nyt afhentningsvindue
eller en ny vægt på en hjemmetestkitpakke returnerer `409 Conflict`; annuller den, og opret en ny forsendelse i stedet.

For at opdatere en hjemmetestkitpakke skal alle tilknyttede hjemmetestkitordrer 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`).

### Body-parametre

Alle body-parametre er valgfri — inkluder kun de felter, du vil ændre.

**pickup\_date** `string`

Ny afhentningsdato i formatet `YYYY-MM-DD`, fortolket i afsendelsesstedets tidszone.

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

Nyt tidligste afhentningstidspunkt i formatet `HH:MM`, fortolket som lokalt klokkeslæt i
afsendelsesstedets tidszone.

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

Nyt seneste afhentningstidspunkt i formatet `HH:MM`, fortolket som lokalt klokkeslæt i afsendelsesstedets
tidszone.

**package\_count** `integer`

Nyt antal pakker.

**weight** `number`

Ny vægt i kg.

**notes** `string`

Nye noter eller bemærkninger. Maksimalt 128 tegn.

## Svar

Ved succes returnerer API'et `200 OK` med den opdaterede forsendelse.

**id** `string` *required*

Forsendelsens reference-id.

**status** `string` *required*

Forsendelsens livscyklusstatus. En af `pending`, `in_transit`, `delivered`, `fault` eller `cancelled`.

**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`). Bruges til at vise `from` / `till` i afhentningsstedets lokale tid.

**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 tilknyttet denne forsendelse, med den ældste tilknytning først. Hvert element er `{ id, added_at }`;
slå hvert `id` op i [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` | Valideringsfejl – f.eks. ugyldigt dato- eller tidsformat. |
| `403` | Forbudt – din API-nøgle har ikke adgang til denne handling, forsendelsen ligger uden for din adgangskontekst, eller en tilknyttet hjemmekitordre ligger uden for din adgangskontekst. |
| `404` | Forsendelse ikke fundet. |
| `409` | Forsendelsen kan ikke ændres efter afhentning, eller det er en hjemmekitpakke, hvis pakkelabel er udskrevet, og forespørgslen ændrer mere end `notes`. |
| `501` | Forsendelsen er `external` – den blev ikke booket gennem Aniva og kan ikke ændres her. |
| `500` | Intern serverfejl. |
| `502` | Logistikudbyderen afviste forespørgslen (f.eks. mislykkedes annullering eller genoprettelse). Inkluderer udbyderens fejlmeddelelse. |

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