Invite your sales reps
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua - a concise primer on the moving parts, before you get to the reference.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua - a concise primer on the moving parts, before you get to the reference.
Overview
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium.
Before you begin
You will need:
- A Shopware 6.7+ instance (SaaS, PaaS, or self-hosted)
- An admin account with API access rights
- SWAG Commercial installed if you intend to use quotes
- A tablet or desktop with a modern browser (Chromium 120+, Safari 17+, Firefox 122+)
Step 1 - Configure
Totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit.
Environment variables
# .env.axon
SHOPWARE_URL="https://shop.example.com"
SHOPWARE_ADMIN_CLIENT_ID="administration"
SHOPWARE_STORE_ACCESS_KEY="SWSC..."
AXON_TENANT="acme-eu"
AXON_TRANSPORT="messagepack" # or "json"
Required headers
| Header | Value | Purpose |
|---|---|---|
Accept | application/x-msgpack | Binary transport |
Authorization | Bearer <token> | OAuth2 admin token |
sw-context-token | <opaque> | Per-customer Store API session |
X-Crehler-Debug | 1 | Force JSON for DevTools inspection |
Step 2 - Verify
Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem.
"Consequences of adding a second source of truth: eventually, two sources that disagree." - design rule #1
Step 3 - Go live
- Invite your first sales rep from
Settings -> Team - Share the install URL via email or QR code
- Ask the rep to tap Add to Home Screen
- Confirm they land on a filled dashboard within five seconds
Common issues
At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident.
- 401 on first call - OAuth2 token not refreshed; check system clock skew.
- Empty catalogue -
sales-channelheader missing or points to the wrong channel. - Slow search - IndexedDB cache priming. Wait 30s after first login.
Related reading
- IndexedDB local cache: limits, eviction, wipe
- Admin API endpoints Axon uses
- "Session lapsed" overlay - what it means
Was this page helpful?
We read every response.