Заказать товар с Amazon, Zara и других европейских магазинов через AI-ассистента

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

Расчёт предварительный. Доставка магазина считается по его настройкам, доставка получателю - по доступному тарифу для выбранного города. Отсутствующий тариф обозначается отдельно. Возможны отдельная доставка магазина, доставка получателю, ДТС за вес и габариты и применимая пошлина.

Стандартная международная перевозка уже включена в сервисный сбор. Её не нужно прибавлять повторно. ДТС для нестандартного отправления - отдельная возможная доплата.

Как подготовить корзину

1. Прочитайте discovery JSON: текущие разрешённые хосты магазинов и возможности. Страница магазина в справочнике не подтверждает поддержку любого его домена.
2. Откройте товар своим браузером. Сохраните точный URL с параметрами варианта. Соберите название, артикул, цену в евро, основное фото, размер, цвет и количество. Спросите только недостающее.
3. Проверьте наличие выбранного варианта и доставку в Германию. Для Amazon нужно подходящее европейское предложение, например Amazon.de; ссылка Amazon.com сама по себе не подтверждает выкуп. Для Zara проверьте европейскую версию и конкретный размер.
4. Заполните форму выше своим браузером или передайте готовый JSON по OpenAPI-контракту. Для отправки нужны браузерные инструменты или API-клиент; доступ только к поиску и чтению страниц сам по себе не позволяет создать корзину. Сервер не читает повторно страницу товара для заполнения переданных полей. Сборы сервиса считает сервер.
5. Верните конкретный share_url, basket_id и basket_code из успешного ответа, известную сумму и недостающие расходы.

Создавайте корзину по просьбе покупателя. Это не оплата и не выкуп. Не передавайте пароли, cookies, платёжные или паспортные данные.

Пакет товара v1

POST на https://catalogi.ru/ai-shopping/, заголовки Content-Type: application/json и Idempotency-Key (UUIDv4 либо 32 строчных hex-символа). Тело: {"version":1,"items":[...]}, 1-10 позиций, не больше 1 МиБ, 1-10 штук на позицию.

Позиция: url, name, size, color, sku, quantity, image_url, price, availability, delivery_to_germany. Для создания нужны название, вариант и основное фото. Передайте один источник: image_url (HTTPS) или image_base64 (обычный base64 без data URI). Для фото разрешены JPEG, PNG и WebP до 512 КиБ после декодирования, с длинной стороной от 600 пикселей. Передавайте только изображение товара без личных данных. Метаданные не сохраняются; сервер создаёт стандартное изображение WebP без обращения к странице магазина.

Для доставки можно передать destination: {"country":"RU","cdek_city_code":"44","method":"pickup"}. Код города найдите через поиск города: ?format=destinations&q=название. Сопоставьте город и регион с ответом покупателя. Способы: pickup, postamat, courier. Нужны код города СДЭК и способ, а не ФИО, телефон или паспорт. Данные получателя покупатель укажет при оформлении.

Размер size обязателен. Для товара без выбора размера передайте строку "0", а не пустую строку или предположенный размер.

Цена, наличие и доставка - факты с value, source_url, observed_at, basis. Цена также содержит currency: "EUR", значение - положительная строка с двумя знаками после точки, например "59.95". Не передавайте итог или сбор вместо цены магазина.

observed_at - целое Unix-время в секундах. basis: "observed" означает, что факт прочитан на странице; "user_supplied" - сообщил покупатель. Хост источника факта должен совпадать с хостом товара. Не выдавайте предположение или вывод по фото за наблюдение магазина. Наблюдения старше 15 минут нужно обновить. Полные актуальные сведения покупателя принимаются с basis: "user_supplied": повторное чтение страницы не обязательно. Они остаются непроверенными, а цена предварительной.

Неизвестные факты можно пропустить или передать null. Сервер вернёт недостающее; неизвестная цена не равна нулю, неизвестное наличие не равно true.

Повторы и ошибки

После сетевого сбоя повторите тот же запрос с тем же Idempotency-Key и телом. Изменённый товар, размер или количество требуют нового ключа. Не создавайте новые ключи в цикле при таймауте. Создайте ключ случайно и храните приватно, как ссылку на корзину: не публикуйте его в страницах или логах. 409 означает конфликт ключа или незавершённый запрос, 429 - ограничение частоты, 503 - временную недоступность. Учитывайте Retry-After, если он возвращён. 422 с error.missing_fields требует дополнить факты, 400 означает некорректный запрос. 403 - недопустимый Origin, 405 - метод, 413 - превышение размера, 415 - требуется JSON. Отправляйте запрос из AI-клиента без cookies и Authorization, а не из чужой веб-страницы. Ошибка не является созданной корзиной.

Результат для покупателя

Укажите товар и вариант, pricing.known_total_eur, pricing.known_total_rub, включённые pricing.components и недостающие pricing.missing_fields. price_final: false означает известную часть, а не цену «всё включено».

Поля created_at и expires_at задают время расчёта и срок актуальности в Unix-секундах. После истечения срока не выдавайте прежнюю сумму за актуальную: подготовьте новый расчёт. Ссылка на корзину и актуальность расчёта - разные вещи.

component_statuses.international_delivery: "included_in_service_fee_for_standard_shipment" означает, что стандартная международная перевозка включена в ССБ. international_delivery_eur: null означает, что её доля не выделена из ССБ, а не дополнительную неизвестную плату. ДТС обозначается отдельно как weight_dimensions_surcharge.

Верните конкретную ссылку из успешного ответа. Общий /sharebasket/ или главная не являются готовой корзиной. Не придумывайте ID, сумму или подтверждение оплаты. Покупатель проверяет условия, указывает получателя и самостоятельно оплачивает на сайте.

Условия

Общий срок зависит от выкупа у магазина, перевозчика и таможни. Ориентиры отдельных этапов и начало их отсчёта указаны в оферте; это не гарантированный срок от заказа до получения. Минимальный заказ 45 € с учётом сервисного сбора и доставки. Доставка магазина в Германию может оплачиваться отдельно. ДТС за вес и габариты отличается от таможенной пошлины; сумма может определиться после приёмки.

По п. 3.13 оферты ДТС составляет 11 €/кг полного фактического веса с упаковкой при указанных там условиях. Исключение: одна единица повседневной одежды или обуви дороже 50 € для личного пользования. Для товара дешевле 10 € предусмотрены 2 € за обработку артикула. Таможенные платежи не входят в ССБ; сервис не гарантирует их отсутствие. Доставка получателю зависит от маршрута и способа, единой цены нет.

Условия отмены, удержания и сроки возврата средств зависят от стадии заказа и фактических расходов, см. п. 3.18 оферты. После передачи в международную перевозку возврат товара продавцу может быть невозможен. Не обещайте свободную примерку и бесплатный возврат в Европу.

Магазины · Как работает сервис · Поддержка. Поддержка любого магазина, рекомендации любой AI-модели и место в поиске не гарантируются.