Connecting your Discogs account lets you manage your Discogs Marketplace from the Backoffice. Once your account is connected, you can:
Automatically fetch release information from the Discogs database.
Import the listings already live on Discogs into your Common Ground inventory.
List, edit, or unlist your items on Discogs from the Backoffice.
Import your Discogs orders into Common Ground and process them alongside your Eshop and in-store sales.
Your stock stays in sync across both platforms, as long as you follow the Discogs sync guidelines below. These guidelines are mandatory rules, not recommendations: the sync only works reliably when every shop account follows them.
Discogs sync guidelines
Once your account is connected, the Backoffice becomes the only place where you manage your Discogs listings. The following rules apply to every synced account. Not following them causes stock discrepancies and order import errors.
Do
Create every new item in your Common Ground inventory first, then select List to Discogs from the Backoffice (see List / Unlist items to Discogs).
Edit and unlist your Discogs listings from the Backoffice only.
Remove the Discogs listings you don't want to keep before importing your Discogs inventory.
Turn off auto-cancellation in your Discogs settings.
Manage listings created outside Common Ground from Discogs inventory.
Edit your stock quantities of your listings into Common Ground
Don't
Don't create listings directly on Discogs.
Don't edit or delete synced listings on Discogs.
Don't merge orders on Discogs: merged orders aren't imported.
Don't rely on Discogs to relist items from auto-cancelled orders: they stay off sale until you relist them yourself.
Don’t edit your stock quantities directly on Discogs. The sync doesn't catch this data.
Warning: Common Ground doesn't pick up changes made directly on Discogs. Any such change means your stock no longer matches across both platforms.
Connect your Discogs account with Common Ground
To connect your Discogs account with Common Ground and sync release data, listings and sales:
Go to Preferences > External Services and select Connect my Discogs Account.
Follow the prompts and authorize Common Ground to access your Discogs account.
Common Ground → Discogs API
Discogs allows Common Ground to send only one request per second to its API. Because of this limit, the sync follows these rules:
New orders on your Discogs profile are scanned every 30 minutes.
Only the last 20 orders on your Discogs profile are scanned.
Orders older than the last 20 are updated only when you open the order page in Common Ground.
Messages that aren't attached to an order can't be imported.
Orders merged on Discogs aren't imported.
Items sold out from your Backoffice are automatically hidden on Discogs Marketplace.
Items from auto-cancelled orders (non-paying customer) aren't relisted automatically: you must relist them manually.
Discogs → Common Ground
Discogs doesn't allow Common Ground to sync stock quantities automatically once your inventory is synced. A quantity changed on Discogs isn't picked up by your Backoffice.
To sync quantities from Discogs:
Export your inventory from Discogs as a CSV file.
Import that file into Common Ground to update your stock quantities. See Import and manage inventory items using CSV.
Note: This is the only way to bring Discogs quantities into Common Ground after the initial sync. To avoid it, manage your quantities from the Backoffice, as required by the Discogs sync guidelines.
Import your existing Discogs inventory
If you already have listings on Discogs, import them into your inventory before you start selling from Common Ground.
Warning: Listings can't be unlisted or deleted in bulk from this page. Remove the Discogs listings you don't want to keep before you import your inventory.
Review your Discogs listings.
Select the action you need:
Import All imports and syncs all your Discogs listings.
Import to inventory imports a single listing.
Unlist from Discogs removes a single listing from Discogs Marketplace.
Fix stock discrepancies
A stock discrepancy happens when the same listing exists on Discogs and in Common Ground, but the two aren't matched. Discrepancies are rare when the Discogs sync guidelines are followed.
Warning: Orders containing unsynced listings can't be imported and trigger a Discogs Import Error: "The Discogs order [order number] could not be imported. The release: [release] has insufficient stock quantity or a corresponding listing was not found." Update the stock or fix the sync, and the order is then imported automatically.
Use Discrepancy Reports
Go to Inventory > My Discogs Inventory > Discrepancy Reports.
Review the flagged listings and resolve them. See Discogs discrepancy reports.
Check the Discogs release ID
You can also check that a listing is synced by comparing its release ID on both platforms:
On Discogs, open the release page and note its release ID.
In the Backoffice, open the same release and compare the Discogs release ID shown on the release page.
If the IDs don't match, the listing isn't synced. Use Discrepancy Reports to fix it.
Discogs release ID number