# ПЭК

Считайте перевозку ПЭК и следите за грузами прямо в чате

Грузоперевозки: расчёт стоимости и сроков, отделения и зоны, статусы грузов, заявки на перевозку

## Как агент работает с ПЭК

Агент ходит в API личного кабинета ПЭК на kabinet.pecom.ru: находит филиал и тарифную зону по адресу, подбирает отделения под вес и габариты груза, считает стоимость и сроки по нужным продуктам (сборный груз, EasyWay, авиа), читает статусы грузов и их историю, а также справочники получателей, наименований груза и упаковок.

Расчёт у ПЭК начинается не с города, а с адреса: сначала агент определяет, какой филиал обслуживает адрес и какой у него основной склад, и только потом зовёт калькулятор. Габариты передаются в метрах, вес в килограммах, по каждому месту отдельно, и агент их не выдумывает: берёт из карточек товаров МоегоСклада или маркетплейса либо спрашивает у вас.

На запись агент умеет подать заявку на перевозку, аннулировать заявку по коду груза и вести справочник получателей. Каждое такое действие он сначала показывает целиком и отправляет только после вашего подтверждения, потому что ошибка в заявке стоит реального рейса машины и денег, а повторная подача создаёт второй груз.

Ключ API вводится один раз вместе с логином кабинета и подписывает каждый запрос. ПЭК пускает не больше 100 запросов в минуту на логин, поэтому агент держит темп около полутора запросов в секунду, а статусы спрашивает пачками по коду груза. Логическую ошибку ПЭК возвращает телом ответа, и агент показывает её текст, а не пустую таблицу.

## Сценарии интеграции

### Расчёт перевозки по адресам
Агент найдёт филиал и склад ПЭК для адресов отправителя и получателя, посчитает стоимость и сроки сборного груза и авиа и покажет, из чего сложилась цена.

### Склад под габариты груза
Агент подберёт ближайшие к клиенту отделения, которые примут груз с вашим весом и габаритами, и отсеет склады, где такой груз не выдают.

### Статусы грузов в пути
Агент соберёт статусы по списку кодов грузов и историю их смены и пришлёт сводку: что едет, что прибыло и что стоит на складе дольше обычного.

### Заявка на перевозку
Агент соберёт заявку с забором или самопривозом, покажет её целиком (адреса, места, вес, плательщика) и подаст в ПЭК только после вашего подтверждения.

### Грузы за период
Агент поднимет все грузы ваших контрагентов за нужные даты и сведёт их в таблицу с номерами заказов, статусами и складами.

### Этикетки и заявки в PDF
Агент заберёт печатную форму заявки или этикетки мест по коду груза, так что искать их в личном кабинете вручную не придётся.

## Как подключить

**Перед подключением**

- Логин личного кабинета ПЭК и ключ API из раздела «Регистрационные данные»
- Подтверждение с вашей стороны перед подачей и аннулированием заявки

### Войдите в kabinet.pecom.ru
Нужна учётная запись личного кабинета клиента ПЭК: её логин и есть логин подключения.

### Откройте «Регистрационные данные»
В блоке «Ключи API» выпустите новый ключ. Для агента лучше завести отдельный, чтобы отзывать его независимо.

### Скопируйте логин и ключ
Ключ служит паролем. Грузы контрагентов и документы видны только с расширенным личным кабинетом.

## Частые вопросы

### Как подключить ПЭК?
Логином от личного кабинета kabinet.pecom.ru и ключом API. Ключ выпускается в разделе «Регистрационные данные», блок «Ключи API»; для агента лучше завести отдельный ключ, чтобы его можно было отозвать, не трогая другие интеграции.

### Что агент видит в ПЭК?
Филиалы, склады и тарифные зоны, расчёт стоимости и сроков, статусы и историю грузов, грузы контрагентов за период, печатные формы заявок и этикеток, справочники получателей, наименований груза и упаковок.

### Пишет ли агент в ПЭК?
Да: агент может подать заявку на перевозку, аннулировать её по коду груза и изменить справочник получателей. Все такие действия он согласует с вами перед отправкой, остальное сводится к расчётам и чтению статусов.

### Какие лимиты у API?
Не больше 100 запросов в минуту на логин. Статусы грузов агент запрашивает пачками (до 15 кодов в одном запросе полного статуса), поэтому даже большой список укладывается в лимит.

[Открыть ПЭК](https://kabinet.pecom.ru)