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

# Actualitza un enviament

> Modifica els detalls de l'enviament abans de la recollida

Actualitza els detalls de l'enviament, com ara l'horari de recollida, el nombre de paquets o les notes. Si canvia algun camp rellevant per a la logística (data de recollida, hora, nombre de paquets o pes), l'ordre logística existent es cancel·la i se'n crea una de nova automàticament. Els camps que ometis es conserven de l'enviament existent. Els camps d'horari actualitzats es validen segons les [regles d'horari de recollida](https://docs.anivahealth.com/ca/concepts/shipments.md#regles-de-l-horari-de-recollida).

> [!WARNING]
>
> Els enviaments no es poden modificar després de la recollida. Intentar actualitzar un enviament que ja s'ha
> recollit retorna `409 Conflict`.

Un paquet de kit de prova a casa ja té l'etiqueta impresa, així que només pot canviar `notes`. Una nova franja de recollida
o un nou pes en un paquet de kit de prova a casa retorna `409 Conflict`; cancel·la'l i crea un enviament nou en el seu lloc.

Per actualitzar un paquet de kit de prova a casa, totes les comandes de kit de prova a casa vinculades han de ser dins del teu context d'accés.
En cas contrari, la crida retorna `403`. Consulta [Accés](https://docs.anivahealth.com/ca/concepts/shipments.md#acces).

## Sol·licitud

### Paràmetres de ruta

**id** `string` *required*

ID de referència de l'enviament (p. ex., `P2611194821`).

### Paràmetres del cos

Tots els paràmetres del cos són opcionals — inclou només els camps que vulguis canviar.

**pickup\_date** `string`

Nova data de recollida en format `YYYY-MM-DD`, interpretada en el fus horari de la ubicació d'origen.

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

Nova hora mínima de recollida en format `HH:MM`, interpretada com a hora local en el fus horari
de la ubicació d'origen.

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

Nova hora màxima de recollida en format `HH:MM`, interpretada com a hora local en el fus horari de la ubicació
d'origen.

**package\_count** `integer`

Nou nombre de paquets.

**weight** `number`

Nou pes en kg.

**notes** `string`

Noves notes o observacions. Màxim 128 caràcters.

## Resposta

Si té èxit, l'API retorna `200 OK` amb l'enviament actualitzat.

**id** `string` *required*

Identificador de referència de l'enviament.

**status** `string` *required*

Estat del cicle de vida de l'enviament. Un de `pending`, `in_transit`, `delivered`, `fault` o `cancelled`.

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

Proveïdor logístic. Pot ser `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` o `dhl_express`. Un paquet de kit a domicili és `dhl_parcel`, o `dhl_warenpost` quan s'envia a l'estranger
com a Warenpost International.

**tracking\_number** `string`

Número de seguiment extern del proveïdor logístic. Pot ser `null`.

**contents** `string`

Descripció en text lliure del contingut del paquet, tal com es va indicar en crear-lo. Pot ser `null`.

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

Qui ha imprès l'etiqueta: `aniva` o `external`. Només els enviaments d'`aniva` accepten aquesta crida.

**paired\_with** `string`

Referència de l'altre paquet d'un enviament de dos paquets. `null` per a un paquet d'un sol trajecte.

**origin** `object`

Adreça de recollida. Pot ser `null`.

**objecte d'adreça**

**name** `string` *required*

Nom del destinatari, empresa o ubicació.

**company\_name** `string`

Empresa / línia c/o. Pot ser `null`.

**street** `string` *required*

Nom del carrer, sense el número.

**house\_number** `string`

Número de portal. Pot ser `null`.

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

Edifici, entrada o pis. Pot ser `null`.

**city** `string` *required*

Ciutat.

**state** `string`

Estat o província. Pot ser `null`.

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

Codi postal/ZIP.

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

Codi de país ISO 3166-1 alfa-2.

**phone** `string`

Telèfon de contacte. Pot ser `null`.

**email** `string`

Correu electrònic de contacte. Pot ser `null`.

**destination** `object`

Adreça de lliurament. Mateixa estructura que `origin`. Pot ser `null`.

**pickup** `object`

Franja de recollida programada. Pot ser `null`.

**objecte pickup**

**from** `string` *required*

Inici de la franja de recollida com a instant UTC (ISO 8601 amb el sufix `Z`).

**till** `string` *required*

Final de la franja de recollida com a instant UTC (ISO 8601 amb el sufix `Z`).

**timezone** `string` *required*

Zona horària IANA de la ubicació de recollida (p. ex., `Europe/Berlin`). Fes-la servir per mostrar `from` / `till` en l'hora local de la ubicació de recollida.

**notes** `string`

Notes opcionals. Pot ser `null`.

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

Esdeveniments cronològics del cicle de vida del proveïdor logístic (el més antic primer). Cada entrada té
`state`, `code`, `detail_code`, `status`, `description`, `location` i `time`. Consulta [Obtén
l'enviament](https://docs.anivahealth.com/ca/api/shipments/get-shipment.md) per a cada camp. Matriu buida si encara no s'ha observat cap esdeveniment.

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

Cites vinculades a aquest enviament, el vincle més antic primer. Cada entrada és `{ id, added_at }`;
creua cada `id` amb [Obtén la cita](https://docs.anivahealth.com/ca/api/appointments/get-appointment.md).
Només es llisten les cites del teu context d'accés.

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

Comandes de kits a domicili vinculades a aquest enviament, el vincle més antic primer, amb el mateix format `{ id, added_at }`.
Només es llisten les comandes del teu context d'accés. Matriu buida per als paquets de consulta.

**synced\_at** `string`

Quan es va conciliar l'enviament per última vegada amb el transportista, com a instant UTC. `null` fins a la primera
sincronització.

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

Marca de temps de creació (ISO 8601).

**updated\_at** `string`

Marca de temps de l'última actualització (ISO 8601). Pot ser `null`.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `400` | Error de validació — p. ex., format de data o hora no vàlid. |
| `403` | Prohibit — la teva clau d'API no té accés a aquesta operació, l'enviament està fora del teu context d'accés o una comanda vinculada de kit a domicili està fora del teu context d'accés. |
| `404` | No s'ha trobat l'enviament. |
| `409` | L'enviament no es pot modificar després de la recollida, o és un paquet de kit a domicili amb l'etiqueta impresa i la sol·licitud canvia més que `notes`. |
| `501` | L'enviament és `external` — no s'ha reservat a través d'Aniva i no es pot canviar aquí. |
| `500` | Error intern del servidor. |
| `502` | El proveïdor logístic ha rebutjat la sol·licitud (p. ex., ha fallat la cancel·lació o la nova creació). Inclou el missatge d'error del proveïdor. |

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