🇬🇪 QuickShipper: OAuth-клиент и выбор курьеров Грузии
QuickShipper — агрегатор доставки по Грузии: собственный флот плюс подключённые местные службы. Одна карточка даёт покупателю на оформлении заказа несколько вариантов курьеров с ценой и сроком каждого.
Где настраивается: Панель управления → «Отправления» → кнопка «Службы доставки» (или карточка точки → WEB → «Службы доставки»).
Что понадобится#
- для песочницы — логин и пароль тестового кабинета test.quickshipper.ge (регистрация свободная, ключи не нужны);
- для боевого контура — OAuth-клиент Delivery API: Client ID и Client secret (выдаёт служба по запросу, самостоятельно в кабинете не выпускается);
- адрес, город, координаты и телефон точки, откуда курьер забирает заказы.
Песочница: тестовый кабинет#
- Зарегистрируйтесь на test.quickshipper.ge.
- Подключите курьеров: Parameters → Integration → Activation of courier services. Для пробы хватит кнопки «Add your own delivery type» — свой тип доставки с названием и ценой; без подключённых курьеров тарифов не будет.
- Впишите логин и пароль этого кабинета в карточку службы, Client ID оставьте пустым — тестовый клиент Delivery API у QuickShipper общий и опубликован в их документации.
Боевой контур: ключи у службы#
- Заведите бизнес-аккаунт на qshpr.com.
- Напишите на info@qshpr.com: «прошу выдать доступ к Delivery API для интеграции интернет-магазина», укажите email аккаунта.
- Служба пришлёт Client ID и Client secret (иногда — ещё логин и пароль для входа по логину) и проведёт приёмку интеграции.
Что вписать в карточку службы#
| Поле | Что вписать |
|---|---|
| Логин и пароль кабинета | в песочнице — от test.quickshipper.ge (этого достаточно); в боевом контуре — только если служба выдала доступ по логину |
| Client ID | только для боевого контура: идентификатор OAuth-клиента из письма службы |
| Client secret | только для боевого контура: секрет клиента из письма |
| Контур | «Песочница» до приёмки у службы, «Боевой» — после |
| Адрес и город отправителя | откуда курьер забирает посылки |
| Координаты отправителя | широта и долгота точки забора, например 41.7151, 44.8271 — QuickShipper считает цену по расстоянию |
| Имя и телефон отправителя | контакт для курьера, телефон в формате +995… |
| Ограничить провайдеров | необязательно: номера провайдеров QuickShipper через запятую; пусто — все подключённые |
Проверка#
- Нажмите «Сохранить».
- Нажмите «Проверить подключение»: под карточкой появятся тарифы провайдеров. Надпись «Мок-режим» означает, что ключи не подключены и тарифы демонстрационные.
- Отметьте «Включить QuickShipper».
Песочница и боевой контур#
- Без ключей карточка показывает демонстрационные тарифы.
- Контур «Песочница» — настоящие ответы тестового сервера QuickShipper. Покупатель такие тарифы не видит, накладная из заказа не создаётся: тестовый заказ никто не повезёт.
- Контур «Боевой» — включайте, когда служба подтвердит, что интеграция прошла приёмку. С этого момента тарифы QuickShipper появляются у покупателя на оформлении заказа, а из карточки заказа создаётся накладная.
Частые проблемы#
- Ответа на письмо нет — напишите повторно или позвоните в поддержку QuickShipper: доступ к API выдают вручную.
- «Проверить подключение» пишет ошибку авторизации — проверьте, что выбран тот же контур, для которого выданы ключи: логин тестового кабинета не работает в боевом контуре, а боевые ключи — в песочнице.
invalid_grant — Invalid password— неверный пароль кабинета. - Тарифов нет — в кабинете QuickShipper не подключено ни одного курьера («Activation of courier services»), у точки забора не заданы координаты или адрес покупателя вне зоны провайдеров.
- Накладная не печатается в песочнице — генератор накладных тестового сервера QuickShipper сейчас не работает; заказ при этом создаётся.
Ссылки#
- Сайт службы: https://qshpr.com/
- Документация API (Swagger): https://delivery-test.quickshipper.ge/swagger/