---
metadata:
  - name: generator
    content: Diplodoc Platform v5.19.6
alternate:
  - https://yandex.ru/dev/sdg-robot/en/faq.md
  - https://yandex.ru/dev/sdg-robot/ru/faq.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/sdg-robot/ru/llms.txt

# Частые вопросы

## Создание заказа {#create-claim}

{#request-id}

{% cut "Что такое `external_order_id`, `claim_id` и `idempotency_key`?" %}

Параметр `external_order_id` — это уникальный идентификатор заказа в системе партнера. У каждой нового заказа должен быть свой, отличный от предыдущих параметр `external_order_id`. В значении `external_order_id` допускаются буквы, цифры и другие символы. Чтобы гарантировать уникальность значений, рекомендуем использовать формат `uuid` и его производные.

Параметр `claim_id` — это идентификатор заказа в сервисе автономных роботов Яндекса. Этот идентификатор генерируется автоматически в формате `uuid` и возвращается при создании заказа.

Параметр `idempotency_key` — это признак идемпотентности, который передается как параметр запроса. Использование `idempotency_key` позволяет выполнить один и тот же запрос несколько раз с гарантией, что действие произойдет не более одного раза. Например, если вы отправите запрос на открытие крышки робота дважды с одним и тем же `idempotency_key`, фактически крышка будет открыта только один раз.

{% endcut %}

{#size-weight}

{% cut "Нужно ли передавать габариты и вес заказа?" %}

Нет, в запросе API передавать габариты и вес заказа не нужно. Но нужно учитывать ограничения робота:

{% include notitle [size-weight](_includes/size-weight-b9d0352e9828.md) %}

{% endcut %}

{#coordinates}

{% cut "Как передавать координаты точек?" %}

Координаты (поле `route_points[].address.coordinates[]`) нужно передавть обязательно в таком порядке: `[долгота, широта]`.

{% endcut %}

{#route-points}

{% cut "Как правильно указать идентификаторы точек и порядок их посещения?" %}

Поле `route_points[].point_id` задает уникальный идентификатор точки на маршруте, это может быть произвольное целое число. 

Поле `route_points[].visit_order` задает порядковый номер точки на маршруте. Точка, откуда требуется забрать товар, должна иметь номер 1. Следующая точка, куда надо доставить товар, — номер 2, и так далее. 

Если вы предполагаете, что получатель может отказаться от заказа и вернуть его, укажите в заказе точку, куда нужно доставить возвращаемый заказ (если она не совпадает с точкой отправления).

{% endcut %}

{#eta}

{% cut "Как узнать планируемое время доставки заказа?" %}

Ожидаемое время доставки возвращается при создании заказа в поле `performer_info.claim.eta`. Пока заказ выполняется, время пересчитывается с учетом текущей ситуации на дорогах и местоположения робота. Чтобы уточнить ожидаемое время доставки, используйте запрос [Информация о заказе](https://yandex.ru/dev/sdg-robot/ru/ref/claims/info_handler_claims_info_post).

{% endcut %}

{#modify}

{% cut "Можно ли изменить созданный ранее заказ?" %}

Изменить заказ нельзя. Можно [отменить](https://yandex.ru/dev/sdg-robot/ru/ref/claims/cancel_handler_claims_cancel_post) заказ и [создать](https://yandex.ru/dev/sdg-robot/ru/ref/claims/create_handler_claims_create_post) его заново.

{% endcut %} 

<!--{% cut "Как отправитель узнает, за каким заказом приехал робот? Если у робота в кузове несколько заказов, как получатель поймет, какой заказ предназначен для него?" %}

{#order}

????

{% endcut %} -->

## Оценка заказа {#claim-estimation}

{#estimate}

{% cut "Сколько времени занимает оценка заказа?" %}

Когда заказ передается на оценку, время ожидания составляет около 1 секунды.

Статус заказа можно узнать с помощью метода [Информация о заказе](https://yandex.ru/dev/sdg-robot/ru/ref/claims/info_handler_claims_info_post).

{% endcut %} 

<!-- {#version}

{% cut "Что такое version — версия заказа?" %}

????

{% endcut %} -->

## Подтверждение заказа {#claim-approval}

{#claim-accept}

{% cut "Как подтвердить созданный заказ?" %}

Сейчас заказ автоматически подтверждается сервисом сразу после оценки. Отправлять дополнительный запрос для подтверждения заказа не нужно.

<!-- Для подтверждения заказа нужно, чтобы он успешно прошел процедуру оценки. Оценка происходит автоматически и занимает несколько секунд, после чего заказ переходит в статус `ready_for_approval`, то есть готов к подтверждению. Уточнить статус заказа можно с помощью методов [Информация о заказе](https://yandex.ru/dev/sdg-robot/ru/ref/claims/handler_claims_info_post) или [Журнал изменений](https://yandex.ru/dev/sdg-robot/ru/ref/claims/handler_claims_journal_post).

Подтвердить заказ можно в течение 10 минут после получения статуса `ready_for_approval`. Если в течение этого срока заказ не подтвержден, он автоматически отклоняется сервисом. -->

{% endcut %}

{#performer-assigned}

{% cut "Как назначается робот на мой заказ?" %}

Робот-исполнитель [автоматически подбирается сервисом](https://yandex.ru/dev/sdg-robot/ru/quick-start.md) с учетом текущего местоположения и статуса. 

При желании вы можете [сами выбрать и назначить робота-исполнителя](https://yandex.ru/dev/sdg-robot/ru/use-cases.md#select-performer) на свой заказ. Для этого вам нужно сначала найти свободных роботов, выбрать из них исполнителя и при создании заказа указать его VIN-номер.

{% endcut %} 

## Отслеживание заказа {#claim-control}

{#claim-info}

{% cut "Как я могу получить информацию о смене статуса заказа?" %}

Информацию о текущем статусе заказа можно получить с помощью методов [Информация о заказе](https://yandex.ru/dev/sdg-robot/ru/ref/claims/info_handler_claims_info_post) или [Журнал изменений](https://yandex.ru/dev/sdg-robot/ru/ref/claims/journal_handler_claims_journal_post). 

При запросе [информации о заказе](https://yandex.ru/dev/sdg-robot/ru/ref/claims/info_handler_claims_info_post) возвращается также плановое время доставки ETA (`performer_info.claim.eta`), оно пересчитывается при каждом выполнении запроса с учетом текущих условий (пробки на дорогах и пр.).

{% endcut %}

{#eta}

{% cut "Как узнать, не изменилось ли плановое время доставки заказа?" %}

При каждом запросе [информации о заказе](https://yandex.ru/dev/sdg-robot/ru/ref/claims/info_handler_claims_info_post) ожидаемое время доставки (`eta`) пересчитывается с учетом текущей ситуации на дорогах (пробки и пр.), текущего местонахождения и статуса робота.

{% endcut %}

{#rover-inform}

{% cut "Как я могу получить информацию о том, где находится робот с моим заказом?" %}

Информация о роботе возвращается при запросе [информации о заказе](https://yandex.ru/dev/sdg-robot/ru/ref/claims/info_handler_claims_info_post), в теле ответа в разделе `courier`. В том числе там указан VIN-номер робота (`vin`). 

По VIN-номеру вы можете [посмотреть все события](https://yandex.ru/dev/sdg-robot/ru/ref/couriers/journal_handler_couriers_journal_post), происходившие с роботом.

{% endcut %}

## Отмена и возврат заказа {#cancel-return}

{#cancel}

{% cut "Как отменить заказ?" %}

Вы можете [отменить заказ](https://yandex.ru/dev/sdg-robot/ru/ref/claims/cancel_handler_claims_cancel_post) вплоть до момента, пока не подтверждено получение груза клиентом.

Если груз еще не находится в роботе, заказ после отмены сразу получает статус `cancelled`. 

Если груз уже находится в роботе, но еще не [подтверждена](https://yandex.ru/dev/sdg-robot/ru/ref/claims/confirm_exchange_handler_claims_confirm_exchange_post) его доставка, запускается [процедура возврата груза](https://yandex.ru/dev/sdg-robot/ru/use-cases.md#cancelled) в точку погрузки.

{% endcut %}

{#return}

{% cut "Как получатель может вернуть заказ?" %}

Клиент может вернуть заказ только сразу после получения, пока робот еще не уехал с точки доставки. Для возврата используйте метод [отмены заказа](https://yandex.ru/dev/sdg-robot/ru/ref/claims/cancel_handler_claims_cancel_post), он запустит [процедуру возврата груза](https://yandex.ru/dev/sdg-robot/ru/use-cases.md#returned) в точку погрузки.

{% endcut %}

{#incident}

{% cut "Если заказ отменен сервисом из-за неисправности робота, что дальше происходит с заказом?" %}

Если с роботом случилась неисправность и заказ не может быть доставлен, он будет автоматически отменен. В ответе на запрос [информации о заказе](https://yandex.ru/dev/sdg-robot/ru/ref/claims/info_handler_claims_info_post) будет возвращен статус `cancelled`.

После этого вам нужно [связаться с поддержкой](https://yandex.ru/dev/sdg-robot/ru/support.md) и обсудить варианты решения проблемы.

{% endcut %} 

{% include notitle [feedback](_includes/feedback-96015e8dc7c1.md) %}