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

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

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

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

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

• вес заказа не более 20 кг;
• габариты заказа не более 420×490×297 мм.

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

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

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

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

Ожидаемое время доставки возвращается при создании заказа в поле performer_info.claim.eta. Пока заказ выполняется, время пересчитывается с учетом текущей ситуации на дорогах и местоположения робота. Чтобы уточнить ожидаемое время доставки, используйте запрос Информация о заказе.

Изменить заказ нельзя. Можно отменить заказ и создать его заново.

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

Статус заказа можно узнать с помощью метода Информация о заказе.

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

Робот-исполнитель автоматически подбирается сервисом с учетом текущего местоположения и статуса.

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

Информацию о текущем статусе заказа можно получить с помощью методов Информация о заказе или Журнал изменений.

При запросе информации о заказе возвращается также плановое время доставки ETA (performer_info.claim.eta), оно пересчитывается при каждом выполнении запроса с учетом текущих условий (пробки на дорогах и пр.).

При каждом запросе информации о заказе ожидаемое время доставки (eta) пересчитывается с учетом текущей ситуации на дорогах (пробки и пр.), текущего местонахождения и статуса робота.

Информация о роботе возвращается при запросе информации о заказе, в теле ответа в разделе courier. В том числе там указан VIN-номер робота (vin).

По VIN-номеру вы можете посмотреть все события, происходившие с роботом.

Вы можете отменить заказ вплоть до момента, пока не подтверждено получение груза клиентом.

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

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

Клиент может вернуть заказ только сразу после получения, пока робот еще не уехал с точки доставки. Для возврата используйте метод отмены заказа, он запустит процедуру возврата груза в точку погрузки.

Если с роботом случилась неисправность и заказ не может быть доставлен, он будет автоматически отменен. В ответе на запрос информации о заказе будет возвращен статус cancelled.

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