Обмен данными между 1С-Битрикс и Prom.ua: решения для Украины

Настройка обмена товарами и заказами между 1С-Битрикс и Prom.ua

Потеря заказов, рассинхронизация остатков и сложности с двуязычным контентом — типичные проблемы магазинов на 1С-Битрикс при выходе на Prom.ua. Мы выполнили более 15 интеграций для украинских ритейлеров, сократив ручные операции на 40% и ускорив обработку заказов в 2 раза. Ниже — технические детали, которые помогут избежать ошибок.

Почему интеграция с 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 — обновление статуса заказа

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

Адаптация под украинский рынок

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

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

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

Как настроить получение заказов: пошаговая инструкция

1. Получите токен API в личном кабинете Prom.ua.
2. Создайте в Битрикс пользовательское поле UF_PROM_ORDER_ID для хранения ID заказа.
3. Настройте агент на периодический вызов GET /orders/list с фильтром по статусу pending.
4. При получении нового заказа проверьте его по UF_PROM_ORDER_ID и создайте заказ в Битрикс.
5. После обработки обновите статус на Prom.ua через POST /orders/set_status.

Пример кода агента:

$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.ua не имеет прямого API для обновления остатков в реальном времени — всё через фид. Частота обновления фида: раз в час для магазинов с высоким оборотом. Товары с нулевым остатком выставляем с available=false — они остаются в каталоге, но не показываются в листинге активных офферов. Для магазинов с низким оборотом достаточно обновления раз в 3-4 часа — экономия ресурсов сервера без потери актуальности.

Что входит в работу

• Документация: описание схемы обмена, маппинг полей, инструкция для оператора.
• Доступы: настройка токена, прав доступа к API Prom.ua и административной части Битрикс.
• Обучение: демонстрация работы интеграции, ответы на вопросы менеджеров.
• Поддержка: гарантийное обслуживание 1 месяц (исправление ошибок, консультации).

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

Стоимость рассчитывается индивидуально после анализа каталога и требований к контенту. Для точной оценки свяжитесь с нами — мы подготовим коммерческое предложение за один день. Наши инженеры имеют 10+ лет опыта в Битрикс и сертификаты по интеграции с Prom.ua. Получите консультацию прямо сейчас.