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

# Zending aanmaken

> Een logistieke verzendopdracht aanmaken met opgegeven herkomst en bestemming

Maak een verzendopdracht aan vanaf de opgegeven vertreklocatie. Je geeft het bestemmingslaboratorium op met `destination_lab`. De zending gaat naar het geregistreerde verzendadres van dat laboratorium.

Vereist de scope `shipments_manage`.

Stuur een optionele `Idempotency-Key`-header mee om het aanmaken veilig opnieuw te kunnen proberen — bij herhaling van dezelfde sleutel krijg je de oorspronkelijke respons terug in plaats van een tweede aan te maken. Zie [Idempotentie](https://docs.anivahealth.com/nl/concepts/idempotency.md).

## Verzoek

### Bodyparameters

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

UUID van de testlocatie van vertrek. De locatie moet actief zijn en binnen de toegangscontext van je API-sleutel vallen.
Gebruik [Locaties weergeven](https://docs.anivahealth.com/nl/api/locations/list-locations.md) om beschikbare locatie-ID's te vinden.

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

Bestemmingslaboratorium. Een van `zotzklimas`, `labclinic`, `nordicgroup`, `biomes`, `imd` of
`quade`. De zending gaat naar het verzendadres dat voor dit laboratorium is geregistreerd. Een laboratorium
zonder geregistreerd verzendadres retourneert `400`.

**appointment\_id** `string`

Optionele afspraak-UUID om deze zending bij het aanmaken aan te koppelen. De afspraak moet
binnen de toegangscontext van je API-sleutel vallen. De koppeling verschijnt inline als item in de
`appointments`-array van de zending, en omgekeerd als item in de `shipments`-array van de afspraak. Gebruik [Afspraken koppelen aan
zending](https://docs.anivahealth.com/nl/api/shipments/attach-appointments-to-shipment.md) en [Afspraken loskoppelen van
zending](https://docs.anivahealth.com/nl/api/shipments/detach-appointments-from-shipment.md) om na het aanmaken extra afspraken te koppelen of de oorspronkelijke koppeling te verwijderen.

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

Ophaaldatum in `YYYY-MM-DD`-indeling (bijv. `2026-04-15`), geïnterpreteerd in de tijdzone van de
vertreklocatie. Moet een werkdag zijn (maandag–vrijdag), vandaag of in de toekomst. Ophalen op dezelfde dag is niet
beschikbaar na 16:00 Europe/Berlin.

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

Vroegste ophaaltijd in `HH:MM`-indeling (bijv. `09:00`), geïnterpreteerd als lokale tijd in de
tijdzone van de vertreklocatie. Moet tussen `09:00` en `19:00` liggen.

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

Laatste ophaaltijd in `HH:MM`-indeling (bijv. `12:00`), geïnterpreteerd als lokale tijd in de tijdzone
van de vertreklocatie. Moet tussen `09:00` en `19:00` liggen. Het tijdvenster (`pickup_time_till -
    pickup_time_from`) moet minstens 2 uur zijn.

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

Aantal pakketten. Standaard `1`.

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

Gewicht in kg. Standaard `0.5`.

**pickup\_remarks** `string`

Instructies voor de koerier bij het ophalen (opmerkingen van de afzender). Als je dit weglaat, worden de
opgeslagen opmerkingen van het ophaaladres gebruikt (of geen, als het adres er geen heeft). Maximaal 128 tekens.

**contents** `string`

Vrije tekstbeschrijving van de inhoud van het pakket, getoond aan de koerier en teruggestuurd als
`contents`. Maximaal 40 tekens (bijv. `Medizinisch freigestellte Probe`).

**notes** `string`

Optionele interne notities. Maximaal 128 tekens.

## Respons

Bij succes retourneert de API `201 Created` met de nieuwe zending.

**id** `string` *required*

Referentie-ID van de zending (bijv. `P2604151234`).

**status** `string` *required*

Levenscyclusstatus van de zending. Een van `pending`, `in_transit`, `delivered`, `fault` of `cancelled`.

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

Vervoerder. Een van `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` of `dhl_express`. Een pakket met een thuistestkit is `dhl_parcel`, of `dhl_warenpost` wanneer het naar het buitenland gaat
als Warenpost International.

**tracking\_number** `string`

Extern trackingnummer van de vervoerder. Kan `null` zijn.

**contents** `string`

Vrije tekstbeschrijving van wat er in het pakket zit, zoals opgegeven bij het aanmaken. Kan `null` zijn.

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

Wie het label heeft afgedrukt: `aniva` of `external`. Een zending die je aanmaakt is `aniva`.

**paired\_with** `string`

Referentie van het andere pakket in een zending van twee pakketten. `null` voor een pakket in één richting.

**origin** `object`

Ophaaladres. Kan `null` zijn.

**adresobject**

**name** `string` *required*

Naam van ontvanger, bedrijf of locatie.

**company\_name** `string`

Bedrijf / p/a-regel. Kan `null` zijn.

**street** `string` *required*

Straatnaam, zonder huisnummer.

**house\_number** `string`

Huisnummer. Kan `null` zijn.

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

Gebouw, ingang of verdieping. Kan `null` zijn.

**city** `string` *required*

Plaats.

**state** `string`

Staat of provincie. Kan `null` zijn.

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

Postcode.

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

ISO 3166-1 alpha-2-landcode.

**phone** `string`

Telefoonnummer voor contact. Kan `null` zijn.

**email** `string`

E-mailadres voor contact. Kan `null` zijn.

**destination** `object`

Bezorgadres. Zelfde structuur als `origin`. Kan `null` zijn.

**pickup** `object`

Gepland ophaalvenster. Kan `null` zijn.

**pickup-object**

**from** `string` *required*

Begin van het ophaalvenster als UTC-tijdstip (ISO 8601 met `Z`-achtervoegsel).

**till** `string` *required*

Einde van het ophaalvenster als UTC-tijdstip (ISO 8601 met `Z`-achtervoegsel).

**timezone** `string` *required*

IANA-tijdzone van de ophaallocatie (bijv. `Europe/Berlin`). Gebruik deze om `from` / `till` weer te geven in de lokale tijd van de ophaallocatie.

**notes** `string`

Optionele notities. Kan `null` zijn.

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

Chronologische levenscyclusgebeurtenissen van de logistieke dienstverlener (oudste eerst). Elk item heeft een
`state`, `code`, `detail_code`, `status`, `description`, `location` en `time`. Zie [Zending
ophalen](https://docs.anivahealth.com/nl/api/shipments/get-shipment.md) voor elk veld. Lege array direct na het aanmaken.
De achtergrondsynchronisatie voegt gebeurtenissen toe zodra de dienstverlener ze meldt.

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

Afspraken gekoppeld aan deze zending, oudste koppeling eerst. Elk item is `{ id, added_at }`;
zoek elke `id` op via [Afspraak ophalen](https://docs.anivahealth.com/nl/api/appointments/get-appointment.md).
Bevat direct na het aanmaken de afspraak die via `appointment_id` is meegegeven (indien van toepassing).

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

Thuistestbestellingen gekoppeld aan deze zending, in dezelfde `{ id, added_at }`-structuur. Lege array voor een
zending die je aanmaakt.

**synced\_at** `string`

Wanneer de zending voor het laatst met de vervoerder is gesynchroniseerd, als UTC-tijdstip. `null` tot de eerste
synchronisatie.

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

Tijdstempel van aanmaken (ISO 8601).

**updated\_at** `string`

Tijdstempel van laatste update (ISO 8601). Kan `null` zijn.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | Validatiefout — bijv. ongeldige datumindeling, weekenddatum, ophaalvenster te kort, tijdslimiet voor dezelfde dag verstreken. Wordt ook geretourneerd als `destination_lab` of de vertreklocatie geen geregistreerd adres heeft. |
| `403` | Verboden — je API-sleutel heeft geen toegang tot deze bewerking of de locatie valt buiten je toegangscontext. |
| `404` | Locatie niet gevonden of inactief, of `appointment_id` is opgegeven maar de afspraak bestaat niet. |
| `409` | De `Idempotency-Key` is al gebruikt met een andere request body, of het oorspronkelijke verzoek is nog niet voltooid. |
| `500` | Interne serverfout. |
| `502` | De logistieke dienstverlener heeft het verzoek afgewezen. Bevat de foutmelding van de dienstverlener. |

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