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

# Opprett forsendelse

> Opprett en ordre for logistikkforsendelse med angitt opprinnelse og destinasjon

Opprett en forsendelsesordre fra det angitte avsenderstedet. Du oppgir mottakerlaboratoriet med `destination_lab`. Forsendelsen sendes til laboratoriets registrerte leveringsadresse.

Krever tilgangsomfanget `shipments_manage`.

Send en valgfri `Idempotency-Key`-header for å gjøre denne opprettelsen trygg å prøve på nytt — hvis samme nøkkel sendes igjen, returneres det opprinnelige svaret i stedet for å opprette en til. Se [Idempotens](https://docs.anivahealth.com/no/concepts/idempotency.md).

## Forespørsel

### Body-parametere

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

UUID for avsendende teststed. Stedet må være aktivt og innenfor API-nøkkelens tilgangskontekst.
Bruk [Vis steder](https://docs.anivahealth.com/no/api/locations/list-locations.md) for å finne tilgjengelige steds-ID-er.

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

Mottakerlaboratorium. En av `zotzklimas`, `labclinic`, `nordicgroup`, `biomes`, `imd` eller
`quade`. Forsendelsen sendes til leveringsadressen som er registrert for dette laboratoriet. Et
laboratorium uten registrert leveringsadresse returnerer `400`.

**appointment\_id** `string`

Valgfri time-UUID som forsendelsen kobles til ved opprettelse. Timen må være innenfor
API-nøkkelens tilgangskontekst. Koblingen vises direkte som en oppføring i forsendelsens
`appointments`-liste, og tilsvarende som en oppføring i timens `shipments`-liste. For å koble
til flere timer etter opprettelse, eller fjerne den opprinnelige koblingen, bruker du [Koble
timer til forsendelse](https://docs.anivahealth.com/no/api/shipments/attach-appointments-to-shipment.md) og [Fjern timer fra
forsendelse](https://docs.anivahealth.com/no/api/shipments/detach-appointments-from-shipment.md).

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

Hentedato i formatet `YYYY-MM-DD` (f.eks. `2026-04-15`), tolket i avsenderstedets tidssone. Må
være en ukedag (mandag–fredag), i dag eller frem i tid. Henting samme dag er ikke tilgjengelig
etter 16:00 Europe/Berlin.

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

Tidligste hentetidspunkt i formatet `HH:MM` (f.eks. `09:00`), tolket som lokal klokketid i
avsenderstedets tidssone. Må være mellom `09:00` og `19:00`.

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

Seneste hentetidspunkt i formatet `HH:MM` (f.eks. `12:00`), tolket som lokal klokketid i
avsenderstedets tidssone. Må være mellom `09:00` og `19:00`. Vinduet (`pickup_time_till -
    pickup_time_from`) må være minst 2 timer.

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

Antall pakker. Standard er `1`.

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

Vekt i kg. Standard er `0.5`.

**pickup\_remarks** `string`

Instruksjoner til budet ved henting (avsendermerknader). Hvis feltet utelates, brukes de lagrede
merknadene for henteadressen (eller ingen hvis adressen ikke har noen). Maks 128 tegn.

**contents** `string`

Fritekstbeskrivelse av innholdet i pakken, som vises til budet og returneres som `contents`.
Maks 40 tegn (f.eks. `Medizinisch freigestellte Probe`).

**notes** `string`

Valgfrie interne notater. Maks 128 tegn.

## Respons

Ved suksess returnerer API-et `201 Created` med den nye forsendelsen.

**id** `string` *required*

Referanse-ID for forsendelsen (f.eks. `P2604151234`).

**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`. En forsendelse du oppretter er `aniva`.

**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 rett etter opprettelse.
Bakgrunnssynkroniseringen legger til hendelser etter hvert som leverandøren rapporterer dem.

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

Timer koblet til denne forsendelsen, eldste kobling først. Hver oppføring er `{ id, added_at }`;
kryssreferer hver `id` mot [Hent time](https://docs.anivahealth.com/no/api/appointments/get-appointment.md).
Inneholder timen som ble sendt via `appointment_id` (hvis noen) rett etter opprettelse.

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

Hjemmetestbestillinger koblet til denne forsendelsen, med samme `{ id, added_at }`-struktur. Tom
liste for en forsendelse du oppretter.

**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 datoformat, helgedato, for kort hentevindu eller passert tidsfrist for henting samme dag. Returneres også når `destination_lab` eller avsenderstedet ikke har noen registrert adresse. |
| `403` | Ingen tilgang — API-nøkkelen din har ikke tilgang til denne operasjonen, eller stedet er utenfor tilgangskonteksten din. |
| `404` | Stedet ble ikke funnet eller er inaktivt, eller `appointment_id` ble oppgitt, men timen finnes ikke. |
| `409` | `Idempotency-Key` er allerede brukt med en annen forespørselskropp, eller den opprinnelige forespørselen er ikke fullført ennå. |
| `500` | Intern serverfeil. |
| `502` | Logistikkleverandøren avviste forespørselen. Inkluderer leverandørens feilmelding. |

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