Інтеграція служби доставки PickPoint на сайт
PickPoint — російська мережа постаматів та пунктів видачи замовлень. Охоплює понад 4000 постаматів по всій Росії. Особливість: покупець забирає замовлення в зручний час без очікування кур'єра. Для інтернет-магазинів це знижує навантаження на службу доставки та зменшує процент невикупленних замовлень.
API PickPoint
PickPoint надає SOAP та REST API. Документація та sandbox доступні в особистому кабінеті партнера. Для підключення потрібні IKN (ідентифікатор клієнта) та login/password.
Отримання списку постаматів
GET https://e-solution.pickpoint.ru/api/postamatlist
// Відповідь: масив постаматів з координатами, адресами, режимом роботи
[
{
"PostamatId": "MSK001",
"Name": "Постамат у метро Арбатська",
"Address": "Москва, ул. Арбат, 5",
"GpsX": "55.752023",
"GpsY": "37.592175",
"WorkTime": "Пн-Вс 7:00-23:00",
"MaxWidth": 39, "MaxHeight": 64, "MaxDepth": 56,
"MaxWeight": 30
}
]
Список краще кешувати — він оновлюється раз на добу. Зберігати в Redis або в таблиці БД з updated_at.
Розрахунок вартості
POST /api/calcprice
{
"IKN": "your_ikn",
"FromCity": "Москва",
"PostamatId": "MSK001",
"SubEncloses": [{"GoodsCount": 1, "Weight": 500, "Width": 15, "Height": 10, "Depth": 5}],
"Sum": 1500, // оголошена вартість
"SumNP": 0 // наложений платіж
}
Створення відправлення
POST /api/CreateShipment
{
"IKN": "your_ikn",
"Login": "login",
"Password": "password",
"Shipments": [{
"EDTN": "ORDER_12345", // ваш номер замовлення
"PostamatId": "MSK001",
"InEncloses": [{
"Number": "1",
"Quantity": 2,
"Goods": [{"Name": "Футболка", "Weight": 300, "Price": 750}]
}],
"ClientName": "Іванова Марія Іванівна",
"ClientPhone": "+79001234567",
"Sum": 1500,
"GettingType": 1
}]
}
У відповіді приходить InvId — внутрішній номер PickPoint, необхідний для подальших запитів.
Трекінг через вебхуки
PickPoint відправляє статусні сповіщення на настроєну URL. Статуси: замовлення прийнято, передано в доставку, прибуло в постамат, видано покупцю, повернено.
Друк етикеток
POST /api/getlabel
// Повертає PDF-файл з етикеткою для наклеювання на посилку
Етикетка друкується та наклеюється на посилку перед передачею в PickPoint.
Строки
Підключення з вибором постамата на карті, створенням відправлень та трекінгом — 3–4 робочих дні.