Getting started
Quick start
This walkthrough takes a brand-new account to a working multichannel setup: organization, team, one marketplace connection, synced products and a processed order.
Before you begin
- A seller account on at least one supported marketplace (eBay, Amazon or Etsy) with permission to authorize third-party apps.
- Your company legal name, address and VAT/tax identifier for invoicing.
- Email addresses of colleagues you want to invite.
Note
New organizations start on a trial. All features are available during the trial; see Account status & limits for what changes when it ends.
Setup steps
- 1
Create your account and organization
Sign up, then complete the onboarding wizard: organization name, country, currency, company address and VAT identifier. These values feed invoice headers and VAT reporting, so enter them exactly as registered.
- 2
Invite your team
Open Settings → Team, invite members by email and assign a role. Warehouse staff usually need only the Operations role; accountants need Finance.
- 3
Connect a marketplace
Go to Connections, choose eBay, Amazon or Etsy and complete the OAuth consent screen. On return the connection shows connected and starts its first import.
- 4
Import and reconcile products
The initial import pulls existing listings into your catalog. Match duplicates across channels by SKU so a single product owns one master stock level.
- 5
Turn on inventory sync
Enable sync per connection and set a safety buffer if you also sell offline. CrowPrime then pushes stock changes to every linked listing.
- 6
Process one order end to end
Wait for (or place) a test order, mark it shipped with a tracking number, generate the invoice, and check that the dashboard turnover tile moved.
Verify the setup
| Check | Where | Expected |
|---|---|---|
| Connection health | Connections | Status connected, last sync within 15 minutes |
| Catalog | Products | No duplicate SKUs, stock matches the warehouse |
| Order import | Orders | Recent marketplace orders present with buyer and totals |
| Invoicing | Invoices | Sequential numbers, correct VAT rate, company details |
| Reporting | Reports | Turnover for today equals the sum of shipped orders |
Connection health
- Where
- Connections
- Expected
- Status connected, last sync within 15 minutes
Catalog
- Where
- Products
- Expected
- No duplicate SKUs, stock matches the warehouse
Order import
- Where
- Orders
- Expected
- Recent marketplace orders present with buyer and totals
Invoicing
- Where
- Invoices
- Expected
- Sequential numbers, correct VAT rate, company details
Reporting
- Where
- Reports
- Expected
- Turnover for today equals the sum of shipped orders
Troubleshooting
The first-run problems below cover most failed setups.
| Symptom | Cause | Fix |
|---|---|---|
| OAuth returns to CrowPrime with an error | The marketplace account lacks developer/app permissions | Authorize with the primary account owner, then retry |
| Products imported but stock is 0 | Listings use channel-managed quantities not yet mapped | Set the master stock on the product; the next sync pushes it out |
| Duplicate products | SKUs differ per channel | Merge products and add channel SKU aliases |
| No orders imported | Import window starts at connection time | Widen the backfill window in connection settings |
OAuth returns to CrowPrime with an error
- Cause
- The marketplace account lacks developer/app permissions
- Fix
- Authorize with the primary account owner, then retry
Products imported but stock is 0
- Cause
- Listings use channel-managed quantities not yet mapped
- Fix
- Set the master stock on the product; the next sync pushes it out
Duplicate products
- Cause
- SKUs differ per channel
- Fix
- Merge products and add channel SKU aliases
No orders imported
- Cause
- Import window starts at connection time
- Fix
- Widen the backfill window in connection settings
A healthy connection responds like this when you use the diagnostics action:
{
"channel": "ebay",
"status": "connected",
"scopes": ["sell.inventory", "sell.fulfillment", "sell.account"],
"token": "valid",
"last_sync": "2026-08-24T09:41:02Z",
"pending_pushes": 0
}