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

> Verzendgegevens wijzigen voor het ophalen

Werk zendinggegevens bij, zoals het ophaalschema, aantal pakketten of opmerkingen. Als velden die relevant zijn voor de logistiek wijzigen (ophaaldatum, tijd, aantal pakketten of gewicht), wordt de bestaande logistieke opdracht geannuleerd en wordt er automatisch een nieuwe aangemaakt. Velden die je weglaat blijven behouden vanuit de bestaande zending. Bijgewerkte schemavelden worden gevalideerd aan de hand van de [regels voor het ophaalschema](https://docs.anivahealth.com/nl/concepts/shipments.md#regels-voor-het-ophaalschema).

> [!WARNING]
>
> Zendingen kunnen na ophaling niet meer worden gewijzigd. Een poging om een zending bij te werken die al is
> opgehaald geeft `409 Conflict` terug.

Het label van een thuistestkitpakket is al afgedrukt, dus alleen `notes` kan wijzigen. Een nieuw ophaalvenster
of gewicht voor een thuistestkitpakket geeft `409 Conflict` terug; annuleer het pakket en maak in plaats daarvan een nieuwe zending aan.

Om een thuistestkitpakket bij te werken moet elke gekoppelde thuistestkitbestelling binnen je toegangscontext vallen.
Anders geeft het verzoek `403` terug. Zie [Toegang](https://docs.anivahealth.com/nl/concepts/shipments.md#toegang).

## Verzoek

### Padparameters

**id** `string` *required*

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

### Bodyparameters

Alle bodyparameters zijn optioneel — neem alleen de velden op die je wilt wijzigen.

**pickup\_date** `string`

Nieuwe ophaaldatum in het formaat `YYYY-MM-DD`, geïnterpreteerd in de tijdzone van de herkomstlocatie.

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

Nieuwe vroegste ophaaltijd in het formaat `HH:MM`, geïnterpreteerd als lokale kloktijd in de tijdzone van de
herkomstlocatie.

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

Nieuwe laatste ophaaltijd in het formaat `HH:MM`, geïnterpreteerd als lokale kloktijd in de tijdzone van de
herkomstlocatie.

**package\_count** `integer`

Nieuw aantal pakketten.

**weight** `number`

Nieuw gewicht in kg.

**notes** `string`

Nieuwe notities of opmerkingen. Maximaal 128 tekens.

## Respons

Bij succes geeft de API `200 OK` terug met de bijgewerkte zending.

**id** `string` *required*

Referentie-identifier van de zending.

**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`. Alleen `aniva`-zendingen accepteren deze aanroep.

**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
`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 als er nog geen gebeurtenissen zijn waargenomen.

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

Afspraken gekoppeld aan deze zending, oudste koppeling eerst. Elk item heeft de vorm `{ id, added_at }`;
haal elke `id` op via [Afspraak ophalen](https://docs.anivahealth.com/nl/api/appointments/get-appointment.md).
Alleen de afspraken binnen je toegangscontext worden weergegeven.

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

Thuistestbestellingen gekoppeld aan deze zending, oudste koppeling eerst, in dezelfde `{ id, added_at }`-structuur.
Alleen de bestellingen binnen je toegangscontext worden vermeld. Lege array voor praktijkpakketten.

**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 — bijvoorbeeld een ongeldige datum- of tijdnotatie. |
| `403` | Toegang geweigerd — je API-sleutel heeft geen toegang tot deze bewerking, de zending valt buiten je toegangscontext of een gekoppelde home-kitbestelling valt buiten je toegangscontext. |
| `404` | Zending niet gevonden. |
| `409` | De zending kan niet meer worden gewijzigd nadat deze is opgehaald, of het is een home-kitpakket waarvan het etiket al is afgedrukt en het verzoek wijzigt meer dan `notes`. |
| `501` | De zending is `external` — deze is niet via Aniva geboekt en kan hier niet worden gewijzigd. |
| `500` | Interne serverfout. |
| `502` | Logistieke dienstverlener heeft het verzoek geweigerd (bijvoorbeeld annuleren of opnieuw aanmaken mislukt). Bevat de foutmelding van de dienstverlener. |

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