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

# Opret forsendelse

> Opret en logistikforsendelsesordre med angivet afsendelsessted og destination

Opret en forsendelsesordre fra den angivne afsenderlokation. Du angiver modtagerlaboratoriet med `destination_lab`. Forsendelsen sendes til laboratoriets registrerede forsendelsesadresse.

Kræver scopet `shipments_manage`.

Send en valgfri `Idempotency-Key`-header for at gøre denne oprettelse sikker at prøve igen — gentages den samme nøgle, returneres det oprindelige svar i stedet for at oprette endnu en. Se [Idempotens](https://docs.anivahealth.com/da/concepts/idempotency.md).

## Forespørgsel

### Body-parametre

**location\_id** `string` *required*

UUID for afsendende testlokation. Lokationen skal være aktiv og inden for din API-nøgles adgangskontekst.
Brug [Vis lokationer](https://docs.anivahealth.com/da/api/locations/list-locations.md) til at finde tilgængelige lokations-id'er.

**destination\_lab** `string` *required*

Modtagerlaboratorium. En af `zotzklimas`, `labclinic`, `nordicgroup`, `biomes`, `imd` eller
`quade`. Forsendelsen sendes til den forsendelsesadresse, der er registreret for dette laboratorium. Et laboratorium
uden en registreret forsendelsesadresse returnerer `400`.

**appointment\_id** `string`

Valgfri UUID for en tid, som denne forsendelse skal tilknyttes ved oprettelse. Tiden skal være
inden for din API-nøgles adgangskontekst. Tilknytningen vises direkte som en post i forsendelsens
`appointments`-array og omvendt som en post i tidens `shipments`-array. For at tilknytte
flere tider efter oprettelse eller fjerne den første tilknytning skal du bruge [Tilknyt tider til
forsendelse](https://docs.anivahealth.com/da/api/shipments/attach-appointments-to-shipment.md) og [Fjern tider fra
forsendelse](https://docs.anivahealth.com/da/api/shipments/detach-appointments-from-shipment.md).

**pickup\_date** `string` *required*

Afhentningsdato i `YYYY-MM-DD`-format (f.eks. `2026-04-15`), fortolket i afsenderlokationens
tidszone. Skal være en hverdag (mandag–fredag), i dag eller i fremtiden. Afhentning samme dag er ikke
mulig efter kl. 16:00 Europe/Berlin.

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

Tidligste afhentningstidspunkt i `HH:MM`-format (f.eks. `09:00`), fortolket som lokalt klokkeslæt i
afsenderlokationens tidszone. Skal være mellem `09:00` og `19:00`.

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

Seneste afhentningstidspunkt i `HH:MM`-format (f.eks. `12:00`), fortolket som lokalt klokkeslæt i
afsenderlokationens tidszone. Skal være mellem `09:00` og `19:00`. Tidsrummet (`pickup_time_till -
    pickup_time_from`) skal være mindst 2 timer.

**package\_count** `integer` (default: 1)

Antal pakker. Standard er `1`.

**weight** `number` (default: 0.5)

Vægt i kg. Standard er `0.5`.

**pickup\_remarks** `string`

Instruktioner til kureren ved afhentning (afsenderbemærkninger). Hvis feltet udelades, bruges
afhentningsadressens gemte bemærkninger (eller ingen, hvis adressen ikke har nogen). Maksimalt 128 tegn.

**contents** `string`

Fritekstbeskrivelse af pakkens indhold, som vises til kureren og returneres som
`contents`. Maksimalt 40 tegn (f.eks. `Medizinisch freigestellte Probe`).

**notes** `string`

Valgfrie interne noter. Maksimalt 128 tegn.

## Svar

Ved succes returnerer API'et `201 Created` med den nye forsendelse.

**id** `string` *required*

Reference-id for forsendelsen (f.eks. `P2604151234`).

**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 pakkelabelen: `aniva` eller `external`. En forsendelse, du opretter, er `aniva`.

**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 lige efter oprettelse.
Baggrundssynkroniseringen tilføjer hændelser, efterhånden som udbyderen rapporterer dem.

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

Tider tilknyttet denne forsendelse, ældste tilknytning først. Hver post er `{ id, added_at }`;
slå hvert `id` op via [Hent tid](https://docs.anivahealth.com/da/api/appointments/get-appointment.md).
Indeholder den tid, der eventuelt blev sendt via `appointment_id`, lige efter oprettelse.

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

Hjemmetestordrer tilknyttet denne forsendelse i samme `{ id, added_at }`-format. Tomt array for en
forsendelse, du opretter.

**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 datoformat, weekenddato, for kort afhentningstidsrum eller overskredet frist for afhentning samme dag. Returneres også, når `destination_lab` eller afsenderlokationen ikke har nogen registreret adresse. |
| `403` | Forbudt — din API-nøgle har ikke adgang til denne handling, eller lokationen er uden for din adgangskontekst. |
| `404` | Lokationen blev ikke fundet eller er inaktiv, eller `appointment_id` blev angivet, men tiden findes ikke. |
| `409` | `Idempotency-Key` blev allerede brugt med et andet anmodningsindhold, eller den oprindelige anmodning er endnu ikke afsluttet. |
| `500` | Intern serverfejl. |
| `502` | Logistikudbyderen afviste anmodningen. Indeholder udbyderens fejlmeddelelse. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/shipments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "destination_lab": "labclinic",
    "appointment_id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
    "pickup_date": "2026-04-15",
    "pickup_time_from": "09:00",
    "pickup_time_till": "12:00",
    "notes": "Handle with care — temperature-sensitive samples"
  }'
```

```json 201 theme={null}
{
  "id": "P2611194821",
  "status": "pending",
  "logistics_provider": "go",
  "tracking_number": null,
  "contents": null,
  "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": "Handle with care — temperature-sensitive samples",
  "status_updates": [],
  "appointments": [
    {
      "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
      "added_at": "2026-04-15T07:00:00Z"
    }
  ],
  "home_kit_orders": [],
  "synced_at": null,
  "created_at": "2026-04-15T07:00:00Z",
  "updated_at": null
}
```

```json 400 theme={null}
{
  "error": "pickup_date must be a weekday (Monday–Friday)"
}
```

```json 404 theme={null}
{
  "error": "Location not found or inactive"
}
```

```json 502 theme={null}
{
  "error": "Logistics provider error: Pickup on weekend/holiday not possible",
  "logistics_error_code": 2001
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.