Что синхронизировать с Avtomatizaciya-Internet-Magazina

Для обеспечения консистентности данных между CRM, ERP и витриной магазина, через API Avtomatizaciya-Internet-Magazina настраивается передача следующих сущностей:

• Остатки товаров (Stock Level): Синхронизируются с WMS или складскими программами (1С, МойСклад). Используется метод PATCH /api/v1/products/{id}/stock.
• Заказы (Orders): Передача статусов и состава заказа в ERP для фискализации. Метод GET /api/v1/orders для импорта и POST /api/v1/orders/{id}/status для обновления.
• Цены (Price Lists): Автоматизация прайс-листов из Excel/ERP. Метод PUT /api/v1/prices/batch позволяет обновлять до 500 позиций за один запрос.
• Пользовательские данные (Customers): Синхронизация CRM-карточек с личным кабинетом. Метод POST /api/v1/customers/sync для передачи email и ID клиента.
• Статусы отгрузки (Shipments): Интеграция с логистическими сервисами (СДЭК, Boxberry). Метод POST /api/v1/orders/{id}/shipment передает трек-номер и текущую локацию.
• Характеристики товаров (Attributes): Передача метаданных (размер, цвет) из PIM-систем. Метод PATCH /api/v1/products/{id}/attributes для обновления специфичных параметров.

Технические особенности API Avtomatizaciya-Internet-Magazina

Архитектура API спроектирована для высоконагруженных B2B-интеграций с соблюдением стандартов RESTful:

• Аутентификация: Используется Bearer Token, передаваемый в заголовке Authorization: Bearer {api_key}. Токены генерируются в панели управления профилем.
• Формат данных: Обмен данными осуществляется исключительно в формате application/json. Кодировка UTF-8 обязательна для корректной обработки кириллицы.
• Rate-limits: Ограничение составляет 100 запросов в минуту на один API-ключ. При превышении сервер возвращает HTTP 429 Too Many Requests с заголовком Retry-After.
• Обработка ошибок: Стандартные коды: 401 (неверный токен), 403 (недостаточно прав), 422 (ошибка валидации полей), 500 (внутренняя ошибка сервера). Все ответы содержат объект {"error": "message"}.
• Вебхуки: Поддерживаются события order.created, stock.updated, payment.received. URL для callback-уведомлений настраивается в разделе интеграций.
• Версионирование: Версия API указывается в URL, например /api/v2/.... Старые версии поддерживаются в течение 6 месяцев после выхода мажорного обновления.
• Песочница: Доступен эндпоинт api-sandbox.avtomatizaciya.ru для тестирования методов без влияния на реальные продажи.

Часто задаваемые вопросы о Avtomatizaciya-Internet-Magazina

Как получить API-ключ? Ключ генерируется в разделе «Интеграции» -> «API настройки» личного кабинета администратора. Необходимо единоразово активировать доступ, сохранив токен в безопасном месте, так как он отображается только один раз.

Какие лимиты на количество запросов в сутки? Базовый тариф позволяет совершать до 150 000 API-запросов в сутки. Для Enterprise-клиентов лимиты расширяются по индивидуальному запросу в техническую поддержку.

Поддерживает ли платформа вебхуки для всех событий? Да, доступно более 20 типов событий, покрывающих жизненный цикл заказа и товарного каталога. Вы можете настроить подписку на конкретный URL через метод POST /api/v1/webhooks.

Существует ли тестовый режим работы? Да, для разработки предусмотрен отдельный тестовый контур, который полностью зеркалит структуру основного API. Данные в песочнице не синхронизируются с реальными складами и платежными шлюзами.

Обязательно ли использовать последнюю версию API? Использование актуальной версии рекомендуется для доступа к новым методам и патчам безопасности. Поддержка устаревших версий (v1) прекращается через полгода после релиза v3.

Где найти полную техническую документацию? Актуальный Swagger-файл и описание методов доступны по адресу docs.avtomatizaciya.ru. Настроить интеграцию Avtomatizaciya-Internet-Magazina под ключ — flowframe.ru, от 40 000 ₽, срок 7-21 день.