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

# Обновить отправление

> Изменить данные отправления до его забора

Обнови данные отправления, например расписание забора, количество упаковок или заметки. Если меняется любое поле, важное для логистики (дата, время забора, количество упаковок или вес), текущий логистический заказ отменяется и автоматически создается новый. Поля, которые ты не укажешь, сохраняются из существующего отправления. Обновленные поля расписания проверяются на соответствие [правилам расписания забора](https://docs.anivahealth.com/ru/concepts/shipments.md#pravila-raspisaniya-zabora).

> [!WARNING]
>
> Отправление нельзя изменить после забора. Попытка обновить уже забранное отправление возвращает
> `409 Conflict`.

Для посылки с набором для домашнего теста этикетка уже напечатана, поэтому можно изменить только
`notes`. Новое окно забора или вес для такой посылки возвращают `409 Conflict`; вместо этого отмени
ее и создай новое отправление.

Чтобы обновить посылку с набором для домашнего теста, каждый привязанный заказ набора для
домашнего теста должен быть в твоем контексте доступа. Иначе запрос вернет `403`. См.
[Доступ](https://docs.anivahealth.com/ru/concepts/shipments.md#dostup).

## Запрос

### Параметры пути

**id** `string` *required*

Референсный ID отправления (например, `P2611194821`).

### Параметры тела запроса

Все параметры тела запроса необязательны — передавай только те поля, которые хочешь изменить.

**pickup\_date** `string`

Новая дата забора в формате `YYYY-MM-DD`, интерпретируется в часовом поясе места отправления.

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

Новое самое раннее время забора в формате `HH:MM`, интерпретируется как местное время в часовом
поясе места отправления.

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

Новое самое позднее время забора в формате `HH:MM`, интерпретируется как местное время в часовом
поясе места отправления.

**package\_count** `integer`

Новое количество упаковок.

**weight** `number`

Новый вес в kg.

**notes** `string`

Новые заметки или примечания. Максимум 128 символов.

## Ответ

При успехе API возвращает `200 OK` с обновленным отправлением.

**id** `string` *required*

Референсный идентификатор отправления.

**status** `string` *required*

Статус жизненного цикла отправления. Одно из значений: `pending`, `in_transit`, `delivered`, `fault` или `cancelled`.

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

Логистический провайдер. Одно из значений: `go`, `dhl_parcel`, `dhl_warenpost`, `rotrunner`, `rapido`,
`ups` или `dhl_express`. Посылка с домашним набором отправляется через `dhl_parcel`, или через `dhl_warenpost`, если идёт за границу
как Warenpost International.

**tracking\_number** `string`

Внешний трек-номер от логистического провайдера. Может быть `null`.

**contents** `string`

Описание содержимого посылки в свободной форме, указанное при создании. Может быть `null`.

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

Кто распечатал этикетку: `aniva` или `external`. Этот запрос принимают только отправления `aniva`.

**paired\_with** `string`

Идентификатор другой посылки в отправлении из двух посылок. `null` для односторонней посылки.

**origin** `object`

Адрес забора курьером. Может быть `null`.

**объект адреса**

**name** `string` *required*

Имя получателя, название компании или локации.

**company\_name** `string`

Компания / строка c/o. Может быть `null`.

**street** `string` *required*

Название улицы без номера дома.

**house\_number** `string`

Номер дома. Может быть `null`.

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

Корпус, подъезд или этаж. Может быть `null`.

**city** `string` *required*

Город.

**state** `string`

Штат или провинция. Может быть `null`.

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

Почтовый индекс.

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

Код страны по ISO 3166-1 alpha-2.

**phone** `string`

Контактный номер телефона. Может быть `null`.

**email** `string`

Контактный email. Может быть `null`.

**destination** `object`

Адрес доставки. Та же структура, что и у `origin`. Может быть `null`.

**pickup** `object`

Запланированное окно забора. Может быть `null`.

**Объект pickup**

**from** `string` *required*

Начало окна забора как момент времени в UTC (ISO 8601 с суффиксом `Z`).

**till** `string` *required*

Конец окна забора как момент времени в UTC (ISO 8601 с суффиксом `Z`).

**timezone** `string` *required*

Часовой пояс IANA пункта забора (например, `Europe/Berlin`). Используй для отображения `from` / `till` по его местному времени.

**notes** `string`

Необязательные заметки. Может быть `null`.

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

События жизненного цикла от логистического провайдера в хронологическом порядке (сначала старые). Каждый элемент содержит
`state`, `code`, `detail_code`, `status`, `description`, `location` и `time`. Описание каждого поля см. в [Получить
отправление](https://docs.anivahealth.com/ru/api/shipments/get-shipment.md). Пустой массив, если событий пока не было.

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

Записи, привязанные к этому отправлению, начиная с самой ранней привязки. Каждый элемент имеет вид
`{ id, added_at }`; сверь каждый `id` через [Получение записи](https://docs.anivahealth.com/ru/api/appointments/get-appointment.md).
Перечислены только записи в твоем контексте доступа.

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

Заказы домашних наборов, привязанные к этому отправлению (сначала самые ранние привязки), в том же формате `{ id, added_at }`.
В списке только заказы из твоего контекста доступа. Пустой массив для посылок из практик.

**synced\_at** `string`

Время последней сверки отправления с перевозчиком в UTC. `null` до первой
синхронизации.

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

Время создания (ISO 8601).

**updated\_at** `string`

Время последнего обновления (ISO 8601). Может быть `null`.

## Ответы с ошибками

| Статус | Описание |
| - | - |
| `400` | Ошибка валидации — например, неверный формат даты или времени. |
| `403` | Доступ запрещён — у твоего API-ключа нет доступа к этой операции, отправление находится вне твоего контекста доступа или связанный заказ домашнего набора находится вне твоего контекста доступа. |
| `404` | Отправление не найдено. |
| `409` | Отправление нельзя изменить после забора курьером, либо это посылка с домашним набором с уже напечатанной этикеткой, а запрос меняет не только `notes`. |
| `501` | Это отправление `external` — оно оформлено не через Aniva и его нельзя изменить здесь. |
| `500` | Внутренняя ошибка сервера. |
| `502` | Логистический провайдер отклонил запрос (например, не удалось отменить или пересоздать отправление). Включает сообщение об ошибке от провайдера. |

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