1C-Bitrix Integration with Satu.kz (Kazakhstan)
Satu.kz is Kazakhstan's largest price aggregator (part of the EVO group, which also includes Prom.ua and Tiu.ru). For Kazakhstani online stores built on 1C-Bitrix, integration with Satu.kz is a standard task when entering the local market or expanding presence. Technically, the platform operates on the same model as Prom.ua: a YML feed plus an API for order management.
Satu.kz Feed Format
Satu.kz accepts feeds in YML (Yandex Market Language) format. The base structure is identical to standard YML, but requires prices to be specified in Kazakhstani tenge (KZT).
Mandatory offer fields:
-
<url>— product page URL on your website -
<price>— price in KZT -
<currencyId>KZT</currencyId> -
<categoryId>— category ID from your tree (defined in the<categories>block) -
<name>— product name -
<available>— availability
Additional <param> parameters for specific categories improve offer click-through rate in filtered search results.
Currency Conversion
If the store maintains prices in rubles (RUB) or US dollars (USD), conversion to KZT is required for the feed. The National Bank of Kazakhstan (NBK) publishes exchange rates via API: https://nationalbank.kz/rss/rates_all.xml. A 1C-Bitrix agent updates the rate daily and uses it during feed generation.
We add KZT to b_catalog_currency and configure rate updates. During feed generation, prices are retrieved from b_catalog_price and converted via \Bitrix\Currency\CurrencyManager::convertCurrency().
Satu.kz Order API
The EVO platform (of which Satu.kz is a part) provides a REST API for order management. Base URL: https://satu.kz/api/v1/. Authentication: store token in the token: {your_token} header.
Key endpoints:
-
GET /orders/— order list (filterable by status and date) -
GET /orders/{id}/— order details -
POST /orders/{id}/update-shipping/— update shipping status
Orders received through Satu.kz are created in the 1C-Bitrix b_sale_order table. Buyer data from Satu orders is mapped to b_sale_order_props fields. The Satu order ID is stored in a custom order field for reverse lookup when updating statuses.
Feature: Product Reviews and Ratings
Like other EVO platform members, Satu.kz aggregates buyer reviews. The store's rating affects its position in listings. The integration does not manage reviews directly, but timely order processing (accurate stock levels, correct status updates) reduces the volume of negative feedback.
Feed Generation in 1C-Bitrix
An agent runs hourly and generates an XML file:
// Retrieve products with available stock
$res = \Bitrix\Iblock\ElementTable::getList([
'filter' => ['IBLOCK_ID' => CATALOG_IBLOCK_ID, 'ACTIVE' => 'Y'],
'select' => ['ID', 'NAME', 'CODE', 'DETAIL_PAGE_URL'],
]);
// For each product, retrieve price and stock
// b_catalog_price JOIN b_catalog_product
// Convert price to KZT
// Build XML offer
The file is saved to /upload/satu_feed.yml. The feed URL is registered in the Satu.kz seller dashboard.
Category Mapping
The Satu.kz category tree differs from your site's catalog structure. A mapping table is required: your 1C-Bitrix category → Satu.kz category. Without correct mapping, products end up in the wrong sections and are missed during filtering.
Estimated Timelines
| Task | Timeline |
|---|---|
| YML feed setup with KZT conversion | 3–7 days |
| + API integration for order retrieval | 1–2 weeks |
| Full integration with category mapping and monitoring | 2–3 weeks |
Pricing is calculated individually after analysing the catalog structure and nomenclature volume.