Справочный центр
RU UZ

Zapp

Курьерская доставка Zapp: подключение по API-токену и Company ID, автоматическая отправка заказов, обратная синхронизация статусов и отмена доставки.

  • Где в меню: Настройки → Приложения → Zapp
  • Тарифы: Все тарифы
  • 6 мин чтения
Содержание
  1. Для чего эта страница
  2. Где найти
  3. Кто видит
  4. Обзор страницы
  5. Как сделать
  6. Подключить Zapp
  7. Подключить обратные статусы
  8. Выбрать, когда заказ уходит в Zapp
  9. Добавить Zapp как способ доставки на сайте
  10. Отменить доставку
  11. Отключить Zapp
  12. Как это работает
  13. Ограничения и важные нюансы
  14. Частые вопросы
  15. Связанные статьи

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

Для чего эта страница

  • Подключить магазин к своему аккаунту в Zapp.
  • Автоматически передавать курьеру заказы с доставкой — без ручного ввода в кабинете Zapp.
  • Выбрать, на каком статусе заказа он уходит в Zapp.
  • Получать статусы доставки из Zapp в заказы магазина.
  • Отменять доставку в Zapp вместе с отменой заказа.

Где найти

Боковое меню: Настройки → Приложения. Найдите Zapp в каталоге (категория «Доставка») и нажмите Подключить — откроется страница приложения.

На страницу также ведёт пункт Zapp в меню Подключить службу на странице Способы доставки — он открывает раздел Приложения.

Кто видит

Страница доступна сотрудникам с правом «Управлять приложениями и интеграциями». Это право даёт и подключение, и настройку, и удаление приложения.

Приложение бесплатное и доступно на всех тарифах. Сама доставка оплачивается Zapp по вашему договору с ним.

Обзор страницы

Окно «Настройки Zapp» с выбором статусов отправки и адресом вебхука статусов
Окно «Настройки Zapp» с выбором статусов отправки и адресом вебхука статусов
  1. Шапка — название Zapp и кнопки. До подключения — Установить. После подключения — Настройки и Удалить.
  2. Карточка приложения — значок, отметка Установлено, разработчик и описание.
  3. Окно «Настройки Zapp» — данные подключения, способ оплаты и тип доставки по умолчанию, блок Когда отправлять заказ в Zapp и поле URL вебхука статусов (укажите в Zapp).

Как сделать

Подключить Zapp

Данные для подключения выдаёт Zapp:

  • API-токен — ключ доступа к API Zapp;
  • Company ID — идентификатор вашей компании в Zapp;
  • Warehouse ID — склад, с которого курьер забирает заказы. Необязательно.
  1. Откройте страницу Zapp и нажмите Установить.
  2. В окне Подключение Zapp заполните API-токен, Company ID и при необходимости Warehouse ID.
  3. Выберите Способ оплаты и Тип доставки по умолчанию (подробнее — в разделе «Как это работает»).
  4. Нажмите Установить.

Подключить обратные статусы

  1. После установки нажмите Настройки.
  2. Скопируйте адрес из поля URL вебхука статусов (укажите в Zapp).
  3. Вставьте его в настройках подключения в кабинете Zapp.

Без этого шага заказы будут уходить в Zapp, но статусы доставки в магазин возвращаться не будут.

Выбрать, когда заказ уходит в Zapp

  1. Откройте Настройки.
  2. В блоке Когда отправлять заказ в Zapp отметьте один или несколько статусов:
    • При создании заказа (сразу, без подтверждения);
    • При подтверждении (Принят);
    • При обработке (Обработан);
    • При сборке (Собран).
  3. Нажмите Сохранить.

Заказ уходит в Zapp, когда впервые достигает любого из отмеченных статусов. По умолчанию отмечены «Принят» и «Обработан». Если снять все отметки, снова будут действовать настройки по умолчанию.

Добавить Zapp как способ доставки на сайте

Это необязательно: заказы уходят в Zapp при любом способе доставки, кроме самовывоза. Если хотите, чтобы клиент видел Zapp и стоимость доставки по своему адресу, добавьте способ доставки с типом Внешняя служба и службой Zapp — см. Способы доставки.

