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

# Skapa försändelse

> Skapa en försändelseorder för logistik med angivet ursprung och angiven destination

Skapa en försändelseorder från den angivna avsändarplatsen. Du anger mottagande laboratorium med `destination_lab`. Försändelsen skickas till det laboratoriets registrerade leveransadress.

Kräver scope `shipments_manage`.

Skicka med en valfri `Idempotency-Key`-header så att anropet säkert kan upprepas – om samma nyckel skickas igen returneras det ursprungliga svaret i stället för att en andra bokning skapas. Se [Idempotens](https://docs.anivahealth.com/sv/concepts/idempotency.md).

## Förfrågan

### Body-parametrar

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

UUID för avsändande testplats. Platsen måste vara aktiv och ligga inom din API-nyckels åtkomstkontext.
Använd [Lista platser](https://docs.anivahealth.com/sv/api/locations/list-locations.md) för att hitta tillgängliga plats-ID:n.

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

Mottagande laboratorium. Ett av `zotzklimas`, `labclinic`, `nordicgroup`, `biomes`, `imd` eller
`quade`. Försändelsen skickas till den leveransadress som är registrerad för det här laboratoriet. Ett laboratorium
utan registrerad leveransadress returnerar `400`.

**appointment\_id** `string`

Valfritt UUID för bokning att koppla till den här försändelsen när den skapas. Bokningen måste
ligga inom din API-nyckels åtkomstkontext. Kopplingen visas direkt som en post i försändelsens
`appointments`-array, och omvänt som en post i bokningens `shipments`-array. För att koppla
ytterligare bokningar efter skapandet, eller ta bort den ursprungliga kopplingen, använder du [Koppla bokningar till
försändelse](https://docs.anivahealth.com/sv/api/shipments/attach-appointments-to-shipment.md) och [Koppla bort bokningar från
försändelse](https://docs.anivahealth.com/sv/api/shipments/detach-appointments-from-shipment.md).

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

Upphämtningsdatum i formatet `YYYY-MM-DD` (t.ex. `2026-04-15`), tolkat i avsändarplatsens
tidszon. Måste vara en vardag (måndag–fredag), i dag eller i framtiden. Upphämtning samma dag är inte
tillgänglig efter 16:00 Europe/Berlin.

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

Tidigaste upphämtningstid i formatet `HH:MM` (t.ex. `09:00`), tolkat som lokal tid i
avsändarplatsens tidszon. Måste vara mellan `09:00` och `19:00`.

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

Senaste upphämtningstid i formatet `HH:MM` (t.ex. `12:00`), tolkat som lokal tid i avsändarplatsens
tidszon. Måste vara mellan `09:00` och `19:00`. Tidsfönstret (`pickup_time_till -
    pickup_time_from`) måste vara minst 2 timmar.

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

Antal paket. Standardvärdet är `1`.

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

Vikt i kg. Standardvärdet är `0.5`.

**pickup\_remarks** `string`

Instruktioner till budet vid upphämtning (avsändarens anmärkningar). Om fältet utelämnas används
upphämtningsadressens sparade anmärkningar (eller inga om adressen saknar sådana). Högst 128 tecken.

**contents** `string`

Fritextbeskrivning av paketets innehåll som visas för budet och returneras som
`contents`. Högst 40 tecken (t.ex. `Medizinisch freigestellte Probe`).

**notes** `string`

Valfria interna anteckningar. Högst 128 tecken.

## Svar

Vid lyckat anrop returnerar API:et `201 Created` med den nya försändelsen.

**id** `string` *required*

Referens-ID för försändelsen (t.ex. `P2604151234`).

**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`. En försändelse du skapar får `aniva`.

**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 direkt efter skapandet.
Bakgrundssynkroniseringen lägger till händelser allt eftersom leverantören rapporterar dem.

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

Bokningar kopplade till den här försändelsen, äldsta kopplingen först. Varje post är `{ id, added_at }`;
stäm av varje `id` mot [Hämta bokning](https://docs.anivahealth.com/sv/api/appointments/get-appointment.md).
Innehåller bokningen som angavs via `appointment_id` (om någon) direkt efter skapandet.

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

Beställningar av hemtestkit som är kopplade till den här försändelsen, med samma `{ id, added_at }`-struktur. Tom array för en
försändelse du skapar.

**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 datumformat, helgdatum, för snävt upphämtningsfönster eller passerad tidsgräns för upphämtning samma dag. Returneras även när `destination_lab` eller avsändarplatsen saknar registrerad adress. |
| `403` | Förbjudet — din API-nyckel har inte åtkomst till den här åtgärden eller så ligger platsen utanför din åtkomstkontext. |
| `404` | Platsen hittades inte eller är inaktiv, eller så angavs `appointment_id` men bokningen finns inte. |
| `409` | `Idempotency-Key` har redan använts med en annan begäranskropp, eller så har den ursprungliga begäran ännu inte slutförts. |
| `500` | Internt serverfel. |
| `502` | Logistikleverantören avvisade begäran. Innehåller leverantörens felmeddelande. |

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