Pony Express: ИИ-агент для отгрузки и статусов

Pony Express — служба экспресс-доставки с открытым XML-сервисом: заказы, тарифы, трекинг и накладные. Карточка нужна логисту, который ведёт отгрузки и сверяет сроки по десяткам отправлений.

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

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

Чат-бот объяснит, какие поля нужны для отправления. Агент заполнит их сам и покажет ответ перевозчика.

Коннектор описывает доступ: где взять ключ, что видно, как проверить связь. Ключ Pony Express выдают по заявке — форма на api.p2e.ru/Key/Connect, номер основного договора, тип интеграции. Заявку подтверждает менеджер: тестовый ключ приходит на почту, промышленный — после тестирования.

Это не плагин. Пароль агент не хранит: он работает с ключом, а ключ привязан к категории — интернет-магазин, веб, трансграница или пункт выдачи.

Обмен идёт по XML: запрос с режимом оформления заказа или расчёта, в ответ приходят статус и номера. Заказ создаётся той же категории, что и ключ: с ключом интернет-магазина трансграничный заказ не оформить.

В ответе есть статус Processing, номер накладной и номер заказа перевозчика. Доступны отмена заказа, печать наклейки, список городов, виджет выбора пункта выдачи. География — Россия, СНГ и дальнее зарубежье. Есть торговое посредничество: курьер получает деньги за товар.

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

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

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

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

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

Перед отгрузкой агент отправляет тот же запрос в режиме расчёта и получает блок тарифов со статусом Calculated. Дальше сравнивает доставку до двери и до пункта выдачи, подставляет город и вес из заказа, отдаёт короткую таблицу. На расчёт перевозчик просит не больше одного заказа в запросе и не больше пятидесяти обращений в минуту — очередь агент держит сам.

Договор, категорию ключа и спорную отгрузку подтверждает сотрудник. Он же решает, что делать с возвратом.

Заявку на ключ оформляет менеджер перевозчика: номер договора, тип интеграции, функционал. Проверка связи — расчёт тарифа по известному маршруту.

Не оформляет договор и не получает ключ без менеджера. Не меняет адрес в созданном заказе. Не обещает срок доставки от себя — только ответ перевозчика.

Что такое агент, если коротко? Программа, которая доводит дело до результата: проверяет заказ, оформляет отправление, забирает номер накладной и приносит статусы в вашу систему.

Что такое коннектор? Описание подключения: где взять ключ, к какой категории он относится, как проверить связь. Пароль сотрудника агенту не передают.