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

# Atjaunināt sūtījumu

> Mainīt sūtījuma datus pirms paņemšanas

Atjaunini sūtījuma informāciju, piemēram, paņemšanas grafiku, paku skaitu vai piezīmes. Ja mainās kāds loģistikai būtisks lauks (paņemšanas datums, laiks, paku skaits vai svars), esošais loģistikas pasūtījums tiek atcelts un automātiski izveidots jauns. Izlaistie lauki tiek saglabāti no esošā sūtījuma. Atjauninātie grafika lauki tiek pārbaudīti atbilstoši [paņemšanas grafika noteikumiem](https://docs.anivahealth.com/lv/concepts/shipments.md#panemsanas-grafika-noteikumi).

> [!WARNING]
>
> Sūtījumus pēc paņemšanas nevar mainīt. Mēģinot atjaunināt jau paņemtu sūtījumu,
> tiek atgriezts `409 Conflict`.

Mājas testa komplekta pakai uzlīme jau ir izdrukāta, tāpēc var mainīt tikai `notes`. Jauns paņemšanas laika logs
vai svars mājas testa komplekta pakai atgriež `409 Conflict`; tā vietā atcel to un izveido jaunu sūtījumu.

Lai atjauninātu mājas testa komplekta paku, visiem saistītajiem mājas testa komplekta pasūtījumiem ir jābūt tavā piekļuves kontekstā.
Pretējā gadījumā pieprasījums atgriež `403`. Skati [Piekļuve](https://docs.anivahealth.com/lv/concepts/shipments.md#piekluve).

## Pieprasījums

### Ceļa parametri

**id** `string` *required*

Sūtījuma atsauces ID (piem., `P2611194821`).

### Pieprasījuma satura parametri

Visi pamatteksta parametri ir neobligāti — iekļauj tikai tos laukus, kurus vēlies mainīt.

**pickup\_date** `string`

Jauns paņemšanas datums `YYYY-MM-DD` formātā, kas tiek interpretēts nosūtīšanas vietas laika joslā.

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

Jauns agrākais paņemšanas laiks `HH:MM` formātā, kas tiek interpretēts kā pulksteņa laiks nosūtīšanas
vietas laika joslā.

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

Jauns vēlākais paņemšanas laiks `HH:MM` formātā, kas tiek interpretēts kā pulksteņa laiks nosūtīšanas
vietas laika joslā.

**package\_count** `integer`

Jauns paku skaits.

**weight** `number`

Jauns svars kg.

**notes** `string`

Jaunas piezīmes vai komentāri. Maksimums 128 rakstzīmes.

## Atbilde

Veiksmes gadījumā API atgriež `200 OK` ar atjaunināto sūtījumu.

**id** `string` *required*

Sūtījuma atsauces identifikators.

**status** `string` *required*

Sūtījuma dzīves cikla statuss. Viena no šīm vērtībām: `pending`, `in_transit`, `delivered`, `fault` vai `cancelled`.

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

Loģistikas pakalpojumu sniedzējs. Viena no vērtībām: `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` vai `dhl_express`. Mājas komplekta paka ir `dhl_parcel` vai `dhl_warenpost`, ja tā dodas uz ārzemēm
kā Warenpost International.

**tracking\_number** `string`

Loģistikas pakalpojumu sniedzēja ārējais izsekošanas numurs. Var būt `null`.

**contents** `string`

Brīvā teksta apraksts par pakas saturu, kā norādīts izveides brīdī. Var būt `null`.

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

Kurš izdrukāja uzlīmi: `aniva` vai `external`. Šo pieprasījumu pieņem tikai `aniva` sūtījumi.

**paired\_with** `string`

Otras pakas atsauce divu paku sūtījumā. `null` vienvirziena pakai.

**origin** `object`

Paņemšanas adrese. Var būt `null`.

**adreses objekts**

**name** `string` *required*

Saņēmēja, uzņēmuma vai atrašanās vietas nosaukums.

**company\_name** `string`

Uzņēmuma / c/o rinda. Var būt `null`.

**street** `string` *required*

Ielas nosaukums bez mājas numura.

**house\_number** `string`

Mājas numurs. Var būt `null`.

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

Ēka, ieeja vai stāvs. Var būt `null`.

**city** `string` *required*

Pilsēta.

**state** `string`

Štats vai province. Var būt `null`.

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

Pasta indekss.

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

ISO 3166-1 alpha-2 valsts kods.

**phone** `string`

Kontakttālruņa numurs. Var būt `null`.

**email** `string`

Kontakta e-pasts. Var būt `null`.

**destination** `object`

Piegādes adrese. Tāda pati struktūra kā `origin`. Var būt `null`.

**pickup** `object`

Ieplānotais paņemšanas laika logs. Var būt `null`.

**pickup objekts**

**from** `string` *required*

Paņemšanas laika loga sākums kā UTC laika punkts (ISO 8601 ar `Z` sufiksu).

**till** `string` *required*

Paņemšanas laika loga beigas kā UTC laika punkts (ISO 8601 ar `Z` sufiksu).

**timezone** `string` *required*

Paņemšanas vietas IANA laika josla (piem., `Europe/Berlin`). Izmanto, lai parādītu `from` / `till` paņemšanas vietas vietējā laikā.

**notes** `string`

Neobligātas piezīmes. Var būt `null`.

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

Hronoloģiski loģistikas pakalpojumu sniedzēja dzīves cikla notikumi (vecākie vispirms). Katram ierakstam ir
`state`, `code`, `detail_code`, `status`, `description`, `location` un `time`. Katra lauka aprakstu skati sadaļā [Iegūt
sūtījumu](https://docs.anivahealth.com/lv/api/shipments/get-shipment.md). Tukšs masīvs, ja notikumi vēl nav fiksēti.

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

Ar šo sūtījumu saistītie pieraksti, sākot ar vecāko saiti. Katrs ieraksts ir `{ id, added_at }`;
pārbaudi katru `id` ar [Iegūt pierakstu](https://docs.anivahealth.com/lv/api/appointments/get-appointment.md).
Ir uzskaitīti tikai tie pieraksti, kas ir tavā piekļuves kontekstā.

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

Ar šo sūtījumu saistītie mājas komplektu pasūtījumi, sākot ar vecāko saiti, tādā pašā `{ id, added_at }` formā.
Norādīti tikai tie pasūtījumi, kas ir tavā piekļuves kontekstā. Prakses sūtījumiem tas ir tukšs masīvs.

**synced\_at** `string`

Laiks, kad sūtījums pēdējo reizi tika salāgots ar pārvadātāju, kā UTC laika punkts. `null` līdz pirmajai
sinhronizācijai.

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

Izveides laikspiedols (ISO 8601).

**updated\_at** `string`

Pēdējās atjaunināšanas laikspiedols (ISO 8601). Var būt `null`.

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | Validācijas kļūda — piem., nederīgs datuma vai laika formāts. |
| `403` | Aizliegts — tavai API atslēgai nav piekļuves šai darbībai, sūtījums ir ārpus tava piekļuves konteksta vai piesaistītais mājas komplekta pasūtījums ir ārpus tava piekļuves konteksta. |
| `404` | Sūtījums nav atrasts. |
| `409` | Sūtījumu nevar mainīt pēc paņemšanas, vai arī tā ir mājas komplekta paka, kuras etiķete ir izdrukāta un pieprasījums maina ko vairāk par `notes`. |
| `501` | Sūtījums ir `external` — tas nav pieteikts caur Aniva un to šeit nevar mainīt. |
| `500` | Iekšēja servera kļūda. |
| `502` | Loģistikas pakalpojumu sniedzējs noraidīja pieprasījumu (piem., atcelšana vai atkārtota izveide neizdevās). Ietver pakalpojumu sniedzēja kļūdas ziņojumu. |

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