A1 · Яндекс Доставка · Создание заявки на экспресс-доставку
MCP-инструмент (tool) для Яндекс Доставки: помогает подготовить в корпоративном аккаунте заявку на доставку день в день.
Техническое имя: express_create_claim
Какую задачу решает
Я хочу создать заявку с маршрутом, товарами и контактами, чтобы получить финальную оценку перед запуском доставки.
Когда использовать
Используйте инструмент после предварительного расчёта или когда все данные отправления уже подтверждены. По умолчанию созданную заявку нужно отдельно принять после оценки.
Что нужно передать
- товары, количество, стоимость, вес и при необходимости габариты;
- от 2 до 300 точек маршрута с порядком посещения;
- контакты и адреса отправителя и получателей;
- обязательный класс доставки;
- при необходимости время подачи, комментарий, webhook и дополнительные условия.
Что вернёт
Идентификатор заявки claim_id, статус, версию, маршрут, рассчитанные условия и время создания.
Что изменится в Яндекс Доставке
В аккаунте появится реальная заявка. Без auto_accept=true она проходит оценку и ожидает отдельного подтверждения; поиск курьера ещё не начинается. При auto_accept=true заявка может быть подтверждена автоматически после успешной оценки.
Пример запроса
Создай заявку на доставку этой коробки сегодня, но не подтверждай её после расчёта.
Возможные ошибки и ограничения
- заявка должна содержать как минимум точку забора и точку вручения;
- адреса, контакты и обязательные поля проходят проверку API;
- повтор с тем же
request_idвозвращает ту же заявку; если идентификатор не передан, сервер создаёт UUID.
Связанные MCP-инструменты
- express_check_price — предварительно проверить цену;
- express_get_claim — дождаться оценки и получить версию;
- express_accept_claim — запустить доставку.
Технические сведения
- Воздействие: изменяет данные
- Контур: Express
- Создание заказа: создаётся заявка; запуск зависит от подтверждения
- Полный технический справочник