API
URL: https://api.eshoplogistic.ru/api/
Method: POST
{
"success": true,
"status": 200,
"msg": "",
"data": {
...
}
}
С каждым запросом обязательно передаётся параметр key
со значением api-ключа соответствующего домена.
Ключ API для сайта
Ключ api для каждого домена указан на странице настройки сайтов: https://eshoplogistic.ru/domains.

Сохраняйте api-ключи в тайне. Внимание
Методы
Данные аккаунта / информация по сайту
Например: https://api.eshoplogistic.ru/api/site |
В ответе содержится информация:
Этот запрос должен быть выполнен самым первым, т.к.
предоставляет данные о доступных службах и коде города-отправителя для каждой службы. |
Инициализация служб
Например: https://api.eshoplogistic.ru/api/init |
Предоставляет оперативную информацию об активных службах, связанных с ними способах доставки и комментариях. Этот запрос необходимо выполнять в качестве инициализации перед получением данных по конкретным службам. |
Поиск населённых пунктов для доставки
Например: https://api.eshoplogistic.ru/api/search |
Для России база данных населённых пунктов содержит более 196 000 значений, кроме самых мелких образований (садовые товарищества и т.п.). Доступные параметры:
При использовании в качестве значения названия города, параметр должен содержать не менее 3 символов.
Не зависит от раскладки клавиатуры и регистра символов. При использовании в качестве значения кода КЛАДР или ФИАС, должно быть указано точное значение. В ответе содержится информация:
Лимит количества результатов поиска - 10. Запрос на поиск города нужен только один для всех служб доставки, т.к. он возвращает идентификаторы города назначения сразу для всех служб. ВниманиеНе нужно дублировать запрос поиска города для каждой службы отдельно. Для удобства из результатов поиска удаляются населённые пункты, куда не производит доставки ни одна из включённых в личном кабинете служб доставки. Внимание |
Расчёт стоимости и сроков доставки
Например:
|
Доступные параметры Основные:
Дополнительные:
Для передачи состава заказа можно использовать специальный параметр
В ответе содержится информация:
К ответу можно добавить полный список комментариев с помощью параметра Не пустое значение |
Поиск населённого пункта по IP-адресу (геопозиционирование)
Например: https://api.eshoplogistic.ru/api/geo |
Доступные параметры:
В случае успешного определения населённого пункта, будет возвращён ответ, аналогичный методу |
Все доступные варианты доставки
Например: https://api.eshoplogistic.ru/api/info |
Полный список всех доступных способов доставки. |
Все варианты доставки одним запросом
Например: https://api.eshoplogistic.ru/api/delivery/all |
Данный метод не рекомендуется использовать т.к. данные при таком запросе не кэшируются и время на обработку запроса будет определяться временем ответа самой медленной из запрашиваемых служб. ВниманиеПолучить сразу все данные по всем доступным вариантам доставки. Доступные параметры:
|
Ошибки
В случае ошибки статус ответа сервера равен 400.
Примеры кода
Для тестирования запросов удобно использовать Postman .
PHP / CURL
$data = [
'key' => 'ваш api-ключ',
'from' => 44,
'to' => 430,
'weight' => 2
];
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'https://api.eshoplogistic.ru/api/delivery/sdek');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_TIMEOUT, 10);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
$result = curl_exec($curl);
curl_close($curl);
print_r(json_decode($result,1));
Пример использования
Схема варианта использования api в корзине на вашем сайте
Исходный файл схемы в формате draw.io
Особенности
-
Dostavista
В отличии от других служб доставки, Dostavista требует указания в параметреto
полного адреса доставки вплоть до номера дома.
Если запросить данные без адреса - ответ также будет получен, но в таком случае данные нельзя будет считать верными.
Изменение города-отправителя
Решение для магазинов, у которых есть несколько складов в разных городах.
Можно изменить дефолтный город-отправитель на любой другой путём замены при отправке запроса параметра from
на значение ФИАС-кода нужного города.
Формат указания ФИАС-кода: #код
.
Например, Владивосток:
#7b6de6a5-86d0-4735-b11a-499081111af8
ФИАС-код можно узнать на сайте Федеральной Адресной Системы: https://fias.nalog.ru/ExtendedSearch.
Добавление дополнительных параметров к запросу
При отправке запроса на расчёт доставки можно добавить дополнительные параметры включения страхования и услуг по упаковке груза.
В настоящее время параметр этот функционал работает только для ТК: Деловые Линии, ПЭК, Энергия, Байкал. Внимание
Например:
$data = [
'key' => 'ваш api-ключ',
'from' => 44,
'to' => 430,
'weight' => 2,
'additionally' => '{ "insurance":0, "package":"0x951783203a254a05473c43733c20fe72" }'
];
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'https://api.eshoplogistic.ru/api/delivery/sdek');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_TIMEOUT, 10);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
$result = curl_exec($curl);
curl_close($curl);
print_r(json_decode($result,1));
Переданные таким образом параметры страхования и упаковки переопределяют соответствующие настройки транспортной компании в Личном кабинете.
Коды дополнительных услуг упаковки груза
Услуга упаковки груза | Код |
---|---|
Деловые линии | |
Деревянная обрешётка | 0x838fc70baeb49b564426b45b1d216c15 |
Жёсткий короб | 0x8783b183e825d40d4eb5c21ef63fbbfb |
Картонная коробка | 0x951783203a254a05473c43733c20fe72 |
Комплекс «обрешётка + амортизация» | 0x9dd8901b0ecef10c11e8ed001199bf6e |
Комплекс «палетный борт + амортизация» | 0x9dd8901b0ecef10c11e8ed001199bf71 |
Воздушно-пузырьковая плёнка | 0xa8b42ac5ec921a4d43c0b702c3f1c109 |
Мешок | 0xad22189d098fb9b84eec0043196370d6 |
Энергия | |
Скотч | 86075440584123 |
Пломба пластиковая | 86015311037109 |
Стрейч-пленка | 86075440584122 |
Воздушно-пузырьковая плёнка | 86075440585634 |
Конверт А4 бумажный | 86015311038436 |
Сейф-пакет №1 | 86075440586045 |
Мешок полипропиленовый №1 | 86075440584124 |
Мешок полипропиленовый №2 | 86075440584125 |
Мешок полипропиленовый №3 | 86075440584544 |
Коробка картонная№1 | 86075440584126 |
Коробка картонная№2 | 86075440584127 |
Поддон (Паллет) №1 | 86075440584129 |
Обрешетка деревянная | 86015311038442 |
Обрешетка деревянная для стекла | 86075440584121 |
Байкал | |
Деревянная обрешетка | 25 |
Паллетирование | 19 |
Паллетный борт | 2797 |
ПЭК | |
Защитная упаковка | isHP |