Інтеграція 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. Оновлюємо курс щодня агентом 1С-Бітрікс.

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

Реалізація отримання замовлень

Нові замовлення 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);
    }
}

При створенні замовлення в 1С-Бітрікс зберігаємо prom_order_id в користувацьке поле замовлення UF_PROM_ORDER_ID. Після обробки замовлення в 1С-Бітрікс оновлюємо статус на Prom.ua через POST /orders/set_status.

Синхронізація залишків через фід

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

Орієнтири за термінами

Вартість розраховується індивідуально після аналізу каталогу та вимог до контенту.