Platform architecture

BEWISE is not a simple connector but a full middleware layer. Below the technical setup for IT architects and developers.

From source to destination

Every order, stock mutation or customer change goes through a standardised pipeline — regardless of platform or ERP.

⬆️
Source platforms
WooCommerce, Shopify, Shopware, Bol.com

Webhook ingest & polling adapters capture events from external systems.

🔄
Canonical DTOs
CanonicalOrder, CanonicalCustomer, PullResult

Universal data model that normalises platform-specific payloads.

⚙️
BEWISE Core
Orchestration, routing, retry, audit

IntegrationRouteResolver determines the correct flow per tenant and source.

⬇️
ERP destinations
Odoo, Exact, SW-Retail, Business Central

Destination adapters translate canonical DTOs into ERP API calls.

Built for enterprise requirements

🔁

Retry & error handling

5 attempts, exponential backoff (60→300→900→1800s). Specific error codes like SKU_NOT_FOUND fail immediately.

🏢

Multi-tenancy

Full tenant isolation at database level via tenant_key. Platform admins see all tenants; users only their own scope.

🗺️

Configurable field mappings

Field mappings, pricing mode (destination/payload) and status filters configurable per integration flow via Filament UI.

📊

Filament admin UI

Two panels: Admin panel for platform admins and power users; Portal for end-customers with simplified view.

Webhook + polling

Webhooks for direct events (WooCommerce, Shopify); cursor-based polling for Shopware, Bol.com and SW-Retail.

🔐

Encrypted settings

API credentials stored as encrypted JSON per connection. Never in plain text in the database.

Configuration at every level

BEWISE uses a strict three-tier model for settings: global, per connection and per flow. Every setting has exactly one place.

TierLocationUse
Globalsettings tablePlatform-wide
Connectionintegration_connections.settingsAPI credentials
Flowintegration_flows.settingsField mappings

Questions about the architecture?

Our team is happy to think along with your specific integration scenario and technical requirements.