Отменить доставку

Отмените заказ в магазине — доставка в Zapp отменится автоматически. Отдельной кнопки отмены доставки нет.

Отключить Zapp

  1. Нажмите Удалить в шапке страницы.
  2. В окне Отключить Zapp нажмите Удалить.

Новые заказы перестанут уходить в Zapp, а уведомления о статусах от Zapp перестанут приниматься.

Как это работает

  • Какие заказы уходят в Zapp. Каждый заказ с доставкой, кроме самовывоза, — независимо от выбранного способа доставки. Заказ без способа доставки не передаётся.
  • Один раз. Заказ создаётся в Zapp только один раз, даже если потом достигнет ещё одного отмеченного статуса.
  • Что передаётся. Номер заказа, имя и телефон клиента, адрес доставки (и точка на карте, если она есть в заказе), позиции с названием, артикулом, штрихкодом, количеством и ценой, стоимость и название способа доставки, итог заказа, комментарий к заказу, Тип доставки и Warehouse ID из настроек.
  • Оплата курьеру. Способ оплаты заказа определяет, что делает курьер:
Оплата заказа Курьер
Наличные или карта при получении, заказ не оплачен Получает с клиента итог заказа
Онлайн-оплата (Payme, Click, Uzum, Multicard, Alifpay и др.) Ничего не получает
Заказ уже отмечен оплаченным Ничего не получает

Способ оплаты из настроек используется только для заказов, способ оплаты которых платформа не распознала.

  • Статусы из Zapp. Когда Zapp сообщает о смене статуса, статус заказа в магазине меняется автоматически, а в истории заказа появляется запись «Статус изменён автоматически через Zapp Delivery»:
Статус в Zapp Статус заказа в магазине
подтверждён Принят
готовится Обработан
готов, назначен курьер Собран
курьер в пути, забран, доставляется, перенесён Доставляется
доставлен Доставлен
отменён, возврат средств, возвращён Отменен
ожидает, неудачная доставка не меняется
  • Статус не откатывается назад. Если заказ в магазине уже продвинулся дальше, более ранний статус из Zapp не применяется. Отмена применяется всегда.
  • Отмена. Отмена заказа в магазине отменяет доставку в Zapp. Отмена со стороны Zapp отменяет заказ в магазине — и не отправляется обратно в Zapp повторно.
  • Ошибки. Если Zapp не принял заказ, отправка повторяется до трёх раз с паузами 5, 15 и 30 секунд. Заказ без телефона клиента в Zapp не отправляется: курьеру некуда звонить.

Ограничения и важные нюансы

  • Состав заказа после отправки не меняется. Zapp не принимает изменения позиций, суммы и адреса уже созданного заказа. Если вы часто правите заказы после подтверждения, отправляйте их в Zapp позже — например, при сборке (Собран).
  • Если в адресе заказа нет точки на карте, Zapp может не определить зону доставки.
  • Самовывоз в Zapp никогда не отправляется.
  • Если вы добавили собственный способ оплаты, которого платформа не знает, для него действует Способ оплаты из настроек. Проверьте, что он соответствует действительности: при значении «Наличные» курьер попросит у клиента оплату.

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

Заказ не появился в Zapp. Проверьте, что заказ не самовывоз, у клиента указан телефон и заказ дошёл до одного из статусов в блоке Когда отправлять заказ в Zapp.

Статус доставки не обновляется в магазине. Скопируйте URL вебхука статусов (укажите в Zapp) из Настройки и проверьте, что в кабинете Zapp указан именно он — вместе с частью ?secret=….

Я изменил позиции заказа, а в Zapp старый состав. Изменения после отправки в Zapp не передаются. Свяжитесь с Zapp или отмените заказ и оформите новый.

Нужно ли создавать способ доставки «Zapp»? Нет. Он нужен, только если клиент должен видеть Zapp и цену доставки на сайте.

Связанные статьи

Не нашли ответ? Напишите в поддержку.

Написать в поддержку

Разделы