sboulahtit/orion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add OMS positioning strategy and implementation plan

Browse Source 
- Add "Lightweight OMS for Letzshop Sellers" positioning strategy
- Add back-office vs marketing positioning comparison
- Update pricing tiers for OMS model (Essential/Professional/Business)
- Add VAT invoice feature technical specification
- Add comprehensive OMS feature implementation plan
- Fix code block formatting in synology doc

New docs:
- docs/marketing/strategy/back-office-positioning.md
- docs/marketing/strategy/customer-marketing-positioning.md
- docs/implementation/vat-invoice-feature.md
- docs/implementation/oms-feature-plan.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Samir Boulahtit
2025-12-23 23:57:02 +01:00
parent 0be95e079d
commit 4d9b816072
7 changed files with 2175 additions and 128 deletions
Download Patch File Download Diff File Expand all files Collapse all files

303
docs/marketing/strategy/back-office-positioning.md Normal file
View File

@@ -0,0 +1,303 @@
# Strategic Positioning: Lightweight OMS for Letzshop Sellers
## The Core Insight
Letzshop vendors don't need another e-commerce platform. They need a **lightweight Order Management System** that works alongside Letzshop, not instead of it.
**Key realization:** Competing with Letzshop's native features is weak positioning. The value is in providing a proper **OMS layer** that Letzshop lacks - inventory truth, correct invoicing, operational tools.
## Product Category
**"Lightweight OMS for Letzshop Sellers"**
| What It Is | What It's Not |
|------------|---------------|
| Order Management System | E-commerce platform |
| Back-office operations | Customer-facing storefront |
| Works WITH Letzshop | Replaces Letzshop |
| Right-sized for SMB | Enterprise complexity |
---
## Real Pain Points (From Vendor Experience)
| Pain Point | Current Workaround | Impact |
|------------|-------------------|--------|
| Inventory out of sync across channels | Manual updates, spreadsheets | Overselling, lost sales |
| Need another app to find products | Separate warehouse app, memory | Slow picking, errors |
| Stock not linked to incoming purchases | Mental notes, spreadsheets | False "out of stock" |
| VAT wrong for cross-border EU shipping | Accountant fixes, or ignore | Compliance risk, costs |
| Can't retarget/contact past customers | Letzshop owns the relationship | Lost repeat business |
---
## The Positioning
### What We Are NOT
- Not a Letzshop replacement
- Not a full e-commerce platform
- Not an enterprise ERP system
### What We ARE
> **"Lightweight OMS for Letzshop Sellers"**
>
> Letzshop is where you sell. Wizamart is where you manage operations.
A focused Order Management System for vendors who:
- Sell on Letzshop + other channels (own website, markets, B2B)
- Need professional invoicing with correct VAT
- Want to own their customer relationships
- Need real inventory management, not just Letzshop's view
---
## Target Customer
**Primary:** Multi-channel Letzshop vendors
- Sell on Letzshop + at least one other channel
- 50-500 orders/month total
- Frustrated with manual sync and spreadsheets
- May have accountant who complains about VAT
**Secondary:** Growing Letzshop-only vendors
- Planning to expand to other channels
- Want professional operations before they scale
- Need correct invoicing for EU customers
**NOT targeting:** Pure Letzshop vendors happy with manual processes
---
## Core Feature Set
### 1. Inventory Truth (Central Stock Management)
**Problem:** Letzshop shows its own stock count, but vendor sells elsewhere too.
**Solution:**
- Single source of truth for all inventory
- One-way push to Letzshop (keeps it in sync)
- Vendor updates here when selling on other channels
- No complex connectors needed - vendor is the sync
**Value:** Never oversell. Always know real stock.
### 2. Product Locations
**Problem:** Vendor has to open another app to find where products are stored.
**Solution:**
- Location/bin field on each product
- Shows in order picking view
- Print pick lists with locations
**Value:** Faster fulfillment, fewer errors.
### 3. Incoming Stock / Purchase Orders
**Problem:** Stock levels don't reflect what's on order from suppliers.
**Solution:**
```
In stock: 5 units
Reserved: 2 units
Available: 3 units
On order: 50 units (arriving Jan 15)
───────────────────────
Available to promise: 53 units
```
**Value:** Don't mark products unavailable when restock is days away.
### 4. Smart VAT Invoicing (Differentiator)
**Problem:** EU VAT depends on destination country. Letzshop invoices don't handle this.
**Solution:**
- Automatic VAT calculation based on ship-to country
- Handles OSS (One-Stop-Shop) rules
- Generates compliant PDF invoices
- Proper VAT breakdown per rate
**Value:** Compliance without accountant. Professional documents.
### 5. Customer Ownership
**Problem:** Letzshop owns the customer relationship. Vendor can't retarget or build loyalty.
**Solution:**
- All customers in your database
- Order history and lifetime value
- Export for email marketing (Mailchimp, etc.)
- Tagging and segmentation
**Value:** Build repeat business. Own your customers.
---
## Why This Wins
### Low Support Overhead
| Feature | External Dependencies | Support Risk |
|---------|----------------------|--------------|
| Inventory management | None | Low |
| Product locations | None | Very Low |
| Purchase orders | None | Low |
| VAT invoicing | None (just rules) | Low |
| Customer export | None | Low |
No connectors to WooCommerce/Shopify = No "why isn't it syncing?" tickets.
### High Perceived Value
| Feature | Why It Feels Valuable |
|---------|----------------------|
| Inventory truth | "Finally, one place for everything" |
| VAT invoicing | "My accountant will love this" / fear of compliance |
| Customer ownership | "I can finally email my customers" |
### Defensible Position
Letzshop is unlikely to build:
- Multi-channel inventory (they want you Letzshop-only)
- Correct cross-border VAT (complex, not their core)
- Customer export (they benefit from owning relationships)
---
## Pricing Tiers
### Tier Logic: What Drives Upgrades?
The goal is natural upgrade pressure based on **growth**, not artificial limits.
| Growth Signal | Triggers Upgrade To |
|---------------|---------------------|
| More orders | Higher tier (volume) |
| Shipping to EU | Pro (VAT invoicing) |
| Team grows | Pro/Business (users) |
| More products | Pro (locations, PO) |
| Multiple shops | Business (multi-vendor) |
---
### Essential - EUR 49/month
**Target:** Solo vendors, getting started, Letzshop + 1 channel
| Feature | Limit |
|---------|-------|
| Letzshop Order Sync | Up to 100 orders/month |
| Inventory Management | Up to 200 products |
| Basic Invoices (Luxembourg) | Included |
| Team Members | 1 user |
| Order History | 6 months |
| Email Support | 72h response |
**Why they upgrade:** Hit order limit, need EU VAT invoices, need team access.
---
### Professional - EUR 99/month
**Target:** Active vendors, multi-channel, shipping EU-wide
| Feature | Limit |
|---------|-------|
| Letzshop Order Sync | Up to 500 orders/month |
| Inventory Management | Unlimited products |
| **EU VAT Invoices** | All EU countries |
| **Product Locations** | Warehouse/bin tracking |
| **Incoming Stock / PO** | Track supplier orders |
| **Customer Export** | CSV for marketing |
| Team Members | 3 users |
| Order History | 24 months |
| Priority Email Support | 24h response |
**Why they upgrade:** Multiple team members, multiple Letzshop accounts, need API.
---
### Business - EUR 199/month
**Target:** Teams, high volume, multiple vendor accounts
| Feature | Limit |
|---------|-------|
| Letzshop Order Sync | Unlimited orders |
| Everything in Professional | Included |
| **Multi-Vendor Support** | Multiple Letzshop accounts |
| **API Access** | For custom integrations |
| **Accounting Export** | CSV/XML for accountants |
| Team Members | 10 users |
| Team Roles & Permissions | Full RBAC |
| Order History | Unlimited |
| Phone Support | Available |
| Dedicated Onboarding | Included |
---
### Feature Access by Tier
| Feature | Essential | Professional | Business |
|---------|:---------:|:------------:|:--------:|
| Letzshop Order Sync | 100/mo | 500/mo | Unlimited |
| Inventory Management | 200 SKU | Unlimited | Unlimited |
| Product Locations | - | ✓ | ✓ |
| Incoming Stock / PO | - | ✓ | ✓ |
| Basic Invoice (LU) | ✓ | ✓ | ✓ |
| EU VAT Invoice | - | ✓ | ✓ |
| Customer List | View | + Export | + Export |
| Team Members | 1 | 3 | 10 |
| Multi-Vendor | - | - | ✓ |
| API Access | - | - | ✓ |
| Order History | 6 mo | 24 mo | Unlimited |
---
### Why This Structure Works
1. **Essential (EUR 49)** is genuinely useful but has natural limits
- 100 orders/month is ~3/day - fine for small sellers
- Luxembourg-only invoices work if you don't ship EU
- 1 user is fine for solo operation
2. **Professional (EUR 99)** unlocks the "serious" features
- EU VAT invoicing is the killer upgrade trigger
- Product locations + PO = operational maturity
- 3 users = small team
3. **Business (EUR 199)** is for scale
- Multi-vendor = manages multiple Letzshop shops
- API = integrates with other systems
- 10 users = real team
**Price anchoring:** EUR 99 is the target tier. EUR 49 exists to capture price-sensitive leads. EUR 199 exists to make EUR 99 look reasonable.
---
## Competitive Positioning
| Alternative | Their Limitation | Our Advantage |
|-------------|------------------|---------------|
| Just use Letzshop | No multi-channel inventory, wrong VAT, no customer access | Complete back-office |
| Spreadsheets | Error-prone, no automation, time-consuming | Professional, synced |
| Full ERP (SAP, Odoo) | Overkill, expensive, complex | Right-sized, affordable |
| Accountant fixes VAT | EUR 50-100/month for corrections | Built-in, automatic |
---
## Go-to-Market
### Message Hierarchy
**Primary:** "The back-office Letzshop doesn't give you"
**Supporting:**
1. "One inventory for all your channels"
2. "Invoices with correct VAT, any EU country"
3. "Your customers, your data"
### Initial Outreach Target
Vendors who:
- Have their own website AND Letzshop presence
- Ship to multiple EU countries
- Have complained about Letzshop limitations
### Proof Points to Gather
- Time saved per week on manual sync
- VAT corrections avoided
- Overselling incidents prevented

