ЖелДорЭкспедиция: агент для заявок и статусов

ЖелДорЭкспедиция — транспортная компания с открытым REST API: заявки, расчёт, статусы и документы. Карточка для логиста, который оформляет перевозки и следит за отправлениями вручную.

Агент — программа, которая выполняет работу до конца. Вы описываете задачу, он сам обращается к API, забирает ответ и собирает итог.

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

Чат-бот покажет номер накладной. Агент принесёт таблицу отправлений со статусами и списком тех, где движение встало.

Коннектор — описание доступа: где взять ключ, как проверить связь, какие методы открыты. На портале для разработчиков ЖДЭ есть раздел авторизации и пункт получения API-ключа: запросы идут с парой user и token.

Это не плагин и не доработка вашей учётной системы. Пароль агент не хранит, он работает с выданным ключом и только по тем методам, что ему открыли.

API ЖДЭ описывает заявки, отправления, услуги, географию и справочники: создание заявки, получение новых статусов, статус по номеру накладной в полном и упрощённом виде, запрет на выдачу груза, коды услуг и пакет документов.

Есть расчёт перевозки двумя методами, поиск терминалов по КЛАДР и справочник категорий груза. Отдельно описан раздел электронных перевозочных документов.

### Отгрузка и статусы доставки

Агент собирает статусы по списку отправлений, приводит их к понятным этапам и отмечает те, где груз стоит дольше обычного. Проверяет, что по каждой заявке есть номер накладной, и поднимает документы. Итог — сводка по дням и список отправлений, требующих звонка на терминал. Отдельно агент отмечает отправления, по которым стоит запрет на выдачу, чтобы кладовщик не отдал груз без решения логиста.

### Контроль поставок: сроки и недопоставки

Агент сверяет плановую дату с фактическим движением и считает просрочку по каждой заявке. Если в заявке был признак страхования груза или отметка об учёте в государственных системах, он проверяет, что параметр передан. На выходе — список недопоставок с причиной. Если груз задержался на складе забора, агент пишет, чей это склад — ваш или терминала, чтобы претензию направили по адресу.

### Тарифы доставки: сравнение и расчёт

Агент прогоняет один и тот же груз через методы расчёта и раскладывает ответ на составляющие: перевозка, жёсткая упаковка, доставка, забор. Сравнивает варианты по габаритам и категории груза. Итог — таблица сравнения, где видно, из чего сложилась каждая сумма. Варианты с жёсткой упаковкой он выносит отдельными строками: их часто заказывают уже после того, как груз привезли на терминал.

Спорная перевозка, претензия и выбор подрядчика — за логистом. Агент не отменяет заявки и не подписывает документы.

Нужен договор с ЖелДорЭкспедицией: ключ и токен выдаёт менеджер, порядок описан на портале для разработчиков. Для заявок с автоэкспедированием обязательно нужен адрес склада забора или доставки.

Не подписывает перевозочные документы вместо вас. Не меняет заявку без подтверждения и не обещает методов, которых нет в описании.

Что такое агент, если коротко? — Программа, которая сама создаёт заявки и собирает статусы по API и приносит сводку с просрочками. Вам не нужно сверять накладные в кабинете.

Что такое коннектор? — Описание доступа к API ЖДЭ: какой ключ выдан, какие методы открыты, как проверяется связь. Ваша система не меняется.

Что нужно, чтобы заявка прошла? — Кроме ключа нужны корректные адреса склада и категория груза: без них сервис вернёт ошибку. Агент проверит обязательные поля до отправки.