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

# Создать отправление

> Создать заказ на логистическое отправление с указанными пунктами отправки и назначения

Создаёт заказ на отправление из указанной исходной локации. Лабораторию назначения ты указываешь в `destination_lab`. Отправление идёт на зарегистрированный адрес доставки этой лаборатории.

Требуется область доступа `shipments_manage`.

Передай необязательный заголовок `Idempotency-Key`, чтобы этот запрос на создание можно было безопасно повторять — повтор с тем же ключом вернёт исходный ответ вместо создания второй записи. См. [Идемпотентность](https://docs.anivahealth.com/ru/concepts/idempotency.md).

## Запрос

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

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

UUID исходной локации тестирования. Локация должна быть активной и входить в контекст доступа твоего API-ключа.
Используй [Список локаций](https://docs.anivahealth.com/ru/api/locations/list-locations.md), чтобы найти доступные ID локаций.

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

Лаборатория назначения. Одно из значений: `zotzklimas`, `labclinic`, `nordicgroup`, `biomes`, `imd` или
`quade`. Отправление идёт на зарегистрированный для этой лаборатории адрес доставки. Для лаборатории
без зарегистрированного адреса доставки возвращается `400`.

**appointment\_id** `string`

Необязательный UUID записи, к которой нужно привязать это отправление при создании. Запись должна
входить в контекст доступа твоего API-ключа. Привязка отображается как элемент в массиве
`appointments` отправления и, соответственно, как элемент в массиве `shipments` записи. Чтобы привязать
дополнительные записи после создания или удалить начальную привязку, используй [Привязать записи к
отправлению](https://docs.anivahealth.com/ru/api/shipments/attach-appointments-to-shipment.md) и [Отвязать записи от
отправления](https://docs.anivahealth.com/ru/api/shipments/detach-appointments-from-shipment.md).

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

Дата забора в формате `YYYY-MM-DD` (например, `2026-04-15`), интерпретируется в часовом поясе исходной
локации. Должна быть рабочим днём (понедельник–пятница), сегодня или в будущем. Забор в тот же день
недоступен после 16:00 Europe/Berlin.

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

Самое раннее время забора в формате `HH:MM` (например, `09:00`), интерпретируется как местное время в
часовом поясе исходной локации. Должно быть между `09:00` и `19:00`.

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

Самое позднее время забора в формате `HH:MM` (например, `12:00`), интерпретируется как местное время в часовом
поясе исходной локации. Должно быть между `09:00` и `19:00`. Окно (`pickup_time_till -
    pickup_time_from`) должно составлять не менее 2 часов.

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

Количество посылок. По умолчанию `1`.

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

Вес в kg. По умолчанию `0.5`.

**pickup\_remarks** `string`

Инструкции для курьера при заборе (примечания отправителя). Если не указано, используются
сохранённые примечания адреса забора (или ничего, если их нет). Максимум 128 символов.

**contents** `string`

Описание содержимого посылки в свободной форме — показывается курьеру и возвращается в поле
`contents`. Максимум 40 символов (например, `Medizinisch freigestellte Probe`).

**notes** `string`

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

## Ответ

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

**id** `string` *required*

Справочный идентификатор отправления (например, `P2604151234`).

**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).
Сразу после создания содержит запись, переданную в `appointment_id` (если она была указана).

**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` | Ошибка валидации — например, неверный формат даты, выходной день, слишком узкое окно забора, истекло время для забора в тот же день. Также возвращается, если у `destination_lab` или исходной локации нет зарегистрированного адреса. |
| `403` | Доступ запрещён — у твоего API-ключа нет доступа к этой операции или локация находится вне твоего контекста доступа. |
| `404` | Локация не найдена или неактивна, либо указан `appointment_id`, но такая запись не существует. |
| `409` | Ключ `Idempotency-Key` уже использовался с другим телом запроса или исходный запрос ещё не завершился. |
| `500` | Внутренняя ошибка сервера. |
| `502` | Логистический провайдер отклонил запрос. Содержит сообщение об ошибке от провайдера. |

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