272
docs/marketing/strategy/customer-marketing-positioning.md Normal file
View File

@@ -0,0 +1,272 @@
# Customer Ownership & Marketing Positioning
## The Problem
Letzshop owns the customer relationship. Vendors:
- Can't export customer emails easily
- Can't send marketing campaigns
- Can't retarget past buyers
- Lose repeat business to marketplace algorithm
**Result:** Vendors acquire customers through Letzshop but can't turn them into loyal, direct customers.
---
## What "Customer Ownership" Could Look Like
### Level 1: Data Export (Simple)
**What it is:** Export customer list with order history to CSV.
```
┌────────────────────────────────────────────┐
│ Wizamart Dashboard │
│ ┌──────────────────────────────────────┐ │
│ │ Customers (142) [Export CSV] │ │
│ ├──────────────────────────────────────┤ │
│ │ Marie Dupont 3 orders €245 │ │
│ │ Jean Martin 1 order €89 │ │
│ │ Sophie Weber 5 orders €512 │ │
│ └──────────────────────────────────────┘ │
└────────────────────────────────────────────┘
│
▼ Export
┌────────────────────────────────────────────┐
│ email,name,orders,total_spent,last_order │
│ marie@...,Marie Dupont,3,245,2024-12-01 │
│ jean@...,Jean Martin,1,89,2024-11-15 │
└────────────────────────────────────────────┘
│
▼ Import manually
┌────────────────────────────────────────────┐
│ Mailchimp / Brevo / etc. │
└────────────────────────────────────────────┘
```
**Effort:** ~2 days (you already have customer data from orders)
**Support overhead:** Very low
**Value:** Medium - manual but functional
---
### Level 2: Smart Segmentation (Medium)
**What it is:** Tag customers, filter by behavior, export segments.
```
┌────────────────────────────────────────────┐
│ Customer Segments │
│ ┌──────────────────────────────────────┐ │
│ │ 🏆 VIP (5+ orders) 23 │ │
│ │ 😴 Dormant (no order 90d) 45 │ │
│ │ 🆕 New (first order) 12 │ │
│ │ 🇩🇪 Germany shipping 34 │ │
│ │ 🎁 Holiday buyers 2023 28 │ │
│ └──────────────────────────────────────┘ │
│ │
│ [Export Segment to CSV] │
└────────────────────────────────────────────┘
```
**Features:**
- Auto-tagging based on behavior (VIP, dormant, new)
- Manual tagging (wholesale, problem customer)
- Filter by: country, order count, total spent, last order date
- Export filtered lists
**Effort:** ~1 week
**Support overhead:** Low
**Value:** High - actionable data
---
### Level 3: Mailchimp Integration (Complex)
**What it is:** Direct sync with Mailchimp - customers auto-sync, segments sync, tags sync.
```
┌─────────────┐ ┌─────────────┐
│ Wizamart │ ──────► │ Mailchimp │
│ │ Sync │ │
│ Customers │ ◄────── │ Audiences │
│ Orders │ │ Tags │
│ Segments │ │ Campaigns │
└─────────────┘ └─────────────┘
```
**API Integration Required:**
- Mailchimp Marketing API v3
- OAuth 2.0 for account connection
- Webhook for unsubscribes (GDPR)
- Audience sync (create/update members)
- Tag sync (apply tags from segments)
**Effort:** ~2-3 weeks
**Support overhead:** MEDIUM-HIGH
- "Why aren't my contacts syncing?"
- "My tags aren't showing up"
- Mailchimp API changes / deprecations
- GDPR compliance (unsubscribe sync)
**Value:** High - but is it 2-3 weeks of value?
---
### Level 4: Built-in Email Marketing (Very Complex)
**What it is:** Send emails directly from Wizamart.
**Required:**
- Email template builder
- Email sending infrastructure (SendGrid, SES, Postmark)
- Deliverability management (SPF, DKIM, DMARC setup)
- Bounce/complaint handling
- Unsubscribe management
- Open/click tracking
- A/B testing
- Scheduling
- Campaign analytics
**Effort:** 2-3 months (to do it well)
**Support overhead:** VERY HIGH
- "My emails go to spam"
- "Why didn't my campaign send?"
- Deliverability issues
- GDPR compliance
**Value:** Very high - but you're building Mailchimp
**Verdict:** Don't do this. Use existing tools.
---
## Comparison: Back-Office vs Marketing Positioning
### Option A: Back-Office Focus (Invoicing, Inventory, Operations)
| Aspect | Assessment |
|--------|------------|
| **Core message** | "Run your business better" |
| **Primary features** | VAT invoicing, inventory truth, locations, incoming stock |
| **Target emotion** | Fear (compliance), relief (organization) |
| **Competitive moat** | VAT expertise, Letzshop-specific |
| **Support overhead** | Low (self-contained systems) |
| **Development effort** | ~2-3 weeks for MVP |
| **Revenue model** | Subscription (necessary tool) |
**Customer type:** Operations-focused, compliance-worried
### Option B: Marketing Focus (Customer Ownership, Retargeting)
| Aspect | Assessment |
|--------|------------|
| **Core message** | "Grow your business" |
| **Primary features** | Customer CRM, segmentation, Mailchimp sync |
| **Target emotion** | Ambition (growth), frustration (Letzshop limits) |
| **Competitive moat** | Weak (many CRM tools exist) |
| **Support overhead** | Medium-High (external integrations) |
| **Development effort** | ~3-4 weeks for meaningful features |
| **Revenue model** | Subscription (growth tool) |
**Customer type:** Growth-focused, marketing-savvy
---
## The Strategic Question
### Who is easier to sell to?
| Customer Type | Buys Because | Objection |
|---------------|--------------|-----------|
| **Operations person** | "I need this to not mess up" | "Is it really necessary?" |
| **Growth person** | "This will make me money" | "Will it actually work?" |
### Which has stickier retention?
| Tool Type | Stickiness | Why |
|-----------|------------|-----|
| **Back-office** | HIGH | Your invoices, inventory data - hard to migrate |
| **Marketing** | MEDIUM | Customer list is portable, can switch tools |
### Which is simpler to support?
| Tool Type | External Dependencies | Support Risk |
|-----------|----------------------|--------------|
| **Back-office** | None | LOW |
| **Marketing** | Mailchimp API, email delivery | MEDIUM-HIGH |
---
## My Recommendation
### Start with Back-Office, Add Customer Export
**Phase 1 (Now):** Back-office tools
- VAT invoicing (differentiator, compliance fear)
- Inventory management (already built)
- Product locations (simple, useful)
- Incoming stock/PO (nice to have)
- **Customer export to CSV** (satisfies marketing need without complexity)
**Phase 2 (Later, if demand):** Marketing enhancement
- Smart segmentation
- Mailchimp sync (only if customers ask for it specifically)
### Why This Order?
1. **Back-office is a "must-have"** - vendors need correct invoices
2. **Marketing is a "nice-to-have"** - they can use Mailchimp directly with CSV export
3. **Lower risk** - no external API dependencies to start
4. **Faster to market** - VAT invoicing is ~1 week, Mailchimp is ~3 weeks
5. **Clearer positioning** - "The back-office Letzshop doesn't give you"
### The Hybrid Pitch
> "Wizamart gives you the tools Letzshop doesn't:
>
> - **Correct invoices** with proper VAT for any EU country
> - **Real inventory** across all your channels
> - **Your customers** - export anytime for your marketing
>
> EUR 49/month. You focus on selling, we handle the back-office."
The customer export feature satisfies the marketing need without building a marketing platform.
---
## If You Want Marketing Focus Instead
If you strongly feel marketing is the right angle:
### Minimum Viable Marketing Product
1. Customer list with order history ✓ (you have this)
2. Basic tagging (manual + auto VIP/dormant)
3. Segment filtering
4. CSV export with segments
5. **Mailchimp sync** (this is the "magic" feature)
**Skip:** Built-in email sending, campaign builder, analytics
**Effort:** ~3 weeks total
**The pitch becomes:**
> "Own your Letzshop customers. Sync them to Mailchimp automatically.
> Build repeat business without copy-pasting spreadsheets."
But: This competes with many existing tools. Back-office is more defensible.
---
## Final Comparison Table
| Factor | Back-Office (Invoicing) | Marketing (Customer CRM) |
|--------|------------------------|--------------------------|
| Uniqueness | HIGH (VAT expertise) | LOW (many CRM tools) |
| Development time | ~2 weeks | ~3-4 weeks |
| Support overhead | LOW | MEDIUM-HIGH |
| External dependencies | NONE | Mailchimp API |
| Stickiness | HIGH | MEDIUM |
| Emotional driver | Fear (compliance) | Ambition (growth) |
| Price sensitivity | LOW (necessary) | HIGH (nice-to-have) |
| **Recommendation** | **START HERE** | Add later if demanded |