Получение пунктов самовывоза / постаматов
/service/terminals
Получение списка пунктов самовывоза и/или постаматов.
Используйте дополнительные параметры запроса для уточнения поиска.
Важно: как правило, справочник ПВЗ/постаматов у транспортных компаний обновляется не чаще 1 раза в сутки, поэтому мы рекомендуем кэшировать данные на своей стороне и обновлять по необходимости или периодически не чаще 1 раза в сутки.
| Параметр | Описание |
|---|---|
| key | Ключ доступа |
| service |
Код службы доставки.
Доступны значения: sdek, dpd, iml, kit, zde, ozon, pecom, baikal, delline, vozovoz, boxberry, energija, fivepost, pickpoint, sberlogistics. |
| code |
Код пункта самовывоза/постамата.
Указание данного параметра отменает все остальные параметры, указанные ниже, т.к. однозначно определяет требуетмый ПВЗ. |
| settlement |
Название населённого пункта ИЛИ ФИАС-код ИЛИ КЛАДР-код населённого пункта.
Обязательно, если не указан |
| 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": "Доставка в выходной день",
// ...
}
}
}