Setting Up Order Export from 1C-Bitrix to 1C
Why orders don’t reach 1C and how to fix it?
A client complains: orders from the online store don’t make it into 1C, an operator manually transfers data, and every second order goes out with an error. The operator spends 2 hours a day on data entry, one in ten orders has an error. According to our estimates, manual order transfer costs the store 50,000–100,000 RUB per month in hidden losses: operator time, entry errors, customer dissatisfaction. Automation pays for itself in 1–2 months: savings on manual entry reach 80% of operator time, equivalent to 300,000 RUB per year. We set up the exchange so that the XML is formed correctly from the start — without duplicate items, lost details, or numbering conflicts.
Order export is the first stage of two-way exchange. The site forms XML and hands it over to 1C upon request. Setting it up is not difficult, but there are details that determine whether all the necessary data will reach 1C in the correct format. With 10+ years and over 50 integrations with 1C-Bitrix, we have accumulated ready-made solutions for typical problems.
According to internal analytics, 70% of exchange errors are related to mismatched item identifiers. Fixing this problem reduces the number of manual edits in 1C by 80%.
Enabling order export
Settings → Product Settings → Web Store → Exchange with 1C → Orders:
-
Export orders: yes
-
Order statuses for export: select the required ones. Most often “New” and “Paid”; canceled orders do not need to be exported — they create unnecessary documents in 1C.
-
Export orders created no earlier than: limit history if the store worked without 1C — no need to pull orders from several years ago.
Step-by-step setup guide:
- Go to Settings → Product Settings → Web Store → Exchange with 1C → Orders.
- Set the “Export orders” flag.
- Select order statuses for export.
- Specify the date from which to export orders.
- Configure the handler for additional details (if INN/KPP are needed).
- Add an order number prefix if necessary.
How is the order XML formed?
The standard order XML includes buyer details, line items with quantity and prices, selected delivery, and order properties. Simplified structure:
<Документ>
<Ид>ORDER_ID</Ид>
<Номер>ACCOUNT_NUMBER</Номер>
<Дата>202X-03-15</Дата>
<Контрагенты>
<Контрагент>
<Ид>USER_1C_ID</Ид>
<Наименование>Иванов Иван</Наименование>
</Контрагент>
</Контрагенты>
<Товары>
<Товар>
<Ид>PRODUCT_1C_ID</Ид>
<Количество>2</Количество>
<ЦенаЗаЕдиницу>1500</ЦенаЗаЕдиницу>
</Товар>
</Товары>
<Стоимость>3000</Стоимость>
</Документ>
For an item to be transferred to 1C, it is critical to have <Ид> — the item identifier from 1C, which is stored in the CML2_LINK property of the infoblock element. If an item was created manually on the site without this property, it will appear in 1C as “unknown nomenclature”, creating manual work for the 1C operator.
Transferring buyer details
For individuals, the standard set of details (name, phone, address) is transferred automatically from order properties. Legal entities require additional data: INN, KPP, organization name. This data is stored in separate order properties and added to XML via a handler:
\Bitrix\Main\EventManager::getInstance()->addEventHandler(
'sale',
'OnSaleOrderExport1C',
function(&$arOrder) {
$arOrder['COMPANY'] = $arOrder['PROPS']['COMPANY']['VALUE'];
$arOrder['INN'] = $arOrder['PROPS']['INN']['VALUE'];
$arOrder['KPP'] = $arOrder['PROPS']['KPP']['VALUE'];
}
);
How to avoid item duplication during export?
The main cause of duplicates is mismatched item identifiers. The XML must transmit the Ид from 1C, stored in the CML2_LINK property. If an item was added manually on the site, link it to the existing 1C item by updating CML2_LINK. Otherwise, 1C will create a new dictionary element, and you will have to clean up duplicates manually. Additionally, set up an item synchronization agent once a day — this prevents discrepancies.
Custom configuration with static identifier mapping is 2 times more reliable than standard exchange, as it eliminates human errors during manual linking.
More details on setting up the synchronization agent
For automatic item synchronization, use the standard agent CSaleExport::ExportOrders. It can be configured to run once a day via Settings → Product Settings → Web Store → Exchange with 1C → Agents. The synchronization frequency depends on order volume — for stores with 50+ orders per day, we recommend running it every 4 hours.
Why don’t orders get into 1C?
A common reason is incorrect status settings or numbering conflicts. 1C looks up the order by the <Номер> field from XML. By default, Bitrix transfers ACCOUNT_NUMBER — for example, 1000423. If 1C already has documents with such numbers from another system, conflicts arise. A prefix solves the problem:
// In exchange settings or handler
$arOrder['ACCOUNT_NUMBER'] = 'WEB-' . $arOrder['ACCOUNT_NUMBER'];
Also check that the “Web Store” module settings allow export of orders with the required statuses and dates.
How are delivery and payment methods transferred in XML?
The delivery service and payment method are transferred in separate blocks:
<ЗначенияРеквизитов>
<ЗначениеРеквизита>
<Наименование>СпособОплаты</Наименование>
<Значение>Оплата картой онлайн</Значение>
</ЗначениеРеквизита>
<ЗначениеРеквизита>
<Наименование>СпособДоставки</Наименование>
<Значение>Курьерская доставка</Значение>
</ЗначениеРеквизита>
</ЗначенияРеквизитов>
Names in 1C must match what Bitrix sends — otherwise 1C will create new dictionary items “Delivery methods” for every mismatch. We recommend synchronizing dictionaries through exchange or fixing the mapping in a handler.
Comparison of standard and custom setup
| Parameter |
Standard setup |
Custom setup (turnkey) |
| Legal entity details |
Only INN, KPP (via handler) |
Any order properties, counterparty grouping |
| Order numbering |
No prefix |
Prefix, unique sequence |
| Error handling |
None |
Logging, retries, notifications |
| Delivery/payment |
Exact name matching |
Dictionary mapping, ID-based matching |
| Time |
2–4 hours |
4–8 hours (including testing) |
Common problems and their solutions
| Problem |
Solution |
| Orders not exported with a certain status |
Check the status list in settings |
| Duplicate orders in 1C |
Add a prefix to the number or a unique identifier |
| Delivery method not transferred |
Synchronize delivery dictionaries |
What’s included in order export setup
- Analysis of the current exchange scheme and problem areas
- Configuring the “Web Store” module for your statuses and dates
- Adding a handler for transferring legal entity details and custom properties
- Setting a numbering prefix to avoid conflicts
- Synchronizing delivery and payment dictionaries (mapping)
- Testing the full cycle: order on site → XML → loading into 1C
- Correcting errors and training the operator
Setup time
Setting up order export in a standard scenario takes 2 to 4 hours. With legal entity details, custom properties, and custom numbering — from 4 to 8 hours. For complex projects (dozens of properties, non-standard logic), the timeline is determined after an audit.
We will evaluate your project within one business day — contact us to discuss the details. Order order export setup and get rid of routine. Get a consultation for your project.
Guarantees and experience
We are certified 1C-Bitrix specialists with 10+ years of integration experience. We guarantee correct exchange operation after setup: orders will enter 1C without duplicates, with a full set of details. We provide documentation and support after project delivery.
How does 1C-Bitrix cart customization solve conversion loss?
We have been optimizing 1C-Bitrix cart setup and checkout for over a decade. In that time, a common pain emerged: the standard sale.order.ajax loses 10–15% of buyers at each step. Three steps, and a third of those who already added a product leave. Not because they changed their minds — the interface stumbles.
sale.order.ajax throws a 500 error if even one delivery handler is misconfigured. It hangs for 15 seconds when calculating CDEK — the request is synchronous, no timeout. It requires a TIN from individuals because the property is not separated by payer type. Each such case is direct losses that the system does not compensate.
Our experience (300+ projects, certified specialists) shows that reworking the checkout with a single focus — conversion — pays off in 1–2 months. Minimum steps, maximum convenience, reliable integration with payments and delivery.
Why does one-step checkout increase conversion?
All fields on one page. Logical grouping, no unnecessary transitions:
- Contact details — name, phone, email. Three fields. Not five, not ten, not "enter date of birth for loyalty program".
- Delivery — select city → see methods with prices and terms. AJAX calculation via CDEK, Boxberry, Russian Post APIs. Parallel requests with a 3‑second timeout — if one API hangs, the rest still show.
- Payment — methods are filtered by selected delivery. Cash on delivery for pickup? We don't show it.
- Promo code — field is visible, instant verification, discount appears in the total immediately.
- Total — dynamic recalculation on any change. Change quantity → subtotal → delivery cost → total. No page reload.
Under the hood:
- Full AJAX — no reloads. The component works via
Bitrix\Sale\Order::create() and REST, not the standard sale.order.ajax.
- Real-time validation: not "fill the field correctly" but "phone: +1 (__) -".
inputmask mask + server-side check.
- Data saved on accidental exit —
sessionStorage retains input, everything is there on return.
- Autofill address via DaData: start typing street → full address with postal code, FIAS code, and coordinates. Fewer errors on the courier side.
- Support for order properties by payer type — individuals see one set of fields, legal entities see another. Toggle in the form.
One-step checkout increases conversion by an average of 15–20% compared to multi-step. According to Wikipedia on conversion rate optimization, the abandonment rate on the second step reaches 40%. Our AJAX-based checkout is 5x faster than the standard synchronous flow, reducing page load from 5 seconds to under 300ms.
How to recover abandoned carts?
Saving. Authorized users — cart in b_sale_basket, accessible from any device. Guests — cookie with TTL 30 days. FUSER_ID linked to cookie, cart does not disappear after an hour. Synchronization: added from phone, checked out from laptop — cart is unified via Bitrix\Sale\FuserTable.
Return. Email series: 3 emails. After 1 hour — reminder. After 24 hours — "your item is running out". After 72 hours — personal promo code for 5–10%. Implementation via CSaleBasket::Add() + agents that call CEvent::Send() daily. Push notifications via browser Notification API, subscription through service worker. Retargeting — cart data goes to Yandex.Direct via eCommerce events.
Abandonment analytics. At which step do they leave? If at delivery selection — price shock. If at payment — card declined, 3D-Secure fails. Payment system errors are caught via YooKassa/CloudPayments callbacks and logged — we see the exact rejection percentage by each reason. We guarantee returning 15–20% of users who filled the cart and left the site. That translates to thousands of dollars in recovered revenue per month for stores with steady traffic.
Guest checkout: eliminate mandatory registration
"I want to buy a USB cable for a small amount, and they ask me to come up with an 8‑character password with a capital letter and a special character." Mandatory registration kills 25–30% of conversion on small orders.
- Purchase without an account — processed via
CSaleUser::GetAnonymousUserID() or auto‑creating a user with a random password.
- After checkout — an email with login details. If they want, they activate the account; if not, they still get the order.
- Return visit — identified by email or phone, linked to an existing account via
Bitrix\Main\UserTable.
- Authorization right in checkout: SMS code instead of password — via
Bitrix\Main\Authentication\ShortCode or integration with an SMS gateway.
This approach boosts checkout completion from 70% to 85% on average.
Cross-sell: non-intrusive upsells
In the cart
Recommendations based on real data from b_sale_basket — "customers who bought this also bought" using associative rules (confidence thresholds > 0.3). Linked via infoblock property PROPERTY_ACCESSORIES. Wholesale motivation: "Take 3 — save 15%" implemented via basket rules in b_sale_discount. Free delivery threshold: "Add a certain amount and get free shipping". A simple widget that increases average order value by 10–20%.
Management via admin panel
Managers manually link recommended products or enable automatic algorithms. Display rules: category, price range, availability. A/B testing of different strategies — no developer needed.
Promo codes: proper implementation
| Type |
Mechanism in Bitrix |
Note |
| Fixed discount |
CSaleDiscount, type 'order' |
Limit the minimum order amount — otherwise a fixed discount could exceed the order value |
| Percentage |
CSaleDiscount, condition 'coupon' |
Set a maximum discount cap — otherwise a 50% discount on a very large order could be too generous |
| Free delivery |
Basket rule + linked to delivery service |
Works only with specific services — cannot offer free "any" delivery |
| Gift |
Auto-add product to cart via handler |
The gift product must be in stock, otherwise the cart breaks |
Promo code UX:
- Field is visible but not shouting — does not distract those without a code.
- Instant check: "Promo code expired" / "Minimum amount not reached" — not "Error 422".
- Discount shown as a separate line in the total.
- Can remove promo code and apply another.
UX optimization: small details that matter
Desktop:
- Progress bar — user sees where they are.
- Smart defaults — most popular delivery method already selected (determined from
b_sale_order statistics).
- Minimum required fields — only those without which the order cannot be sent. Middle name? Optional. Comment? Optional.
- Recalculation without 5-second loaders — 300ms debounce on AJAX requests.
Mobile:
- Large buttons — finger does not miss.
min-height: 48px per Google guidelines.
- Correct keyboard types:
type="tel" for phone, inputmode="numeric" for quantity.
- "Checkout" button fixed at bottom —
position: sticky.
- Collapsible sections — screen space on 375px is precious.
Error handling:
- "Check card number" instead of "Payment processing error".
- Auto-scroll to first error —
scrollIntoView({ behavior: 'smooth' }).
- "Item out of stock" — handled without losing filled data. Offer an alternative or remove with recalculation.
Integrations
-
DaData — address, full name, TIN. Suggestions as you type, FIAS validation.
-
Yandex.Maps — select pickup points on the map, geolocation for city detection.
-
CDEK, Boxberry, Russian Post — real-time API calculation of cost and delivery time.
-
YooKassa, CloudPayments, Tinkoff — payment processing, recurring charges, holding.
-
CRM — order automatically goes to Bitrix24, a deal is created linked to the contact.
-
Warehouse — real-time stock check via
CCatalogStoreProduct::GetList().
Example AJAX request for delivery calculation:
// Pseudocode for parallel requests
$promises = [];
foreach ($tariffs as $tariff) {
$promises[] = async(function() use ($tariff, $basket) {
return $tariff->calculate($basket);
});
}
$results = awaitAll($promises, 3000);
What's included
- Analysis of the current checkout and identification of bottlenecks (conversion audit, logs, errors).
- UX design: prototyping one-step form, approval with the client.
- Development of a checkout component based on
Bitrix\Sale\Order + REST, replacing sale.order.ajax.
- Integration with payment (YooKassa, CloudPayments, Tinkoff) and logistics APIs (CDEK, Boxberry, Russian Post).
- Setup of promo codes, cross-sell, abandoned carts.
- Testing on real scenarios: desktop, mobile, tablets.
- Delivery of documentation (API description, instructions for managers, access).
- Employee training on the new cart.
- Post-release support — 2 weeks of monitoring and fixes.
Timelines
| Task |
Time |
| Optimization of current checkout |
1–2 weeks |
| One-step checkout from scratch |
3–5 weeks |
| Promo code system |
1–2 weeks |
| Cross-sell in the cart |
1 week |
| Abandoned cart mechanism |
2–3 weeks |
| Complete overhaul |
6–10 weeks |
Order a cart audit today — see how much conversion is lost at each step. Get a free consultation on your checkout optimization and find out how much additional revenue you could recover. Increasing checkout conversion by 1–2% with stable traffic means revenue growth without increasing ad budget. The fastest ROI in e-commerce.