Интеграция 1С-Битрикс с Prom.ua (Украина)

Интеграция 1С-Битрикс с Prom.ua (Украина)

Prom.ua — крупнейшая украинская торговая площадка с собственным магазином для каждого продавца и агрегацией в общем каталоге. Для украинских интернет-магазинов на 1С-Битрикс интеграция с Prom.ua покрывает два контура: выгрузку товарного фида и получение заказов через API. Платформа EVO (материнская для Prom.ua) предоставляет единый API, что упрощает повторное использование кода при интеграции с Satu.kz.

Формат фида Prom.ua

Prom.ua принимает фид в формате YML или собственном CSV-формате. YML предпочтительнее — поддерживает больше полей и структурированную передачу характеристик. Цены — в украинских гривнях (UAH).

Отличие от стандартного YML для Яндекс.Маркета: Prom.ua поддерживает тег <keywords> для каждого оффера — список ключевых слов для внутреннего поиска платформы. Заполнение этого тега влияет на видимость товара при поиске на Prom.ua.

Также поддерживается тег <country_of_origin> — для товаров с маркировкой происхождения. И <barcode> для EAN-кодов.

API Prom.ua

Базовый URL: https://my.prom.ua/api/v1/. Аутентификация через токен: заголовок Authorization: Bearer {token}.

Методы для работы с заказами:

• GET /orders/list — список заказов с фильтрами по статусу и дате
• GET /orders/{id} — детали заказа
• POST /orders/set_status — обновление статуса заказа

Статусы заказов на Prom.ua: pending (новый), received (подтверждён), delivered (доставлен), canceled (отменён), draft (черновик).

Особенности украинского рынка

Язык контента. Prom.ua — преимущественно украиноязычная аудитория. Описания товаров в фиде лучше давать на украинском языке. Если 1С-Битрикс настроен для русскоязычного контента, нужно либо хранить украиноязычные описания в отдельных свойствах инфоблока, либо использовать машинный перевод как временное решение.

Цены в UAH. Если магазин ведёт цены в USD, нужна конвертация по курсу НБУ. API НБУ: https://bank.gov.ua/NBU_Exchange/exchange_site?start=...&end=...&sort=exchangedate&order=desc&json. Обновляем курс ежедневно агентом Битрикс.

Нова Пошта как основной перевозчик. При обработке заказов из Prom.ua большинство доставок идут через Нова Пошта. Если в Битрикс настроена интеграция с API НП — адрес отделения из заказа Prom.ua маппируется на поле доставки в Битрикс автоматически.

Реализация получения заказов

Новые заказы Prom.ua опрашиваем агентом каждые 5–10 минут:

$response = $httpClient->get('https://my.prom.ua/api/v1/orders/list', [
    'status' => 'pending',
    'date_from' => date('Y-m-d\TH:i:s', strtotime('-10 minutes')),
]);

foreach ($response['orders'] as $promOrder) {
    // Проверяем, не создан ли уже этот заказ
    $existingOrder = findOrderByPromId($promOrder['id']);
    if (!$existingOrder) {
        createBitrixOrder($promOrder);
    }
}

При создании заказа в Битрикс сохраняем prom_order_id в пользовательское поле заказа UF_PROM_ORDER_ID. После обработки заказа в Битрикс обновляем статус на Prom.ua через POST /orders/set_status.

Синхронизация остатков через фид

Prom.ua не имеет прямого API для обновления остатков в реальном времени — всё через фид. Частота обновления фида: раз в час для магазинов с высоким оборотом. Товары с нулевым остатком выставляем с available="false" — они остаются в каталоге, но не показываются в листинге активных офферов.

Ориентиры по срокам

Стоимость рассчитывается индивидуально после анализа каталога и требований к контенту.