Quickstart: 6-Step Complete Tutorial
From zero to fully operational in 30 minutes.
Before You Start
This tutorial is for first-time users. Follow along step by step the first time you open Shopman.
Installation
1. Download and Install Shopman (Official Electron Build)
Visit shopman.cooder.co and click Download, or download directly:
- Windows: Download shopman_setup.exe
- macOS: Download shopman_setup.dmg
After installation, Shopman appears in the system tray (bottom-right on Windows). It starts a local Fastify server on port 17921.
2. Initialize the Built-in Browser Assistant
Shopman's order sync, 3-file handling, and WangWang auto-fill depend on the built-in browser assistant packaged with the Electron app.
You do not need to manually install anything in chrome://extensions/.
When opening TikTok/1688 pages for the first time, ensure the Shopman icon is visible in the browser toolbar.
Step 1: Sync Suppliers
Goal: Import 1688 supplier data into Shopman to build your sourcing library.
Option A: Bulk Import from 1688 Favorites (Recommended)
- Ensure Shopman is running in the background
- In Chrome, open your 1688 Favorites
- Click the Shopman extension icon → Sync Suppliers
- The extension scans each supplier's name, WangWang ID, contacts, and shipping address
- In Shopman, click Suppliers in the left menu to confirm the import
Anti-bot Notice
1688 has request rate limits. Shopman uses human-like delay strategies (log-normal random intervals + occasional long pauses), with a default daily cap of 150 suppliers. For large imports, spread across two days.
Option B: Manual Entry
Left menu → Suppliers → + → Fill in details → Save
Step 2: Bind Products to SKUs
Goal: Assign a supplier to each TikTok SKU so the system can auto-match orders.
Product data can be captured directly from a 1688 product page, or maintained under the expanded product area inside Suppliers.
- Click any SKU badge on the home screen, or open Suppliers and expand the matching supplier to manage products
- Find red-badged SKUs (no supplier bound yet)
- Click the SKU → Edit → Add Sourcing
- Select supplier → Enter purchase price → Set as default → Save
Badge Colors
- 🟢 Green: Default supplier bound — fully automatic
- 🟡 Yellow: Bound but no default — manual selection required
- 🔴 Red: No supplier bound — cannot auto-dispatch
Step 3: Sync Orders + Auto-Download 3 Files
Goal: One-click sync all pending TikTok orders with automatic barcode, delivery slip, and logistics note handling.
- Open TikTok Seller Center - Orders
- Confirm pending orders are visible on the page
- Click the Shopman extension icon → 🔄 One-Click Sync
- The system automatically:
- Scans all pending orders (order ID, SKU, buyer address)
- Downloads barcode files + delivery slips + logistics notes in bulk
- Backfills missing logistics notes in a retry queue
- Pushes order data to Shopman via WebSocket
- Shopman home screen refreshes with updated order counts
Expected timing
When suppliers, products, and SKU bindings are already prepared, 15-20 orders can commonly be processed in around 30 minutes. The sync plus 3-file stage alone usually takes about 10-20 minutes, depending on network speed and page responsiveness.
Steps 4–6: The 6-Step Dispatch Workflow
Goal: Process each order through the complete dispatch chain to shipped.
On the Shopman home screen, expand any order row to see the 6-step progress bar.
① Confirm Supplier (Auto)
System auto-matches the default supplier based on SKU bindings. To change: click Select Supplier.
② Arrange Logistics
Choose logistics type:
- Platform Pickup: TikTok collects from supplier address
- Self-Delivery: Seller arranges own delivery
Click Confirm Logistics.
③ WangWang Order Message
- Select a message template
- Variables auto-filled (product name, buyer address, quantity, logistics type)
- Click Open in WangWang (Auto-Fill)
- 1688 IM opens with the message pre-injected in the chat box
- Confirm and send
④ Submit 1688 Order
- Complete the order on 1688's product page
- Extension detects the order result page, auto-captures and records the 1688 order number
⑤ Payment Confirmation
- Manual: Click Send Payment Notification → send in WangWang
- Auto mode (recommended): Enable in Settings → Auto-send payment notification when status =
ordered_unpaid
⑥ Confirm Shipment · Complete
- Enter the tracking number from the supplier
- Click Mark as Complete
- Order status →
shipped, moves to history
Time Comparison
| Step | Traditional | Shopman |
|---|---|---|
| Order sync | 30-60 min manual entry | 2-5 min |
| 3-file download | 45-90 min one by one | 5-10 min |
| WangWang order | 60-90 min typing | 10-15 min |
| 1688 order record | 60 min manual | Auto-captured |
| Payment confirmation | 20-30 min | About 5 min (optional automation) |
| Shipping close | 20-30 min | About 5 min |
| Total | 4-6 hours | 15-20 orders commonly from ~30 min |