Интеграция службы доставки PickPoint на сайт
PickPoint — российская сеть постаматов и пунктов выдачи заказов. Охват более 4000 постаматов по всей России. Особенность: покупатель забирает заказ в удобное время без ожидания курьера. Для интернет-магазинов это снижает нагрузку на службу доставки и уменьшает процент невыкупленных заказов.
API PickPoint
PickPoint предоставляет SOAP и REST API. Документация и sandbox доступны в личном кабинете партнёра. Для подключения нужно заключить договор с PickPoint и получить 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 рабочих дня.