Ecommerce integration, done real-time
A standalone, decoupled integration that connected a Shopware store with the Verto ERP plus supporting services (Shipments API, PayU payments, notifications). It synchronized orders, items, products, stock, order statuses, currencies, taxes, and key settings — including a special flow for gift cards — with clear ownership of responsibilities across systems.
The problem
Integrate Shopware and Verto ERP seamlessly and reliably, while coordinating external services — and do it in real time with crash-safe recovery and easy script adjustments.
Bidirectional sync at scale
Orders, products, stock levels, statuses, currencies, taxes, and ERP/e-commerce settings had to stay in lockstep without race conditions.
Reliability & fault detection
Transient failures (APIs, network, timeouts) needed detection, retries, and safe replays without data duplication.
Clear ownership
Each field/state must have a single source of truth with strict delegation between ERP and e-commerce.
Gift card flows
Gift card issuance, redemption, and balance adjustments required consistent state across all systems.
The solution
A standalone Node.js service (Nest.js) combining webhooks for immediate reactions with background processors for periodic and corrective jobs.
Responsibility matrix & data mapping
Defined which system owns which entity/field (orders, items, products, stock, statuses, currencies, taxes, settings) and the exact transformations between Shopware and Verto.
Real-time webhooks
Subscribed to events from Shopware, Verto, Shipments API, and PayU to trigger immediate syncs for order lifecycle, payments, shipments, and notifications.
Background processors
Nest.js processors handled periodic reconciliations, backfills, retries, and drift detection to keep systems convergent over time.
Error handling & observability
Structured logging, idempotent operations, and retry strategies ensured safe recovery and made script adjustments straightforward.
Gift card orchestration
Dedicated flow covering issue, redeem, and balance sync with safeguards against double spending or stale balances.
What it delivers
Decoupled, platform-agnostic integration that’s easy to extend and dependable in production.
Platform independence
The integration stands alone, so the e-commerce platform can be swapped without rewriting ERP logic.
Easy extensibility
Clear module boundaries make it simple to add new entities, services, or flows.
Operational reliability
Idempotency, retries, and background reconciliation keep data consistent even when external APIs wobble.
Real-time responsiveness
Webhooks propagate critical changes instantly; processors keep everything in sync over time.
Transparency
Readable code and structured logs make it obvious what happened and why.
Stack & integrations
Backend-focused service built on Node.js/Nest.js, deployed on Kubernetes in Google Cloud, integrating with commerce, ERP, payments, shipping, and notifications.
Core runtime
- Node.js: Event-driven runtime for webhooks and processors.
- Nest.js: Modular architecture with queues/processors for background jobs.
Infrastructure
- Google Cloud: Managed cloud environment for networking, secrets, and storage needs.
- Kubernetes: Container orchestration for scalability, resilience, and rollout control.
Connected systems
- Shopware: E-commerce platform emitting product/order events and consuming sync updates.
- Verto ERP: System of record for inventory, pricing, taxes, currencies, and order accounting.
- Shipments API: Parcel creation and tracking integration via webhooks and processors.
- PayU: Payment authorization and settlement events tied to order status updates.
- Notification Services: Outbound notifications on key lifecycle events.
Domain coverage
- Orders & Items: Create, update, status transitions, and line-item integrity.
- Products & Stock: Catalog fields and real-time availability from ERP to shop.
- Statuses: Shipment and payment states synchronized across parties.
- Currencies & Taxes: ERP-driven configuration mirrored to the storefront.
- Gift Cards: Issue, redeem, and reconcile balances safely.
Ready to Integrate Your E-commerce Platforms?
Streamline your multi-channel e-commerce operations with a unified integration platform that grows with your business.