# Delivery services

Select a delivery service for a shipment. Create your own records using a registered REST handler.

Bitrix24 API: `sale.delivery.*`
Scope: `delivery`

Built-in services are readable. Bitrix24 permits updates and deletion only for REST-handler records; OAuth applications are also checked against handler ownership. The `sale` scope alone is insufficient.

## Operations

- [List](./delivery-services/list.md) — `GET /v1/delivery-services`
- [Get](./delivery-services/get.md) — `GET /v1/delivery-services/:id`
- [Create](./delivery-services/create.md) — `POST /v1/delivery-services`
- [Update](./delivery-services/update.md) — `PATCH /v1/delivery-services/:id`
- [Delete](./delivery-services/delete.md) — `DELETE /v1/delivery-services/:id`
- [Handlers](./delivery-services/handlers.md) — `GET /v1/delivery-services/handlers`

## Key fields

Pass `id` from the [delivery service list](./delivery-services/list.md) as the shipment `deliveryId`. `parentId` links a profile to its parent service. `logotype` is a file ID, not a URL.

[All fields](./delivery-services/fields.md).

## Before you start

Handlers are registered separately: these routes only read their definitions. `active` uses `Y` and `N` strings, not `boolean` values.

Creation returns `parent` and `profiles`. A profile can also be used in a shipment.

## Typical workflow

Read the [handler list](./delivery-services/handlers.md), select a `code`, create an inactive service, get it, update `name`, then delete only your own record. Creation may have completed even if the response failed. Check the [service list](./delivery-services/list.md) before retrying.

## Limits

Lists are complete, without `limit` or `offset`. `meta.total` equals the length of `data`. The entity does not support `search`, `aggregate`, or batch operations. Logo: `logo` is a `[filename, base64]` array, up to 2 MiB decoded. The JSON body can be up to 3 MiB. Set `restCode` and `config` only when creating a service.

## Write restrictions

| Record | GET | PATCH / DELETE |
|---|---|---|
| Built-in | Yes | 403 |
| REST | Yes | Subject to Bitrix24 rights and OAuth ownership |

## See also

- [Shipments](/docs/entities/shipments)
- [CRM deliveries](/docs/entities/crm-deliveries)