Популярные сценарии

Нет свободных роботов для выполнения заказа

Если в сервис поступило больше заказов, чем есть свободных роботов, при оценке заказа сервис присвоит ему статус performer_not_found.

В этом случае есть два варианта поведения:

1 вариант, по умолчанию

Заказ сразу же автоматически отменяется и получает статус cancelled.

2 вариант

Вы можете оставить заказ в режиме performer_not_found и повторять попытки найти свободного робота-исполнителя в течение определенного времени. Для этого при создании заказа укажите время, до которого должен продолжаться поиск. Этот параметр нужно передать в теле запроса в блоке conditions в поле search_until. Это поле должно содержать значение даты и времени, указывающее, когда поиск должен прекратиться.

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

Текущий статус заказа можно посмотреть при запросе информации о заказе.

Выбор робота-исполнителя для заказа

Обычно робота-исполнителя для заказа выбирает и назначает сервис. Но вы можете самостоятельно выбрать робота и назначить его на заказ.

  1. Запросите список свободных роботов — в запросе в поле shift_status_in укажите free. Вы можете указывать и другие статусы.

    Запрос
    POST /couriers/search

    {
    "filters": { 
        "shift_status_in": "free"
    }
}

    В ответе возвращается список роботов, их статусы и координаты. Выберите робота и запомните его VIN-номер.

  2. Создайте заказ, указав VIN-номер выбранного робота в блоке conditions в параметре vin.

    Запрос
    POST /claims/create?idempotency_key=<your_idempotency_key>

    {
    "route_points": [
        {
        "address": {
            "coordinates": [
                55.733989, 
                37.588116
            ]
        },
        "point_id": "0",
        "type": "source",
        "visit_order": 0
        },
        {
        "address": {
            "coordinates": [
                55.735120, 
                37.642817
            ]
        },
        "point_id": "1",
        "type": "destination",
        "visit_order": 1
        }
    ],
    "external_order_id": "Order #1",
    "conditions": {
        "vin": "<your_selected_vin>"
    }
}

Партнер или клиент отменил заказ

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

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

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

  1. Отмените заказ.

  2. Проверяйте статус заказа:

    Пока робот везет груз в точку погрузки, заказ находится в статусе returning.

    Когда робот приезжает в точку погрузки, заказ получает статус return_arrived.

  3. Откройте крышку чтобы забрать груз, и заказ перейдет в статус ready_for_return_confirmation.

  4. Подтвердите, что забрали груз, и заказ получит статус returned.

  5. После этого заказ автоматически переходит в статус cancelled.

Клиент вернул заказ

Если робот доставил груз клиенту, а клиент отказался его забирать, верните груз в точку погрузки:

  1. Если клиент уже закрыл крышку робота, он снова открывает крышку.

  2. Клиент кладет груз и закрывает крышку.

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

  4. Проверяйте статус заказа:

    Пока робот везет груз в точку погрузки, заказ находится в статусе returning.

    Когда робот приезжает в точку погрузки, заказ получает статус return_arrived.

  5. Откройте крышку чтобы забрать груз, и заказ перейдет в статус ready_for_return_confirmation.

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

  7. После этого заказ автоматически переходит в статус cancelled.

Клиент не забрал заказ

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

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

Задержка доставки

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

Заказ не может быть доставлен

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

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

Список часто используемых точек

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

Этот список вы можете предоставлять клиентам в интерфейсе вашего онлайн-сервиса или мобильного приложения, чтобы упростить и ускорить оформление заказов.

Чтобы внести точки в список, обратитесь в службу поддержки.

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

Написать в службу поддержки
Предыдущая
Основной сценарий
Следующая
Обзор