← Назад к интеграциям

Подключение к магазину OMEGA

Выберите способ обмена данными. Для крупных поставщиков рекомендуется прямое API-подключение или интеграция с 1С. Для небольших объемов доступна ручная загрузка через Excel.

Потоки данных через API

Обмен происходит в двух направлениях: вы передаете в OMEGA каталог и остатки, OMEGA передает вам заказы и статусы.

→ В магазин OMEGA
  • Товары: SKU, название, описание, фото, характеристики
  • Цены: розничная цена для витрины
  • Остатки: количество по каждому SKU (обновление каждые 15 мин)
  • Статусы товаров: активен / скрыт / устарел
← Из магазина OMEGA
  • Заказы: номер, состав, адрес доставки (склад Омеги), статус
  • Статусы отгрузки: подтвержден / в сборке / отгружен
  • Возвраты: причина, ожидаемая дата прибытия на склад
  • Сводка продаж: агрегированные данные за период

Пошаговая инструкция подключения

1
Получите токен доступа

В разделе «Интеграции» сгенерируйте уникальный API-токен. Он действует 365 дней.

2
Настройте белый IP-адрес

Передайте ваш технический IP в службу поддержки OMEGA для добавления в белый список.

3
Отправьте тестовый запрос

Проверьте связь методом GET /api/v1/health

curl -H "Authorization: Bearer YOUR_TOKEN" \ https://api.omega.ru/v1/health
4
Настройте регулярную синхронизацию

Минимальная частота: остатки — каждые 15 минут, цены — раз в час, товары — по мере изменений.

5
Обработка заказов

Настройте вебхук или опрос GET /api/v1/orders?status=new для получения новых заказов в режиме реального времени.

Примеры запросов

Обновление остатков
POST /api/v1/products/stocks Content-Type: application/json Authorization: Bearer omga_live_************************************ { "items": [ { "sku": "882-441", "quantity": 24 }, { "sku": "112-009", "quantity": 156 } ] }
Получение новых заказов
GET /api/v1/orders?status=new&limit=50 Authorization: Bearer omga_live_************************************
Подтверждение заказа
PATCH /api/v1/orders/10249/confirm Authorization: Bearer omga_live_************************************ { "confirmed": true, "expected_delivery_slot": "2025-04-15T16:00:00Z" }
⚠️ Важно: фильтр номенклатуры

При загрузке товаров через API действуют те же фильтры запрещенных категорий, что и при ручной загрузке. Если SKU отклонен, вы получите ошибку с кодом PRODUCT_REJECTED_BY_FILTER и причину.

Подключение через 1С

Для поставщиков, работающих в 1С:Управление торговлей и 1С:Розница, у нас есть готовое расширение.

1
Скачайте расширение

Файл OmegaSupplier.cfe и инструкция по установке доступны в разделе «Интеграции».

2
Введите токен в настройках 1С

В разделе Сервис → OMEGA Integration укажите ваш API-токен и выберите расписание обмена.

3
Настройте соответствие номенклатуры

Сопоставьте артикулы 1С с SKU в каталоге OMEGA. Несопоставленные позиции не будут выгружаться.

4
Запустите обмен

Рекомендуемое расписание: остатки — каждые 15 минут, заказы — раз в 5 минут.

ℹ️ Поддерживаемые конфигурации

1С:Управление торговлей 11.4+, 1С:Розница 2.3+, 1С:УНФ 1.6+. Для более ранних версий требуется доработка — обратитесь в техподдержку.

Ручная загрузка через Excel / CSV

Если объем номенклатуры небольшой (до 1000 SKU), можно обходиться ручной загрузкой. Шаблон файла доступен в разделе «Товары → Загрузить прайс».

1
Скачайте шаблон

Обязательные колонки: SKU, Название, Цена, Остаток. Опционально: Описание, Категория, Бренд.

2
Заполните данные

Не изменяйте заголовки колонок. Цена указывается в рублях, остаток — в штуках.

3
Загрузите файл

Система покажет предпросмотр: что будет загружено, что отклонено фильтром, что требует проверки.

4
Подтвердите загрузку

После подтверждения изменения появятся на витрине в течение 5–10 минут.

⚠️ Ограничение ручной загрузки

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

Частые вопросы и поддержка

Как часто можно отправлять запросы?

Лимит: 1000 запросов в минуту. Рекомендуемый интервал синхронизации остатков — 15 минут.

Что делать, если токен утек?

Немедленно удалите текущий токен в ЛК и сгенерируйте новый. Старый станет недействителен в течение 1 минуты.

Есть ли тестовый стенд (sandbox)?

Да. Доступ по адресу https://api-sandbox.omega.ru/v1. Требуется отдельный тестовый токен.

Куда писать по техническим вопросам?

Email: api@omega.ru или Telegram-бот поддержки в разделе «Настройки».