Получение пунктов самовывоза / постаматов


Получение пунктов самовывоза / постаматов

/service/terminals

Получение списка пунктов самовывоза и/или постаматов.
Используйте дополнительные параметры запроса для уточнения поиска.

Важно: как правило, справочник ПВЗ/постаматов у транспортных компаний обновляется не чаще 1 раза в сутки, поэтому мы рекомендуем кэшировать данные на своей стороне и обновлять по необходимости или периодически не чаще 1 раза в сутки.

Параметр Описание
key Ключ доступа
service Код службы доставки.

Доступны значения: sdek, dpd, iml, kit, zde, ozon, pecom, baikal, delline, vozovoz, boxberry, energija, fivepost, pickpoint, sberlogistics.

code Код пункта самовывоза/постамата.

Указание данного параметра отменает все остальные параметры, указанные ниже, т.к. однозначно определяет требуетмый ПВЗ.

settlement Название населённого пункта ИЛИ ФИАС-код ИЛИ КЛАДР-код населённого пункта.

Обязательно, если не указан code

region Название (или часть названия) региона, например: «Москов»

Ограничит поиск населённых пунктов подходящим регионом

address Строка, содержащая часть адреса, например название улицы или иного объекта

Позволяет найти ПВЗ / постамат по его адресу

is_postamat Является постаматом: да/нет

Можно передавать как целое (0 или 1), так и булево (true или false) значения

only_branches Отдавать только отделения ТК (без партнёрских): да/нет

Можно передавать как целое (0 или 1), так и булево (true или false) значения

Параметры, отмеченные , - обязательны.

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

curl --request POST 'https://api.esplc.ru/service/terminals' \
--header 'Content-Type: application/json' \
--data-raw '{"key": "a2275ee6a7f268684fb553db39ff16b6","service":"sdek"}'

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api.esplc.ru/service/terminals',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{ "key": "a2275ee6a73268684fb753db39ff16b6","service":"sdek"}',
  CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
]);

$response = curl_exec($curl);

curl_close($curl);
print_r(json_decode($response,1));

{
    "http_status": 200,
    "http_status_message": "",
    "data": {
        "packages": {
            "PACKAGE_1": "Коробка размером 310*215*280мм",
            "PACKAGE_2": "Коробка размером 430*310*280мм",
            // ...
        },
        "cargo": {
            "THERMAL_MODE": "Тепловой режим",
            "DANGER_CARGO": "Опасный груз",
            // ...
        },
        "recipient": {
            "CALL": "Предварительный прозвон получателей перед доставкой",
            "NOTIFY_ORDER_CREATED": "Уведомление получателя по СМС о создании заказа в СДЭК",
            // ...
        },
        "other": {
            "INSURANCE": "Страхование",
            "DELIV_WEEKEND": "Доставка в выходной день",
            // ...
        }
    }
}