If you are setting up the exchange for the first time, start with the overview: exporting a catalog to 1C-Bitrix.
Glossary Of Terms
| Term | Meaning |
|---|---|
| Information block | The Bitrix catalog where sections, products, and product properties are loaded. |
| Product | A regular product card. |
| Offer | A product variant: size, color, bundle, separate price, or stock. In most Bitrix catalogs, offers are stored in a separate information block. |
| Matching ID | A field used to find an existing object and avoid duplicates. |
| Cleanup | Removing or disabling objects that disappeared from the current source. |
Connection And Catalog
Enter the site address, login and password of a user with administrator rights, then click Check connection. After the check, choose the 1C-Bitrix catalog. Eofferix will send sections, products, and product properties there.
You usually do not need to choose the offer information block separately. Eofferix reads it from the Bitrix commercial catalog settings: if the selected product catalog has a linked offer block, the module detects it automatically. If there is no such link, configure it in Bitrix first; otherwise offers will not be loaded as product variants.
How To Choose Matching Fields
- For products, choose a field or a set of fields that always identifies one product card. This can be an external ID, SKU, product name, or a combination of name and SKU.
- For offers, you can choose another set of fields: offer SKU, offer external ID, size, color, or their combination.
- A separate section matching field is especially useful when sections arrive as a separate block. If sections are inside products or arrive as a path, the full path such as
Clothing / Men / Trousersis often enough. - For 1C sources, the 1C external ID is usually the default choice for products and offers. Change it only if the existing site catalog already has another stable field for matching.
- Leave advanced speed settings at their default values unless you have a specific reason to set the portion size manually.
How AND and OR work. Separate identification chips are joined with AND. Inside one chip, the “or …” button adds alternative fields that are tried from left to right. For example: (SKU OR External code OR Barcode) AND Supplier AND (Brand OR Manufacturer).
Eofferix stops at the first complete combination that finds existing objects. If that combination finds several objects, the complete result set is passed to the selected duplicate policy; matching does not fall through to the next alternative. Every required group must have a value. Users may choose any available fields, and extra alternatives do not consume extra credits.
Import Presets
A preset is a ready scenario for a common task. Choose it at the top of the settings block, then change individual fields only when you need a custom scenario.
| Preset | When to use it |
|---|---|
| Safe exchange | Eofferix creates new products and updates found ones, but does not delete missing products automatically. It also does not bind products and offers to a specific profile. |
| Full source sync | The profile binds all imported products to itself. A repeated profile run removes products and offers that disappeared from the source and adds new ones that appeared with the next update. |
| Update found | Use this scenario when you need to change prices, stock, names, or properties only for already found products and offers. New products are not created. |
| Add new only | When missing products should be added, but existing site data should not be changed. |
| Full catalog rewrite | This scenario removes missing products, offers, and sections within the selected scope, then creates or updates objects from the current source. Properties and dictionary values are retained. |
Matching Existing Objects
Choose which fields Eofferix should use to find existing products, offers, and sections. A found object is updated in place instead of being created again. Products and offers are matched separately. Sections without a selected matching field are matched by the full path of names.
If the site will send orders back to 1C, also write the 1C external ID into the Bitrix external code field. Details: 1C and Bitrix integration through Eofferix.
Import Rules
Rules define what to do with new products, found products, and empty values. Safe exchange is useful for updating prices, stock, properties, and new products without binding the catalog to a specific profile. For example, it fits when Eofferix works between a site and 1C, and 1C sends only changed data.
If the source is the full list for its catalog and the site must remove what is no longer in the data, use sync scenarios or manual cleanup rules. Check them with a test export before the first real run.
Offers
Offers are configured separately from products. This is important: if the price or stock changed for one specific variation, for example a black T-shirt in size S, Eofferix updates that offer instead of rewriting the parent product.
Cleanup And Safety
Cleanup after import is needed when the site must remove products, offers, or sections that no longer exist in the current source. It is not required for every exchange: if the source sends only changes, cleanup is usually not enabled.
The safest option for regular sync is Current source only. In this mode Eofferix works only with objects linked to this profile and does not touch other products on the site. Use full-catalog cleanup only for a separate test catalog or when the selected catalog fully belongs to the current source.
Safety limits stop dangerous deletion and explain the reason. If the limit is reached, the module stops cleanup before the next deletion above the limit: objects that were only checked are not deleted just because they were checked. First check the source, selected scenario, and cleanup area, then change the limit if needed.
Automatic missing-data cleanup does not delete or unlink properties or dictionary values used by the profile. If they are temporarily absent from a later source, they remain in the catalog; when they appear again, Eofferix reuses the retained mapping when one compatible object can be identified unambiguously. Rules for missing products, offers, sections, and images work separately.