--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.kz/routing/doc/en/delivery/functions/shared.md - https://yandex.kz/routing/doc/kk/delivery/functions/shared.md - https://yandex.kz/routing/doc/ru/delivery/functions/shared.md - href: ru/delivery/functions/shared.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/ru/llms.txt # Шеринг заказов между компаниями Функция шеринга позволяет открывать доступ к просмотру заказов другим компаниям-наблюдателям. Например, вы отправляете заказы с разными транспортными компаниями и загружаете для них данные в Мониторинг. Компании в своем Рабочем месте будут видеть только те заказы, к которым вы откроете для них доступ. Для доступа к заказу наблюдатель должен быть зарегистрирован в сервисе [Яндекс Маршрутизация](https://yandex.ru/routing/). У компаний-наблюдателей нет доступа к дашборду руководителя компании, которая предоставила доступ. При этом у них есть доступ к дашборду руководителя своей компании, где будут отображаться все доступные заказы. Если получателю нужно отследить перевозку конкретного заказа, используйте [виджет](https://yandex.kz/routing/doc/ru/delivery/functions/client-widget.md). ## Примеры использования шеринга {#example} 1. Крупная транспортная компания предоставляет доступ другим компаниям, чтобы те доставляли заказы. У компании-подрядчика отображаются маршруты с заказами, к которым выдан доступ. 1. Транспортная компания, которая доставляет заказы, открывает доступ компании-заказчику, чтобы те могли отслеживать информацию о доставке. Изменить заказы и добавить курьера не получится. Курьер должен быть добавлен в компанию, которая предоставила доступ. После получения доступа компания-наблюдатель может посмотреть информацию о заказах и маршрутах в [Рабочем месте логиста](#check-ui) и через [API](#check-api). ## Идентификаторы {#ids} Для предоставления доступа используется один из следующих идентификаторов: - `company_id` — ID компании-наблюдателя в Маршрутизации; - псевдоним — внешний номер компании-наблюдателя, который можно дополнительно создать для удобства идентификации компании: - если нет возможности хранить во внутренней базе данных `company_id` компании-подрядчика; - чтобы дополнительно не добавлять `company_id` подрядчика. Для этого установите соответствие: [свяжите](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsOrEditsContractorNumber) ID компании-подрядчика `contractor_company_id` и внешний номер `number`. {% cut "Ограничения" %} - В качестве псевдонима может использоваться любая последовательность букв и цифр. - В псевдониме не должно быть запятой — этот знак используется как разделитель. - Псевдоним чувствителен к регистру. {% endcut %} ## Открыть доступ {#open-access} Возможные способы: - при планировании через [Excel](#excel); - при планировании через [API](#api); - через [интерфейс Рабочего места логиста](#ui). При добавлении наблюдателей через Excel и API доступ выдается к отдельным заказам, а при добавлении через Рабочее место логиста — ко всем заказам выбранного маршрута. ### Excel {#excel} {% list tabs %} - Через `company_id` 1. В файле с маршрутами на листе **Orders** добавьте столбец `shared_with_company_ids`. 1. В столбце `shared_with_company_ids` укажите значения `company_id` [*](*id_компании) для заказов, к которым необходимо открыть доступ наблюдателям. 1. В Рабочем месте логиста [загрузите файл](https://yandex.kz/routing/doc/ru/delivery/load-data.md) в Мониторинг. В окне импорта маршрутов идентификаторы наблюдателей отобразятся на вкладке **Заказы** в поле **Отслеживающие компании (id)**. При необходимости вы можете изменить данные прямо в интерфейсе. - Через псевдоним {% note warning %} Перед тем, как использовать этот способ, установите соответствие: [свяжите](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsOrEditsContractorNumber) ID компании-подрядчика `contractor_company_id` и псевдоним `number`. {% endnote %} 1. В файле с маршрутами на листе **Orders** добавьте столбец `shared_with_company_numbers`. 1. В столбце `shared_with_company_numbers` укажите псевдоним компании-наблюдателя для заказов, к которым необходимо открыть доступ. 1. В Рабочем месте логиста [загрузите файл](https://yandex.kz/routing/doc/ru/delivery/load-data.md) в Мониторинг. В окне импорта маршрутов идентификаторы наблюдателей отобразятся на вкладке **Заказы** в поле **Отслеживающие компании (numbers)**. При необходимости вы можете изменить данные прямо в интерфейсе. {% endlist %} При этом возможна комбинация способов: часть наблюдателей может быть указана через `company_id`, а часть — через псевдоним. | id | shared_with_company_ids | shared_with_company_numbers | |---------|-------------------------|-----------------------------| | Заказ 1 | 1, 2, 3, 4 | | | Заказ 2 | 5, 6, 7, 8 | СевернаяРоза, Восток77 | | Заказ 3 | | Indigo, 555 | ### API {#api} {% list tabs %} - Через `company_id` Укажите `company_id` [*](*id_компании) в поле `shared_with_company_ids`. Поле используется в теле запроса при выполнении следующих операций: - [добавление заказа](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsAnOrder); - [редактирование заказа](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsOrder); - [редактирование нескольких заказов](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsMultipleOrders). - Через псевдоним 1. Свяжите ID компании-подрядчика `contractor_company_id` и его псевдоним `number`. [Подробнее](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsOrEditsContractorNumber). 1. Укажите псевдоним `number` в поле `shared_with_company_numbers`. Поле используется в теле запроса при выполнении следующих операций: - [добавление заказа](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsAnOrder); - [редактирование заказа](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsOrder); - [редактирование нескольких заказов](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsMultipleOrders). При этом возможна комбинация способов: часть наблюдателей может быть указана через `company_id`, а часть — через синоним. {% endlist %} ### Интерфейс Рабочего места логиста {#ui} Обратитесь в службу поддержки, чтобы: - зарегистрировать аккаунт в сервисе для компании, которую вы хотите сделать наблюдателем; - подключить возможность добавлять наблюдателей для маршрута; - установить [связь](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsOrEditsContractorNumber) между ID компании-подрядчика `contractor_company_id` и псевдонимом `number`. Вы можете установить связь между ID компании и псевдонимом самостоятельно, если наблюдатель уже зарегистрирован в сервисе, и вам известен его ID. Чтобы добавить наблюдателей для маршрута: 1. [Загрузите маршруты](https://yandex.kz/routing/doc/ru/delivery/load-data.md) в Мониторинг. 1. Выберите маршрут, которым хотите поделиться. 1. Нажмите значок ![](../_images/add-viewers.svg). 1. В выпадающем списке выберите компании и нажмите **Применить**. Наблюдатели получают доступ ко всем заказам выбранного маршрута. ![](../_images/observers.png) ## Посмотреть наблюдателей {#check} В Рабочем месте логиста вы можете посмотреть информацию о наблюдателях заказов: - в [отчете](https://yandex.kz/routing/doc/ru/delivery/interface/quality-report.md) о качестве работы курьеров: в полях **Наблюдатель 1**, **Наблюдатель 2** и т. д. - в [карточке заказа](https://yandex.kz/routing/doc/ru/delivery/interface/orders.md): в поле **Наблюдатели**. - на странице маршрута: столбец **Наблюдатели**. ## Получить доступ {#access} Заказы, к которым другая компания открыла доступ, по умолчанию видны только администраторам компании-наблюдателя. Чтобы эти заказы стали видны менеджерам, пользователю с ролью администратор нужно выдать им [права доступа](https://yandex.kz/routing/doc/ru/delivery/interface/managers.md) в своем Рабочем месте логиста. {% cut "Как это сделать" %} В разделе **Настройки** → **Менеджеры** включите опцию напротив нужной компании или выберите **Доступ ко всем компаниям**. ![](../_images/shared-access.png) {% endcut %} ## Посмотреть информацию о заказах и маршрутах {#check-access} ### API {#check-api} {% note info %} В поле `company_id` укажите ID компании, которая предоставила доступ. {% endnote %} Компания-наблюдатель может получать информацию о маршрутах и заказах через API: - [Получить несколько маршрутов](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsMultipleRoutes). В ответе будут показаны ID доступных маршрутов. - [Получить несколько заказов](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsMultipleOrders). В `route_id` укажите ID нужного маршрута. В ответе будет показана информация по заказам этого маршрута. - [Получить информацию о качестве доставки](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsDeliveryQualityInformation). В ответе будет показан отчет о качестве доставки. - [Получить фото](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsPhotos). В ответе будет показан список фото, которые приложил курьер. - [Получить информацию о маршруте](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsRouteInfo). В ответе будет показана информация о маршрутах и о их заказах, в том числе ожидаемое время прибытия. Данная информация также доступна в Рабочем месте логиста. ### Интерфейс Рабочего места логиста {#check-ui} Чтобы увидеть маршруты и заказы, к которым вам открыт доступ, в Рабочем месте логиста, в левом верхнем углу выберите нужную компанию в выпадающем списке. {% cut "Посмотреть маршруты и заказы" %} ![](../_images/logistics-workplace-interface.png =790x){style="border: solid 1px #cccccc; max-width: 800px;"} {% endcut %} Информация о доступных маршрутах и заказах совпадает с компанией, которая выдала доступ, но без возможности вносить изменения. Написать в службу поддержки [//]: # (Вариант без html\: \[Написать в службу поддержки\]\(../../../feedback.md\)) [*id_компании]: ID компании-наблюдателя в Маршрутизации