---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.kz/routing/doc/en/delivery/functions/client-widget.md
  - https://yandex.kz/routing/doc/kk/delivery/functions/client-widget.md
  - https://yandex.kz/routing/doc/ru/delivery/functions/client-widget.md
  - href: kk/delivery/functions/client-widget.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: Яндекс Маршрутизация — функции — клиентский виджет
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.kz/routing/doc/kk/llms.txt


# Клиентский виджет

Клиентский виджет — это отображение доставки по конкретному заказу.

Ссылка на виджет вида `https://yandex.ru/courier/tracking/<идентификатор трека>` уникальна для каждого заказа.

Ее можно получить с помощью GET-запросов к следующим ресурсам:

- [order-notifications](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsOrderNotifications)
- [order-info](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsOrderInfo)

Чтобы получить ссылку на виджет, откройте карточку заказа и в поле **Ссылка на отслеживание** нажмите **Получить ссылку**. 


Виджет с местоположением курьера будет активен в течение 15 дней или до момента выполнения заказа. После этого местоположение курьера отображаться не будет, но ссылка на виджет останется доступна еще сутки.

   ![](../_images/eta-widget-get-link.png)

## Заказ в пути {#order-on-road}

Клиент получает ссылку на виджет в SMS о доставке, если в настройках компании включена опция **Отправлять SMS клиентам** (см. [Настроить SMS для клиентов](https://yandex.kz/routing/doc/kk/delivery/interface/company.md#sms-settings)). Ссылку можно открыть как на мобильном устройстве, так и на компьютере.

В виджете отображается [ожидаемое время прибытия курьера](https://yandex.kz/routing/doc/kk/delivery/functions/eta.md). Для многодневных маршрутов в виджете отображается дата и время доставки. Пока заказ в пути, прогноз по времени доставки может меняться. Также отображаются данные о заказе и получателе.

![](../_images/eta-order-on-road.png)

#### 1. `estimated_delivery_time`

Значение ETA, округленное до ближайшего получасового интервала.

#### 2. `shift_start`

Время старта маршрута со склада. См. подробнее об уведомлении клиента о старте маршрута в разделе [Настройка отправки SMS](https://yandex.kz/routing/doc/kk/extras/sms-setting.md).

#### 3. `order_created`

Время создания заказа.

Если включена настройка [отображения геопозиции](https://yandex.kz/routing/doc/kk/delivery/interface/company.md#feedback-sections), на виджете отобразятся трек и текущее местоположение курьера.

## Заказ доставлен {#order-delivered}

В виджете доставленного заказа отображаются данные о заказе и получателе, история отслеживания со значимыми точками маршрута.

![](../_images/eta-order-delivered.png =800x)

#### 1. `status`

Текущий статус заказа. См. подробнее [Получает информацию о заказе](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsOrderInfo).

#### 2. `number`

Номер заказа. Используется для синхронизации с учетной системой компании, выполняющей доставку.

Задается в файле планирования или через API.

#### 3. `weight_kg`

[Вес заказа](https://yandex.kz/routing/doc/kk/vrp/properties-of-orders.md#order-weight). Задается в файле планирования или через API.

#### 4. `amount`

Стоимость заказа в рублях.

Задается только через API (см. подробнее [Добавляет заказ](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsAnOrder)).

#### 5. `payment_type`

Тип оплаты.

Задается только через API (см. подробнее [Добавляет заказ](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsAnOrder)).

#### 6. `time_interval`

Желаемое окно доставки заказа. Задается в файле планирования или через API.

#### 7. `address`

Адрес доставки в текстовом формате.

Задается в файле планирования или через API.

#### 8. `customer_name`

Имя получателя.

Задается в файле планирования или через API.

#### 9. Форма обратной связи

[Кнопка с формой](https://yandex.kz/routing/doc/kk/extras/external-links.md), чтобы получать обратную связь от клиента при выполнении заказа.

## Логотип {#logo}

В клиентский виджет можно добавить логотип вашей компании. Чтобы это сделать, [напишите нам](mailto:routing-support@yandex-team.ru).

![](../_images/eta-order-logo.png =600x){style="border: solid 1px #cccccc; max-width: 800px;"}

## Кастомизация виджета {#customization}

Клиентский виджет не кастомизируется средствами сервиса.

Если вам нужно реализовать свой вариант виджета на сайте, в личном кабинете клиента или в своем мобильном приложении, [получите информацию](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsOrderInfo) для собственного виджета по API.

Чтобы отображать карту на сайте, используйте [API Яндекс Карт](https://yandex.ru/dev/maps/jsapi/), в мобильном приложении — [MapKit](https://yandex.ru/dev/maps/mapkit/).

<!-- source: kk/delivery/_includes/feedback.md -->


[//]: # (Вариант без html\: \[Написать в службу поддержки\]\(../../../feedback.md\))

<!-- source: kk/_includes/neuroexpert.md -->
<div style="display: none;"> </div>
<!-- endsource: kk/_includes/neuroexpert.md -->
<!-- endsource: kk/delivery/_includes/feedback.md -->