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

# Uppdatera försändelse

> Ändra försändelseuppgifter före upphämtning

Uppdatera uppgifter för försändelsen, såsom upphämtningsschema, antal paket eller anteckningar. Om några logistikrelevanta fält ändras (upphämtningsdatum, tid, antal paket eller vikt) avbokas den befintliga logistikordern och en ny skapas automatiskt. Fält som du utelämnar behålls från den befintliga försändelsen. Uppdaterade schemafält valideras mot [reglerna för upphämtningsschema](https://docs.anivahealth.com/sv/concepts/shipments.md#regler-foer-upphaemtningsschema).

> [!WARNING]
>
> Försändelser kan inte ändras efter upphämtning. Försök att uppdatera en försändelse som redan har
> hämtats upp returnerar `409 Conflict`.

Ett paket med hemtestkit har redan sin etikett utskriven, så bara `notes` kan ändras. Ett nytt upphämtningsfönster
eller en ny vikt på ett paket med hemtestkit returnerar `409 Conflict`; avboka det och skapa en ny försändelse istället.

För att uppdatera ett paket med hemtestkit måste varje kopplad beställning av hemtestkit ingå i din åtkomstkontext.
Annars returnerar anropet `403`. Se [Åtkomst](https://docs.anivahealth.com/sv/concepts/shipments.md#atkomst).

## Förfrågan

### Sökvägsparametrar

**id** `string` *required*

Försändelsens referens-ID (t.ex. `P2611194821`).

### Body-parametrar

Alla body-parametrar är valfria – ta bara med de fält du vill ändra.

**pickup\_date** `string`

Nytt upphämtningsdatum i formatet `YYYY-MM-DD`, tolkat i avsändarplatsens tidszon.

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

Ny tidigaste upphämtningstid i formatet `HH:MM`, tolkad som lokalt klockslag i
avsändarplatsens tidszon.

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

Ny senaste upphämtningstid i formatet `HH:MM`, tolkad som lokalt klockslag i
avsändarplatsens tidszon.

**package\_count** `integer`

Nytt antal paket.

**weight** `number`

Ny vikt i kg.

**notes** `string`

Nya anteckningar eller anmärkningar. Max 128 tecken.

## Svar

Vid lyckat anrop returnerar API:et `200 OK` med den uppdaterade försändelsen.

**id** `string` *required*

Försändelsens referensidentifierare.

**status** `string` *required*

Försändelsens livscykelstatus. Ett av `pending`, `in_transit`, `delivered`, `fault` eller `cancelled`.

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

Logistikleverantör. Ett av `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` eller `dhl_express`. Ett paket med hemtestkit använder `dhl_parcel`, eller `dhl_warenpost` när det skickas utomlands
som Warenpost International.

**tracking\_number** `string`

Externt spårningsnummer från logistikleverantören. Kan vara `null`.

**contents** `string`

Fritextbeskrivning av paketets innehåll, som angavs vid skapandet. Kan vara `null`.

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

Vem som skrev ut etiketten: `aniva` eller `external`. Bara `aniva`-försändelser accepterar det här anropet.

**paired\_with** `string`

Referens till det andra paketet i en sändning med två paket. `null` för ett enkelriktat paket.

**origin** `object`

Upphämtningsadress. Kan vara `null`.

**adressobjekt**

**name** `string` *required*

Mottagare, företag eller platsnamn.

**company\_name** `string`

Företag / c/o-rad. Kan vara `null`.

**street** `string` *required*

Gatunamn utan husnummer.

**house\_number** `string`

Husnummer. Kan vara `null`.

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

Byggnad, port eller våning. Kan vara `null`.

**city** `string` *required*

Stad.

**state** `string`

Delstat eller provins. Kan vara `null`.

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

Postnummer.

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

Landskod enligt ISO 3166-1 alpha-2.

**phone** `string`

Telefonnummer för kontakt. Kan vara `null`.

**email** `string`

E-postadress för kontakt. Kan vara `null`.

**destination** `object`

Leveransadress. Samma struktur som `origin`. Kan vara `null`.

**pickup** `object`

Schemalagt upphämtningsfönster. Kan vara `null`.

**pickup-objekt**

**from** `string` *required*

Start på upphämtningsfönstret som en UTC-tidpunkt (ISO 8601 med `Z`-suffix).

**till** `string` *required*

Slut på upphämtningsfönstret som en UTC-tidpunkt (ISO 8601 med `Z`-suffix).

**timezone** `string` *required*

IANA-tidszon för upphämtningsplatsen (t.ex. `Europe/Berlin`). Använd för att visa `from` / `till` i upphämtningsplatsens lokala tid.

**notes** `string`

Valfria anteckningar. Kan vara `null`.

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

Kronologiska livscykelhändelser från logistikleverantören (äldsta först). Varje post har
`state`, `code`, `detail_code`, `status`, `description`, `location` och `time`. Se [Hämta
försändelse](https://docs.anivahealth.com/sv/api/shipments/get-shipment.md) för respektive fält. Tom array om inga händelser har observerats ännu.

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

Bokningar kopplade till denna försändelse, äldsta kopplingen först. Varje post är `{ id, added_at }`;
slå upp varje `id` med [Hämta bokning](https://docs.anivahealth.com/sv/api/appointments/get-appointment.md).
Endast bokningarna i din åtkomstkontext listas.

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

Beställningar av hemtestkit som är kopplade till den här försändelsen, äldsta kopplingen först, med samma `{ id, added_at }`-struktur.
Endast beställningarna i din åtkomstkontext listas. Tom array för paket från mottagningar.

**synced\_at** `string`

När försändelsen senast stämdes av mot sin transportör, som en UTC-tidpunkt. `null` fram till den första
synkroniseringen.

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

Tidsstämpel för skapande (ISO 8601).

**updated\_at** `string`

Tidsstämpel för senaste uppdatering (ISO 8601). Kan vara `null`.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Valideringsfel – t.ex. ogiltigt datum- eller tidsformat. |
| `403` | Förbjuden – din API-nyckel har inte åtkomst till den här åtgärden, försändelsen ligger utanför din åtkomstkontext eller en kopplad hemkitbeställning ligger utanför din åtkomstkontext. |
| `404` | Försändelsen hittades inte. |
| `409` | Försändelsen kan inte ändras efter upphämtning, eller så är det ett hemkitpaket med utskriven etikett och begäran ändrar mer än `notes`. |
| `501` | Försändelsen är `external` – den bokades inte via Aniva och kan inte ändras här. |
| `500` | Internt serverfel. |
| `502` | Logistikleverantören avvisade begäran (t.ex. misslyckades avbokning eller nyskapande). Inkluderar leverantörens felmeddelande. |

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