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

# Oppdater forsendelse

> Endre forsendelsesdetaljer før henting

Oppdater forsendelsesdetaljer som hentetidspunkt, antall pakker eller notater. Hvis logistikkrelevante felter endres (hentedato, klokkeslett, antall pakker eller vekt), kanselleres den eksisterende logistikkordren og en ny opprettes automatisk. Felter du utelater, beholdes fra den eksisterende forsendelsen. Oppdaterte felter for hentetidspunkt valideres mot [reglene for hentetidspunkt](https://docs.anivahealth.com/no/concepts/shipments.md#regler-for-hentetidspunkt).

> [!WARNING]
>
> Forsendelser kan ikke endres etter henting. Forsøk på å oppdatere en forsendelse som allerede er
> hentet, returnerer `409 Conflict`.

En pakke med hjemmetestsett har allerede en utskrevet etikett, så bare `notes` kan endres. Et nytt hentevindu
eller ny vekt på en pakke med hjemmetestsett returnerer `409 Conflict`; kanseller den og opprett en ny forsendelse i stedet.

For å oppdatere en pakke med hjemmetestsett må hver tilknyttede bestilling av hjemmetestsett være i din tilgangskontekst.
Ellers returnerer kallet `403`. Se [Tilgang](https://docs.anivahealth.com/no/concepts/shipments.md#tilgang).

## Forespørsel

### Stiparametere

**id** `string` *required*

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

### Body-parametere

Alle body-parametere er valgfrie – ta bare med feltene du vil endre.

**pickup\_date** `string`

Ny hentedato i `YYYY-MM-DD`-format, tolket i avsenderstedets tidssone.

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

Nytt tidligste hentetidspunkt i `HH:MM`-format, tolket som lokal klokketid i avsenderstedets
tidssone.

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

Nytt seneste hentetidspunkt i `HH:MM`-format, tolket som lokal klokketid i avsenderstedets
tidssone.

**package\_count** `integer`

Nytt antall pakker.

**weight** `number`

Ny vekt i kg.

**notes** `string`

Nye notater eller merknader. Maksimalt 128 tegn.

## Respons

Ved suksess returnerer API-et `200 OK` med den oppdaterte forsendelsen.

**id** `string` *required*

Referanseidentifikator for forsendelsen.

**status** `string` *required*

Livssyklusstatus for forsendelsen. En av `pending`, `in_transit`, `delivered`, `fault` eller
`cancelled`.

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

Logistikkleverandør. Én av `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` eller `dhl_express`. En hjemmesettpakke er `dhl_parcel`, eller `dhl_warenpost` når den sendes utenlands
som Warenpost International.

**tracking\_number** `string`

Eksternt sporingsnummer fra logistikkleverandøren. Kan være `null`.

**contents** `string`

Fritekstbeskrivelse av hva som er i pakken, slik den ble oppgitt ved opprettelse. Kan være `null`.

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

Hvem som skrev ut etiketten: `aniva` eller `external`. Bare `aniva`-forsendelser godtar dette kallet.

**paired\_with** `string`

Referanse til den andre pakken i en sending med to pakker. `null` for en enveispakke.

**origin** `object`

Henteadresse. Kan være `null`.

**adresseobjekt**

**name** `string` *required*

Navn på mottaker, selskap eller sted.

**company\_name** `string`

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

**street** `string` *required*

Gatenavn, uten husnummer.

**house\_number** `string`

Husnummer. Kan være `null`.

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

Bygning, inngang eller etasje. 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-landskode.

**phone** `string`

Kontakttelefonnummer. Kan være `null`.

**email** `string`

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

**destination** `object`

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

**pickup** `object`

Planlagt hentevindu. Kan være `null`.

**pickup-objekt**

**from** `string` *required*

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

**till** `string` *required*

Slutt på hentevinduet som UTC-tidspunkt (ISO 8601 med `Z`-suffiks).

**timezone** `string` *required*

IANA-tidssone for hentestedet (f.eks. `Europe/Berlin`). Brukes til å vise `from` / `till` i hentestedets lokale klokketid.

**notes** `string`

Valgfrie notater. Kan være `null`.

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

Kronologiske livssyklushendelser fra logistikkleverandøren (eldste først). Hver oppføring har
`state`, `code`, `detail_code`, `status`, `description`, `location` og `time`. Se [Hent
forsendelse](https://docs.anivahealth.com/no/api/shipments/get-shipment.md) for hvert felt. Tom liste hvis ingen hendelser er
registrert ennå.

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

Timer knyttet til denne forsendelsen, med eldste kobling først. Hver oppføring er `{ id, added_at }`;
slå opp hver `id` i [Hent time](https://docs.anivahealth.com/no/api/appointments/get-appointment.md).
Bare timene i din tilgangskontekst vises.

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

Hjemmetestbestillinger koblet til denne forsendelsen, eldste kobling først, med samme
`{ id, added_at }`-struktur. Bare bestillingene i tilgangskonteksten din vises. Tom liste for
pakker fra praksiser.

**synced\_at** `string`

Når forsendelsen sist ble avstemt med transportøren, som et UTC-tidspunkt. `null` frem til
første synkronisering.

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

Tidsstempel for opprettelse (ISO 8601).

**updated\_at** `string`

Tidsstempel for siste oppdatering (ISO 8601). Kan være `null`.

## Feilresponser

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfeil – f.eks. ugyldig dato- eller tidsformat. |
| `403` | Ingen tilgang – API-nøkkelen din har ikke tilgang til denne operasjonen, forsendelsen er utenfor tilgangskonteksten din, eller en koblet bestilling av hjemmesett er utenfor tilgangskonteksten din. |
| `404` | Forsendelsen ble ikke funnet. |
| `409` | Forsendelsen kan ikke endres etter henting, eller det er en pakke med hjemmesett der etiketten er skrevet ut, og forespørselen endrer mer enn `notes`. |
| `501` | Forsendelsen er `external` – den ble ikke bestilt gjennom Aniva og kan ikke endres her. |
| `500` | Intern serverfeil. |
| `502` | Logistikkleverandøren avviste forespørselen (f.eks. avbestilling eller ny oppretting feilet). Inkluderer leverandørens feilmelding. |

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