Integration of 1C-Bitrix with Onlíner (Belarus)
Onlíner.by is the largest Belarusian portal with a Price.Onliner section, which is the primary price aggregator for Belarusian shoppers. Getting into the Onliner listing and maintaining data accuracy is a key task for most Belarusian online stores running on 1C-Bitrix. The platform is demanding when it comes to feed quality: outdated prices, items shown as in stock that are not, and broken links lead to a lower store rating.
Onlíner feed format
Onlíner accepts feeds in YML format (similar to Yandex Market) with some specific requirements:
- Mandatory
<model>field for electronics (not just<name>) -
<barcode>and<vendor_code>fields for identification in the Onlíner database -
<currencyId>BYN</currencyId>— Belarusian ruble only - High-quality images: minimum 400×400 pixels, no watermarks
Onliner has its own product catalogue with normalised specifications. When a store submits an offer for a specific product (e.g. HP Pavilion 15-eg2000 laptop), the system matches it against the card in the Onliner database using <barcode> or <model>/<vendor>. If the match fails, the offer remains "unattached" and is virtually invisible in search results.
Specifics for electronics and appliances
Onlíner is especially strict with the electronics and home appliances category. For these products:
Barcode is mandatory. Without an EAN/UPC in the <barcode> field, the product will not match the Onliner database. Barcodes in Bitrix are stored in b_catalog_product_barcode. If they are not populated, a separate task is required to bulk-fill them from supplier price lists.
Model and manufacturer. The values of <vendor> and <model> must exactly match the names in the Onliner database. Extra symbols, abbreviations, or case mismatches are all causes of failed matching.
Feed generation in 1C-Bitrix
Use a custom agent that generates the XML and saves it to /upload/onliner_feed.yml. The base structure is similar to the Yandex Market YML export, but adapted to Onliner's requirements.
Key differences in generation:
- Filter: only active products with stock > 0
- Price: from the "Retail" price type in BYN (conversion via the National Bank of Belarus rate if prices are in another currency)
- The
<url>field: canonical URL without UTM parameters (Onliner does not accept UTM in feed links) - For product offers (variants): each offer becomes a separate
<offer>with its own<barcode>
For a store with 10,000+ SKUs, the feed size is several megabytes of XML. Move generation to a background process (via \Bitrix\Main\Application::getInstance()->addBackgroundJob() or a direct cron job), writing to a file and then updating it with an atomic rename so that Onliner does not download an incomplete file.
Store rating and reputation management
Onlíner displays the store rating (customer reviews) directly in the offer listing. A low rating means low conversion even at a competitive price. Integration does not directly affect the rating, but does so indirectly: accurate stock levels and prices reduce the number of failed purchases and negative reviews.
Feed monitoring
After setup, it is important to track parsing errors in the Onliner partner dashboard. The platform sends a report on problematic offers: incorrect URLs, missing required fields, duplicate offer.id values. We recommend setting up a weekly notification about feed status.
Estimated timelines
| Task | Timeline |
|---|---|
| Basic YML feed setup for Onlíner | 3–7 days |
| Barcode population for the electronics category | 3–10 days (depends on volume) |
| Full setup with category mapping and monitoring | 2–3 weeks |
Pricing is calculated individually after auditing the catalogue and the state of barcode and manufacturer data.