A user opens their cart, selects delivery, and sees a text list of pickup points. No map, no visual understanding. Familiar? We solve this by integrating an interactive pickup point selection widget on a map using Vue.js into 1C-Bitrix. This is not just pins on a map — it's a full checkout component that accounts for user location, loads points only in the visible area, and recalculates delivery costs on the fly. According to our data, such a widget increases checkout conversion by 15–20%, and support cost savings post-implementation reach up to 30% of the budget.
Why does a Vue.js widget boost checkout conversion?
Instead of scrolling through a list of 50 addresses, the user finds the nearest pickup point in seconds. Over 70% of online store orders are made from phones — the widget is adapted for mobile screens: the map takes half the screen, the pickup point list is at the bottom with scroll capability. This is critical for mobile users who are not willing to spend time searching. According to statistics, 80% of users abandon their cart due to inconvenient delivery selection — the widget solves this problem.
How to integrate the widget into 1C-Bitrix?
The process includes several stages:
-
Analysis — determine delivery services, number of pickup points, requirements for the mapping engine.
-
Design — create the component architecture (see below), define API endpoints.
- Implementation — write Vue components, server agents for caching pickup point data, integration with checkout.
- Testing — test on real devices, fallback scenarios (geolocation disabled).
- Deployment — roll out to production, monitor performance.
Technical implementation
Data sources for pickup points
Coordinates and attributes of pickup points come from the delivery service API. Here are the main ones:
- CDEK:
https://api.cdek.ru/v2/deliverypoints — list of points with coordinates, working hours, type
- Boxberry:
https://api.boxberry.ru/json.php?token=...&method=ListPoints
- Russian Post: API
otpravka.pochta.ru — list of post offices
- DPD, Ozon Rocket, Yandex.Delivery — custom APIs
All this data is cached server-side (in b_cached_files or Redis), not requested directly from the client — this hides API keys and speeds up response.
Component architecture
PvzMapWidget.vue
├── MapContainer.vue — Yandex.Maps or Leaflet
├── PvzList.vue — pickup point list next to the map (mobile view)
├── PvzMarker.vue — custom pin with service icon
├── PvzPopup.vue — popup with details (address, hours, cost)
└── DeliveryCostBadge.vue — delivery cost to this pickup point
Vue's reactivity speeds up re-rendering when selecting a pickup point, as noted by Vue.js official documentation. This gives up to 30% time savings in support and modifications compared to jQuery.
Integration with Yandex.Maps
// After ymaps loads
const map = new ymaps.Map('pvz-map', {
center: userCoords, // From geolocation or IP geolocation
zoom: 12,
});
const clusterer = new ymaps.Clusterer({ preset: 'islands#greenClusterIcons' });
pvzPoints.forEach(pvz => {
const placemark = new ymaps.Placemark(
[pvz.latitude, pvz.longitude],
{ balloonContent: pvz.address },
{ preset: 'islands#greenDotIcon' }
);
placemark.events.add('click', () => selectPvz(pvz));
clusterer.add(placemark);
});
map.geoObjects.add(clusterer);
Vue manages the state (selected pickup point, filters by service), the map is accessed via ref and direct API.
How does the widget determine the user's location?
Three sources, used sequentially with fallback:
- Browser geolocation (
navigator.geolocation.getCurrentPosition) — most accurate, requires permission
- IP geolocation — via
\Bitrix\Sale\Location\LocationManager::getUserLocation() or external service
- Last selection — from localStorage/cookie
This guarantees the user always sees relevant points, even if they declined geolocation.
Integration with checkout and delivery recalculation
When a pickup point is selected, we update the store and recalculate delivery:
function selectPvz(pvz) {
checkoutStore.setDeliveryPoint({
deliveryId: pvz.deliveryServiceId,
pvzCode: pvz.code,
address: pvz.address,
coords: [pvz.latitude, pvz.longitude],
});
// Recalculate delivery cost
checkoutStore.recalculateDelivery();
}
Bitrix delivery: \Bitrix\Sale\Delivery\Services\Manager::calculateDeliveryPrice() with the pickup point code passed in the delivery additional data field.
Case study from our practice: a marketplace with three services
Our client was a marketplace with multiple delivery services simultaneously (CDEK + Boxberry + Russian Post). The map had three marker layers with switching. The user could see all pickup points at once or filter by service. The main challenge: CDEK returns 20,000+ points across Russia — loading all upon opening is impossible. Solution: load points only in the visible map area (map.getBounds()) on every viewport change (boundschange event) with a 500 ms debounce. Point cache in Pinia — do not re-request already loaded areas. Result: widget load time under 2 seconds, even on weak devices. The client reported a 25% reduction in order placement time and budget savings on support.
Optimization tip: use IntersectionObserver for lazy loading the map if it is in the lower part of the page. This reduces Initial Paint by 300–500 ms.
Scope of work and timelines
- Integration with any delivery service (CDEK, Boxberry, Russian Post, DPD, Ozon Rocket)
- Choice of mapping engine: Yandex.Maps or Leaflet
- Responsive layout for mobile and desktop
- Server-side and client-side data caching
- Documentation for the component and API
- Testing on real devices
- Post-project support for 30 days
| Option |
Timeline |
| Pickup points for one delivery service, Yandex.Maps |
5–8 business days |
| Multiple services with filtering |
8–12 business days |
| With geolocation, clustering, and lazy loading |
12–18 business days |
Cost is calculated individually — depends on the number of services, filtering complexity, and need for additional options (e.g., displaying delivery cost in the popup).
Comparison of mapping libraries
| Parameter |
Yandex.Maps |
Leaflet + OSM |
| Address detail (Russia) |
high, geocoding available |
medium (OSM) |
| License |
free up to 10,000 requests/day |
MIT (free) |
| Clustering |
built-in |
Leaflet.markercluster plugin |
| Marker customization |
limited |
full (CSS, SVG) |
The Vue.js widget is 2–3 times faster compared to an equivalent jQuery component: fewer DOM redraws, reactive data updates. This is achieved through virtual DOM and render optimization.
Contact us for a consultation on your project — we will analyze requirements and propose the optimal solution. Request a demo of the widget on your project. Over 50 successful widget integrations in Bitrix. Order widget development for your store now to boost checkout conversion.
Why Does CIBlockElement::GetList Kill UX and What Does Vue Have to Do with It
We’ve seen standard bitrix:catalog.section component reload the entire page on every filter click. Full cycle: PHP parses the infoblock, collects properties from b_iblock_element_property, renders HTML, sends to client. On a catalog with 50,000 SKU, this takes 800–1200 ms. Customer clicks three filters — three reloads, 3 seconds of waiting. In e-commerce, this directly leads to up to 20% conversion loss. Vue.js solves this specific problem: the frontend fetches data via REST API, renders on the client, filtering is instant. Bitrix remains the backend: content, catalog, orders, 1С exchange. Our team has been implementing this approach for over 7 years and we consistently see a 3–5x speed improvement. According to Vue.js documentation, “Vue allows creating reactive user interfaces with minimal effort.”
Vue.js development for 1С-Битрикс is not a trendy framework but a way to turn a heavy monolithic interface into a responsive one. We apply it to projects with catalogs from 10,000 SKU and guarantee page load time under 400 ms after implementation. Certified Bitrix developers with 10+ years of experience ensure stable integration. Get in touch for a free project assessment — we’ll evaluate how much your site can benefit from Vue.js development.
When Is Vue Justified?
Not every site needs a frontend framework. Vue is justified when standard Bitrix components cannot keep up. Main scenarios:
- Catalogs with heavy filtering —
catalog.smart.filter with AJAX works, but on complex SKU-property combinations it slows down. Vue + API = instant response. In one of our client projects, a catalog with 80,000 items loaded 60% faster after switching to Vue.
- Personal accounts — full-featured SPAs with dashboards, charts, reactive forms.
sale.personal.section looks outdated.
- Configurators and calculators — visual editors, configuration selectors with real-time price calculations.
- Real-time — chats, notifications, stock updates via WebSocket.
- PWA — offline mode, push notifications, home screen installation.
How Does Vue.js Solve UX Problems in Bitrix?
Comparison: standard bitrix:catalog.section component filters 50,000 items in 800 ms + page reload. Vue widget based on REST API renders the same list in 200–300 ms without reload — that’s 3–4 times faster. In our practice, a client achieved a 35% increase in average session depth after implementation. Savings on server infrastructure can reach $3000 per month. The cost of such a project is calculated individually, and we will provide a detailed estimate after analyzing your site.
What Are the Three Architectural Approaches to Integrating Vue.js with Bitrix?
Island — Vue Widgets on Bitrix Pages
Individual Vue components are mounted into div#app-filter, div#app-cart on standard Bitrix pages. Routing and server-side rendering remain with Bitrix. Minimal intervention into the existing site.
Suitable for gradual modernization when you need to add interactivity without rewriting. A typical example is a reactive filter replacing catalog.smart.filter. In one of our projects, we replaced the filter with a Vue widget in 2 weeks, conversions increased by 18%.
SPA on Vue + Bitrix REST API
Frontend — a full-featured Vue application with Vue Router. Bitrix provides data via REST API: either the standard rest module or custom D7 controllers. Bitrix admin panel manages content; the editor sees no difference.
Ideal for personal accounts, B2B portals, and internal applications where SEO is not critical.
Nuxt.js + Bitrix as Headless CMS
Nuxt provides SSR/SSG for indexing. Bitrix is headless: it returns data via API and manages content. For stores and content-heavy sites where SEO is a priority. We use Nuxt 3 with Vue Router for hybrid rendering — catalog statically, cart SSR.
Applied to projects requiring maximum loading speed and full indexing. Savings on licenses and servers can be substantial.
What Bitrix REST API Features Matter for Vue Development?
This accounts for 70% of time when integrating Vue + Bitrix.
Standard REST Module
Infoblocks, catalog, cart (sale.basket.*), orders (sale.order.*), users — out of the box. Limitation: standard methods do not always cover custom logic. The catalog.product.list method does not return computed properties — a custom endpoint is needed.
Custom D7 Controllers
The Bitrix\Main\Engine\Controller class is the proper way to create an API for Vue. Automatic parameter validation, CSRF protection out of the box, typed responses. Not ajax.php with $_POST — that leads to injections.
namespace App\Controller;
use Bitrix\Main\Engine\Controller;
class CatalogController extends Controller
{
public function getProductsAction(array $filter, int $page = 1): array
{
// ORM query to infoblock, not CIBlockElement::GetList
}
}
Authorization and Caching
Authorization: OAuth 2.0 for SPA or session tokens. Rate limiting — via Bitrix\Main\Engine\Controller or nginx. Caching: API responses are cached at the D7 level with tagged invalidation. Product changed in infoblock — cache cleared by tag iblock_id_X. Without this, at 100 RPS the server will crash. We configure this in every project — guarantee of stability under load.
Example of configuring tagged caching for API:
use Bitrix\Main\Data\Cache;
$cache = Cache::createInstance();
$tag = 'iblock_id_' . $iblockId;
if ($cache->initCache(3600, md5($filter), $tag)) {
return $cache->getVars();
}
// database query
$cache->startDataCache();
$cache->endDataCache($data);
\CIBlock::registerWithTagCache($iblockId);
Structure of Vue Application for Bitrix
- Vue Router — lazy loading routes via
defineAsyncComponent. Catalog does not pull in personal account code.
- Pinia — state management: catalog, cart, user, filters. Modular store architecture. Vuex is legacy; new projects use Pinia.
- Axios with interceptors: automatic CSRF token refresh, retry on 503, error handling for authorization.
- Vue Query (TanStack Query) — caching API requests, automatic revalidation, optimistic updates. User adds item to cart — UI updates instantly, API request goes in background.
Catalog on Vue — Key Use Case Breakdown
The difference in UX is immediately noticeable. Specifics:
- Filter — checkboxes, range sliders, select with search. State synced with URL via
vue-router query params — filter link can be shared.
- Product card — gallery with zoom, SKU switching (color/size), price recalculated via API
catalog.product.offer.list, stock from catalog.store.product.list.
- Virtual scrolling —
vue-virtual-scroller renders only visible items. Catalog of 10,000 items works smoothly.
- Smart search — debounced queries to
search.title.search or ElasticSearch, autocomplete via dropdown. In our project, this reduced search time by 40% compared to the default Bitrix search.
- Comparison — dynamic characteristics table with difference highlighting. Storage in Pinia + localStorage for persistence.
How We Implement Vue.js: Step-by-Step Plan
- Audit current Bitrix architecture and identify bottlenecks (filtering, cart, personal account).
- Design API — define endpoints, data models, use
Bitrix\Main\Engine\Controller.
- Develop Vue widgets or SPA — build with Vite, Code Splitting, Pinia.
- Integrate with Bitrix — tagged caching, OAuth, error handling.
- Load testing (up to 100 RPS) and deploy with CI/CD.
Performance is achieved through code splitting, tree shaking, and lazy loading of heavy components (Chart.js, maps, WYSIWYG). Catalog page bundle is 80–120 KB gzip.
How Does Nuxt.js and SEO Preserve Indexing?
A pure Vue SPA returns an empty HTML with <div id="app"></div> to search engines. Google can render JS but with days-long delay. Yandex is unpredictable. Nuxt.js solves this:
- SSR — server returns full HTML, after hydration works as SPA.
- SSG — pages generated on
nuxt generate, served from CDN. Maximum speed.
- Hybrid mode — catalog static, cart and personal account SSR.
-
useHead() — dynamic title, description, Open Graph, Schema.org for each page.
- Sitemap —
@nuxtjs/sitemap, routes from Bitrix API. This ensures full indexing — our guarantee for top-5 Google ranking.
Approach Comparison and Timelines
| Situation |
Recommended Approach |
Business Impact |
| Catalog 10,000+ SKU, complex filter |
Vue widgets |
3–5x speedup, 15-25% conversion increase |
| B2B portal, personal account |
SPA on Vue |
Up to 70% server load reduction |
| Store with SEO priority |
Nuxt.js + headless |
100% page indexing, 0.8s load speed |
| Approach |
Timelines |
Deliverables |
| Vue widgets (2–5 components) |
1–3 weeks |
Reactive elements on existing site |
| SPA for personal account |
4–8 weeks |
Vue application + API on D7 controllers |
| Catalog on Vue + Bitrix API |
4–10 weeks |
Filtering, cart, comparison without reloads |
| Nuxt.js + Bitrix headless |
6–12 weeks |
SSR/SSG, full functionality, SEO |
Full cycle: API design, D7 controller development, Vue application, Vite setup, testing, deployment. Code is reviewed, tested, documented — not "build and forget." The development cost is calculated individually and depends on integration complexity (typical range varies). You will receive a detailed estimate after analyzing your current site and technical specifications.
Common Mistakes When Integrating Vue.js and Bitrix
- Using
ajax.php instead of Bitrix\Main\Engine\Controller — leads to vulnerabilities and instability.
- Lack of tagged API caching — server cannot handle high load.
- Ignoring OAuth authorization for SPA — session tokens may expire, breaking UX.
- Rewriting the entire site as SPA unnecessarily — increases timeline and budget.
- Incorrect Nuxt SSR configuration — slow page generation on backend.
Detailed technical considerations
-
Script loading order: Bitrix core scripts must not conflict with Vue. Use
window.BX24 only after Vue app is mounted.
-
EventBus pattern: For cross-widget communication, prefer Pinia over
$emit chains.
-
Error handling: Wrap REST calls in a global Axios interceptor that retries on 503 and logs to Bitrix admin log.
What We Deliver and Our Guarantees
-
API documentation (Swagger/OpenAPI) for integration with your backend.
-
Code repository access and CI/CD pipeline.
-
Team training on Vue component usage and maintenance.
-
1 month post-release support — stability guarantee.
-
Code complies with PSR-12 and
Bitrix\Main\Engine\Controller standards.
Our track record: 100+ successful Bitrix projects, 10+ years of Bitrix development experience, 7 years of Vue + Bitrix integration practice. We deliver turnkey solutions — from a simple filter widget to a full Nuxt.js headless store.
Order Vue.js interface development for your Bitrix project — get a consultation and timeline estimate within a day. Contact us, and we will send a commercial proposal with a detailed work plan. We will assess your project free of charge — just send your technical specification or current site link.