# Службы доставки

Выбирайте службу доставки для отгрузки. Создавайте свои записи на уже зарегистрированном REST-обработчике.

Битрикс24 API: `sale.delivery.*`
Скоуп: `delivery`

Встроенные службы доступны для чтения. Битрикс24 разрешает изменять и удалять только записи на REST-обработчиках. Для OAuth-приложения дополнительно проверяется владение обработчиком. Одного скоупа `sale` недостаточно.

## Операции

- [Список](./delivery-services/list.md) — `GET /v1/delivery-services`
- [Получить](./delivery-services/get.md) — `GET /v1/delivery-services/:id`
- [Создать](./delivery-services/create.md) — `POST /v1/delivery-services`
- [Изменить](./delivery-services/update.md) — `PATCH /v1/delivery-services/:id`
- [Удалить](./delivery-services/delete.md) — `DELETE /v1/delivery-services/:id`
- [Обработчики](./delivery-services/handlers.md) — `GET /v1/delivery-services/handlers`

## Ключевые поля

`id` из [списка служб доставки](./delivery-services/list.md) передавайте в `deliveryId` отгрузки. `parentId` связывает профиль с родительской службой. `logotype` — ID файла, не URL.

[Все поля](./delivery-services/fields.md).

## Что нужно знать перед работой

Обработчики регистрируются отдельно: эти маршруты только читают их определения. `active` использует строки `Y` и `N`, а не `boolean`.

Создание возвращает `parent` и `profiles`. Профиль тоже может использоваться в отгрузке.

## Типичный сценарий

Прочитайте [список обработчиков](./delivery-services/handlers.md), выберите `code`, создайте неактивную службу, получите её, измените `name`, затем удалите только свою запись. Создание могло выполниться, даже если ответ завершился ошибкой. Перед повтором проверьте [список служб доставки](./delivery-services/list.md).

## Лимиты

Списки полные, без `limit` и `offset`. `meta.total` равен длине `data`. Операции `search`, `aggregate` и пакетные запросы для сущности не поддерживаются. Логотип: `logo` — массив `[filename, base64]`, до 2 МиБ после декодирования. Тело JSON — до 3 МиБ. `restCode` и `config` задаются только при создании.

## Что можно менять

| Запись | GET | PATCH / DELETE |
|---|---|---|
| Встроенная | Да | 403 |
| REST | Да | По правам Битрикс24 и владельцу OAuth-приложения |

## Смотрите также

- [Отгрузки](/docs/entities/shipments)
- [Доставки CRM](/docs/entities/crm-deliveries)