Discogs

ChannelWeave brings catalogue preparation into one organised workspace for record shops, full-time online sellers and growing collections. Import Stock from an unmodified Collection CSV, add or update explicitly confirmed current For Sale Listings from a Marketplace Inventory CSV, review catalogue facts and pricing, then prepare numbered Quicklister batches for manual upload. Paired Orders and Order Items exports can also be saved for evidence review and local Listing matching, without creating Sales orders. You can explicitly link an order to existing manual Sales, keeping those Sales separate and unchanged. An optional seller connection verifies your Discogs identity; it does not enable Marketplace synchronisation.

Follow the tools in order: import the Collection, review Stock, prepare or import current Listings, then import Orders for review. Order-item matching needs the corresponding local Listings to exist first.

Optional seller connection

Open Discogs connection to connect or reconnect your seller account. This needs Manage Connections permission. The connection is included with Discogs tools, with no extra Channel charge.

1. Select Connect Discogs, then Continue to Discogs. If authorisation is not configured, ask your ChannelWeave administrator to complete the application setup first.
2. Sign in and authorise ChannelWeave on Discogs. ChannelWeave never asks for your Discogs password. If you reload the connection page before continuing, start a fresh connection attempt.
3. Return in the same browser session within 15 minutes. A successful return verifies the seller identity and shows Connected — Seller identity verified. This is not a successful Marketplace sync.
4. Reconnect using the same seller account when needed. Switching sellers is not supported because local records must not become attached to another seller.

Disconnect Discogs removes the stored access credentials and pending attempt, but retains Stock, Listings, order evidence and the seller identity binding. To revoke the grant at Discogs too, use your Discogs application settings. One seller cannot be connected to different ChannelWeave accounts.

CSV import and Listing matching do not require this connection. Linking order evidence to existing Sales requires a verified seller binding; that binding can still be used after disconnect. Automatic inventory, order and stock synchronisation, direct publishing, fulfilment updates and Inbox messages are not enabled by authorising the seller.

Working with larger catalogues

• Import up to 50,000 records per CSV, within 50 MB, using either the Collection or current-listings workflow. Collection folder mappings direct new Stock to your chosen Locations and Bins; repeat imports identify new, changed and unchanged copies.
• Return to saved current-listings reviews and focus background catalogue enrichment on the facts that need attention. Pause and resume an enrichment run around the rest of your work.
• Prepare Quicklister batches of up to 500 records within a saved campaign. Re-download the exact exported file and record the upload outcome yourself after using Discogs.

The 50,000-record limit applies to each Collection or current-listings CSV, not to Orders exports or as a processing-time guarantee. Catalogue enrichment runs in the background; its planning estimate accounts for the available request allowance. You review, you price, you publish: Discogs remains a deliberate file workflow rather than a connected sales Channel with live stock synchronisation.

Current boundary

ChannelWeave can:

• optionally authorise a seller account and verify its identity, storing the access token and token secret encrypted
• import an unmodified, manually downloaded Discogs Collection CSV with automatic field mapping and copy-safe SKU generation
• search the Discogs catalogue for release candidates
• let you confirm the correct Release ID and, optionally, one returned manufacturer barcode
• review catalogue details in a larger batch when several Stock items need attention
• save reviewed catalogue values as Discogs-sourced Stock Reference facts
• use assisted pricing to open the exact Discogs Marketplace page for an identified release, narrowed by valid saved Media and Sleeve Conditions when available, so you can review the local Stock sale price yourself
• validate active, available Stock for Quicklister readiness
• apply explicitly entered local condition grades or sale prices to selected Stock in Stock catalogue review after acknowledgement
• after reviewing comparable listings, apply one explicitly entered sale price to 2–100 selected physical copies that share the exact Release ID and the same saved Media and Sleeve Conditions
• download a reviewed, add-only Quicklister CSV for manual upload in Discogs
• import a manually downloaded Marketplace Inventory CSV, match current For Sale rows to distinct physical Stock items, compare the imported and Stock condition grades, stage reviewed missing-grade fills with the Stock match, and apply them only when the current Listings import is explicitly confirmed
• save paired manually downloaded Orders and Order Items exports for review, with explicit local Listing matches and no Sales or Stock effects
• explicitly link all active items in one reviewed order to one or several existing manual Sales, without merging them or changing their amounts, statuses or reservations

ChannelWeave does not:

• retrieve or synchronise a Collection through the Discogs API
• retrieve a wantlist, Marketplace inventory, orders, sales history or pricing through the Discogs API
• read, scrape, import, cache or republish Marketplace listings or prices from the linked page
• import, cache or republish Discogs-hosted images
• create, edit, reprice, pause, remove, relist or synchronise a remote Discogs listing
• confirm whether Discogs matched, accepted or published an exported row

Why pricing suggestions and price history stay out

ChannelWeave opens the current comparable listings on Discogs instead of importing a suggested price, sales history or a price trend. The Discogs API Terms of Use, last updated 27 May 2025, classify Marketplace pricing suggestions, pricing, sales history and offer-related release images as Restricted Data. The terms also restrict commercial use of Restricted Data and limit how long API Content may be displayed or cached.

Rather than make a broad legal claim about every possible implementation, ChannelWeave keeps a narrower product boundary: it does not request those API surfaces. You open live comparisons at Discogs, make the pricing decision and enter the price yourself. This keeps the evidence current and the decision clearly yours.

Orders CSV review

Discogs tools → Import orders saves a matching pair of manually downloaded Orders and Order Items CSV exports for review. A Marketplace Transactions file is not required. This is not yet a Sales-order import: it never creates or updates Sales, payments, shipments, Stock reservations, Listing status or remote Discogs records.

1. Use Open Discogs Orders export and Open Discogs Order Items export to open the corresponding export pages in new tabs. Sign in to Discogs there if needed, then download both original UTF-8 exports covering the same orders. Each file may contain up to 1,000 data rows and be no larger than 2 MB. Discogs controls sign-in and export generation; ChannelWeave receives nothing until you select the downloaded files.
2. Acknowledge that the files are your account's records and include buyer/address details, then select Import for review. Validation is all-or-nothing.
3. Open an order to inspect its buyer, intact shipping address, shipping method, reported amounts, source status, item prices, fees and locations. Offer origin and original price are retained separately; the actual item price is not replaced by the current Listing price or the pre-offer price.
4. Find local Discogs Listings by Listing ID, SKU, title or Release ID. Check the physical copy and explicitly Save match for each non-removed item. Results are suggestions, never automatic matches. The export's item_id is preserved but is not assumed to identify a Listing. One Stock copy cannot match two items within the same order. Ended Listings remain searchable for historical review.
5. Use Delete review when the saved evidence is no longer needed. This removes the imported buyer/address evidence and its review matches, not Sales or Listings. Any separately confirmed Sales identity links remain. Otherwise reviews remain saved within the account.

The Orders total and shipping are shown separately without an inferred net/gross split. Active item prices are summed using exact decimal arithmetic; disagreement with the source total produces a review warning, not an invented adjustment. Removed items remain visible but cannot be matched. Source timestamps retain their original text because the export does not identify a time zone.

Payment Received is displayed as payment reported received; Payment Pending is not cleared payment. Shipped remains historical source evidence, not a new dispatch. Cancellation does not prove a refund, physical return, current Listing status or whether an item was subsequently relisted. Unknown statuses require manual review. No source status performs an operational action.

Identical reimports leave reviews and matches unchanged. Newer changed order evidence replaces that order's review and clears its matches for fresh review. Older or conflicting same-timestamp evidence rejects the entire pair without partial changes. Orders omitted from a later pair are retained. Concurrent review edits require a reload instead of overwriting another operator's work.

Tax definition pending: tax, taxed amount, tax jurisdiction and tax responsible party are retained as opaque source values. Blank is not zero; no account code, rate, taxable base, fee-tax split or legal treatment is inferred. TODO: obtain Discogs-confirmed column definitions or a consented, redacted representative export before implementing accounting promotion. The existing manual Order placed workflow remains separate; a saved match is not a new sale.

Access requires permission to read and edit Sales orders and manage Listings. Opening the Discogs tools hub also requires permission to manage Stock. Files are parsed on upload; only the allowlisted order/item evidence and filenames are stored, not the complete raw files or feedback columns. Responses are private/no-store and source values are not logged.

Link existing manual Sales

Use Link existing manual Sales on the order review when the sale has already been recorded in ChannelWeave. One Discogs order may cover several manual Sales; linking identifies that relationship but does not merge the Sales or create another order or reservation.

1. Have an administrator verify the seller through the optional connection if it has not been verified before. Previously verified identity remains usable after disconnect; linking does not need stored access credentials.
2. Save the correct local Listing match for every non-removed CSV item, then choose the corresponding existing Sales line for each item. Up to 20 candidates are shown per item. Suggestions are not selected automatically; only previously saved links are preselected.
3. Check the entire selection: every active CSV item and every line of every selected Sale must be covered, with no duplicate physical copy or line. Eligible Sales are manual Discogs Sales in this account, in the same currency, with no conflicting seller, order or Listing identity. Each line must record one entry unit whose current Stock unit conversion matches its saved quantity. Partial Sales, split quantities and conflicting existing links are refused.
4. Compare the source evidence with the existing Sales. Then explicitly confirm that the order and selected Sales belong to the named verified seller, and acknowledge that only identity links will be saved. The CSV itself does not prove seller ownership. Select Link existing Sales.

Linking supports up to 1,000 active items and leaves all Sales amounts, payments, statuses, external references, metadata and Stock reservations unchanged. It does not reconcile monetary differences, interpret tax, dispatch an order or contact Discogs.

Saved ownership survives Delete review and later reimports. Changed evidence or Listing matches require fresh review and Reconfirm unchanged Sales links; changes to linked Sales/Listing identities can also require attention. An identical confirmation changes nothing. Different saved bindings cannot be replaced or unlinked here: a separate correction workflow is not yet available. Linked Sales lines cannot be deleted while their durable identity link remains. The ordinary Sales details form cannot move a linked Sale to another Channel or give it a conflicting order reference. Creating or editing another Sale cannot claim the retained Discogs order reference either.

Automatic order import, automatic stock protection and full Marketplace synchronisation remain unimplemented.

Manual Collection CSV import

Collection import adds or updates physical-copy records in your Stock catalogue using a file that you deliberately download from Discogs. It does not require or create a Discogs seller connection.

1. Download your Collection CSV from Discogs without renaming or preparing its columns.
2. Open Control Centre → Discogs tools → Import collection.
3. Choose the default Location + Bin for newly created copies. If the file contains more than one CollectionFolder, optionally map individual folders to other tenant-owned Location + Bin destinations; any folder left unmapped uses the default.
4. Upload the CSV and validate it. ChannelWeave shows the mapped columns, every row issue, generated SKUs and create/update counts without changing your Stock catalogue.
5. Review the preview, then explicitly start the background import directly into your Stock catalogue.
6. When the import completes, optionally choose Draft missing descriptions with the AI assistant. The AI assistant uses the imported title and reviewed Reference facts to prepare channel-neutral copy in a separate review queue. Edit and explicitly accept a draft before it is saved to Stock.

If generated wording fails the factual checks, ChannelWeave can substitute an independently validated sentence plan for recognised music facts, including colour or heavyweight-vinyl details and releases supplied across multiple media. It never relaxes the checks or saves that fallback without your review.

After the first completed Collection import, the Import collection card on Discogs tools keeps a Review AI descriptions action available. It opens the latest completed Collection import even when its review queue is empty, so you can start the first batch without selecting the CSV again.

The dedicated profile maps one CSV row to one physical Stock item with opening quantity 1. It composes Artist — Title as the Stock name and merchant-facing product title used to prefill later Channel drafts. Collection Notes map to operator-only Internal notes. The export headers Collection Media Condition and Collection Sleeve Condition map to the canonical, unprefixed Reference fact names Media Condition and Sleeve Condition; “Collection” describes the Discogs export context, not the physical-copy property. release_id, Title, Artist, Label, Format, Released, and Catalog# remain separate Discogs Reference facts. Rating is deliberately ignored. CollectionFolder is used only for the optional import-destination mapping shown before validation; it is not retained as Stock catalogue data. A catalogue number is never guessed to be a manufacturer barcode.

The generated SKU uses the numeric Release ID padded to at least eight characters, a hyphen, and that copy's Date Added with punctuation removed. For example, Release ID 123456 added at 2026-09-01 12:34:56 becomes 00123456-20260901123456. This identity does not depend on a row's position or on other copies being present, so splitting a Collection export into several files cannot renumber the same physical copy. ChannelWeave remembers the same Release ID and Date Added pair separately, so a later import can update the item safely even if its generated SKU has since been edited. A duplicate pair is blocked for review rather than guessed.

Every Discogs workflow accepts one canonical Release ID shape: 1–12 digits, starting with 1–9. Longer, zero-prefixed or non-numeric values stop at validation rather than flowing into catalogue search, matching or export.

New copies receive quantity 1. Each new copy uses its mapped CollectionFolder destination when one was selected, otherwise it uses the default Location + Bin. A repeat import can refresh the mapped title, notes and Discogs Reference facts, but it does not change existing quantities or locations, reactivate inactive Stock, or delete items absent from the file. An existing generated SKU is adopted only when its saved Discogs Release ID agrees; a collision or conflicting identity blocks the row.

Collection imports accept up to 50,000 data rows in one UTF-8 CSV, within a 50 MB file limit. Validation reports Added, Changed, Unchanged and Absent from this file separately. ChannelWeave fingerprints the supported source values for each physical copy, so an identical repeat row becomes a true no-op instead of rewriting Stock or emitting a false edit. The first repeat import after fingerprint adoption records that baseline; later identical files can be recognised immediately. Absent is information only: it never deletes, deactivates or moves Stock.

After validation, the background import commits deterministic 250-row checkpoints and updates visible progress between them. Startup resumes waiting or interrupted jobs. After a terminal failure, validate and import the same file again: stable source identities and fingerprints prevent an already completed row from becoming a duplicate. Final job counts include earlier checkpoints rather than counting only the final attempt. This makes a large import recoverable without presenting it as one all-or-nothing database transaction.

The page shows destination guidance beside the Location and Bin selectors. A top-of-page warning appears only when the warehouse destinations cannot load or a usable Location + Bin is unavailable; there is no success alert duplicating the selectors during the normal import path.

This remains a deliberate file handoff, not a live Collection mirror: ChannelWeave does not retrieve later changes, store folders as operational state, or reconcile the file against a seller account. Upload another complete Collection export when you choose to bring in newer data.

See Import stock items CSV for the shared validation, Location and Bin, background-job, optional post-import AI assistant description review, and recovery behaviour.

Review stock catalogue

Open Control Centre → Discogs tools → Review stock catalogue to find active Stock with incomplete catalogue or sale-readiness details, manage pricing and batch-grade reviewed physical copies. The Discogs tools card calls out both purposes before offering the separate background-enrichment action. Seven cards show All Stock items, Needs attention, Missing Release ID, Missing barcode, Missing Media Condition, Missing Sleeve Condition, and Missing sale price. Choose All Stock items to revisit completed pricing and condition reviews, or another card to filter the one table beneath it. The five missing-value counts can overlap; Needs attention counts each affected Stock item once.

The result count reflects the active catalogue filter and search. On mobile it appears as a separate count beside the Back button, not as part of the button.

The table keeps the Discogs Release ID, manufacturer barcode, Media Condition, Sleeve Condition and sale price together. Empty data values read Not recorded; Missing remains the workbench-filter wording for values that need attention. A linked Data provided by Discogs attribution beside a saved Release ID opens that exact release.

Opening a linked Stock name keeps the current stock-catalogue list state. On the Stock item, Back to stock catalogue review returns to the same stock-catalogue filter, search and page. The Stock item's breadcrumb remains Inventory → Stock catalogue → the current item, which identifies the canonical location of the record rather than the page used to open it.

1. Choose Match on one row when its catalogue identity or provider facts need attention. ChannelWeave tries the strongest saved input first: Release ID, exact manufacturer barcode, exact catalogue number, then the Stock title alone as a bounded candidate search. An internal SKU is never sent as provider metadata. The action opens Match with Discogs in a large, scrollable modal without changing the table underneath. The result or a clear error appears in that modal. Choose Close to return focus to its Match button. Manual identification handles one Stock item at a time; use Queue enrichment run from the Discogs tools page for bounded background work covering many Stock items.
2. Inspect the returned title, year, country, label, catalogue number, format, genre, style and barcode evidence.
3. Choose Review identifiers for a plausible candidate.
4. Leave Keep unchanged selected unless one returned barcode is the correct manufacturer barcode for the physical product. Formatting-equivalent values, such as spaced and compact forms of the same code, appear as one choice while both raw provider rows remain visible as evidence.
5. Choose Confirm this release.

After confirmation, the modal closes and focus returns to the nearest remaining Stock row without taking you back to the top of the table.

Before saving, ChannelWeave checks the current Discogs release again. It saves the exact Release ID plus available artist, release title, catalogue number, format, label, release date and identifiers as Discogs Reference facts. Genre and style remain ordered, normalised, provider-sourced release classifications rather than being flattened into editable Reference facts. The Stock-item form shows a provider identifier by its concise type, such as Matrix / Runout, because the separate Source field already identifies it as Discogs. A different existing Release ID is never overwritten. Replacing a different manufacturer barcode requires separate explicit confirmation. Confirming with Keep unchanged still saves the additional Discogs Reference facts and marks the current Release ID as enriched. Genre/style coverage is recorded separately, so a release that legitimately returns no classifications is distinguishable from one that has not been checked. A release that legitimately returns no additional identifiers is also recorded as completed rather than remaining in the queue. If any allowlisted release fact or classification changed after you opened the review, confirmation stops and asks you to review the current evidence instead.

Search results are candidates, not automatic matches. Exact barcode and catalogue-number searches retain only results that repeat the requested value. Metadata searches never confirm themselves. A zero-result search changes nothing.

Catalogue candidates, release details, enrichment results, Quicklister rows and Discogs-supplied Reference facts display Data provided by Discogs beside the returned data. A manually assessed condition uses Discogs' grading vocabulary but is labelled Manual review · Discogs grades and does not receive provider attribution. Collection and current-inventory CSV grades retain their respective import provenance. Provider attribution links directly to the relevant Discogs release page and is separate from ChannelWeave's general non-affiliation notice.

Bulk update Stock

Use Bulk update Stock in Review stock catalogue to save an explicitly reviewed price or condition across selected physical copies.

The bulk-update section appears only when at least one Stock row is selected and disappears when the selection is cleared. Row selection remains available.

Before entering prices, check Listing Currency in your Discogs Seller Settings. In ChannelWeave, set Settings → Home → Home currency to the same currency. Home currency is a general default, separate from Inventory valuation currency; changing it does not convert saved amounts or update existing records.

1. Select up to 500 rows that already have one valid Discogs Release ID. Choose Show: 250 or Show: 500 for larger batches; the header checkbox selects only eligible rows on the current page. On smaller screens, use each card’s Select button.
2. Enter a Stock sale price in your Home currency, choose a Media Condition, a Sleeve Condition, or any combination. Every field starts as Leave unchanged; ChannelWeave never defaults a copy to Mint or chooses a price for you.
3. Confirm that you assessed every selected physical copy and that the entered values apply to all of them, then choose Save to Stock.

The entered price is saved to every selected Stock item. Independently reviewed items may have different releases or conditions: for example, you may deliberately set the same price for a group of records. This is different from reusing one assisted price for matching copies, which retains the stricter rules below.

ChannelWeave locks and revalidates the complete tenant-owned selection and applies the update atomically. Unchanged values are neither rewritten nor audited as edits. Each changed condition retains Discogs as its grading vocabulary and records manual review as its provenance. Blank fields leave existing values unchanged. Existing CSV batches are not changed; new exports use the saved Stock values.

Prepare listings has no price or condition editor. From there, Review these items opens this workbench with the same search, readiness issue, campaign exclusions, page and page size. Each row's Review link opens catalogue review focused on that exact Stock item. Back to prepare listings returns to the originating export view; readiness is reloaded from saved Stock. A completed item leaves an issue-filtered review, and an emptied last page falls back to the nearest remaining page. Review all Stock clears the focused review filter while keeping the return link.

Change selected prices

Select the Stock rows, then choose Change prices in Bulk update Stock. This acts on the complete selection (up to 500 rows on the current page), even when the records have different Release IDs or conditions. Every selected row must still be active and have one valid Release ID. Changing pages or filters clears the selection; there is no implicit whole-catalogue update.

Choose either:

• Enter exact price to give every selected row the same entered price, including rows without a current price.
• Set price by, combining any of:
  • Increase or decrease prices by a percentage or fixed amount.
  • Round prices up, down or to nearest, with a Price ending from 0 to
    1. For example, 99 produces .99 prices and 0 produces whole amounts.
  • Set a minimum price to raise prices below your floor and leave higher results alone.

Combined rules run in this order: adjust → round → minimum floor. The floor wins if it does not match the chosen ending. Nearest ties round up. Rounding never goes below the lowest positive price with the chosen ending: .99 for 99, or 1.00 for 0. Amounts use your Home currency, without conversion. Inputs allow up to four decimal places; calculations use exact decimal arithmetic and round once at Stock's four-decimal precision if needed. Percentage decreases cannot exceed 100%.

Choose Preview changes to see the rule summary and every selected item's before price, after price and result. No Stock is changed by previewing. An adjustment needs a positive current price; use Enter exact price first for unpriced rows. Non-positive results or prices beyond the supported range block the complete save rather than silently skipping rows.

Review the preview, tick the acknowledgement and choose Update Stock prices. Changing an option clears the preview and acknowledgement. If Stock or Home currency changes after preview, preview again before saving; the update is revalidated and applied atomically. Unchanged prices are not rewritten or counted as edits. Condition grades are not changed.

These are your pricing rules, not a Marketplace valuation or suggested price. Only local Stock changes: live Discogs listings and existing CSV batches remain untouched. New exports use the newly saved Stock prices.

Assisted pricing review

Review is available on any row with one valid Discogs Release ID, including rows whose barcode, condition or sale price is missing. It remains a manual, optional part of the same stock-catalogue workbench.

1. Choose Review on one Stock item. Its sale price and Media/Sleeve Conditions appear in the Review price and condition modal while the table remains in place underneath. Confirmed Discogs genres and styles appear there as read-only release context; they do not determine the physical copy's condition or price. The sale-price field presents its value to two decimal places. Enter any missing values you are ready to save; you do not have to complete all three at once.
2. Optionally choose Ships from and Currency, then choose Open comparable listings. ChannelWeave opens the public Marketplace page for that exact release in a new browser tab. Each Open comparable listings action opens a new tab; ChannelWeave does not retain or control the Discogs browsing context. Ships from filters by the seller's country, while Currency filters by the seller's listing currency; it is not a display-currency conversion. A valid Media Condition adds Discogs' condition filter and a valid Sleeve Condition adds its sleeve_condition filter. Choose Any country or Any currency to omit that filter. ChannelWeave saves these two choices for the signed-in user and restores them on the next review; both begin as Any until that user chooses otherwise. Each choice is saved as soon as it is changed; it does not depend on Save details.
3. Compare the listings manually, return to ChannelWeave and choose Save details. The sale price is saved on Stock; the conditions are saved as canonical Discogs condition Reference facts for that same Stock item. The modal closes and returns you to the same Stock row, or the nearest remaining row when the saved item no longer matches the current filter. Save details saves only the Stock sale price and Media/Sleeve Conditions; the two comparable-listing filter preferences have already been saved when they were changed.
4. To reuse the price for genuinely matching copies, select at least one other copy in the table before opening Review. When this copy and every selected copy have the same Release ID and the same saved Media and Sleeve Conditions, the modal offers Apply price to selected copies. Confirm that you reviewed the entered price for every selected physical copy, then apply it to 2–100 copies. This action changes only their Stock sale price; save any condition change for the reviewed copy separately.

Both Save details and Apply price to selected copies save to Stock, not to an export-only price field. Creating a new Quicklister CSV batch is a separate step that uses the saved Stock prices. Existing export batches keep the prices captured when they were created; Download again returns the original file, even after a Stock price change. Neither save action reprices live Discogs listings.

Assisted pricing is a navigation aid, not an automated valuation. ChannelWeave constructs the outbound URL entirely from its saved Stock facts. It does not request, parse, retain or calculate from the Discogs Marketplace page, and it does not mark a price as provider-approved. The batch price action locks and revalidates the complete tenant-owned selection before writing. A changed, missing or mixed Release ID, Media Condition or Sleeve Condition rejects the whole action. Prices are entered in the customer's Home currency, and each changed price records a manual edit event.

Stock catalogue enrichment runs

Open Queue enrichment run when many existing Stock items need catalogue facts, a Discogs Release ID or a manufacturer barcode.

1. Choose the work needed: the complete preparation set, missing Release IDs, missing manufacturer barcodes, or missing/outdated catalogue enrichment. Optionally narrow that scope by SKU, title, barcode or product ID, then choose Queue enrichment run.
2. ChannelWeave takes one deduplicated snapshot of matching active Stock within that scope. The complete preparation set includes Stock whose Release ID is missing, whose manufacturer barcode is missing, or whose saved Release ID has not had its current complete catalogue facts and genre/style coverage confirmed. It does not treat a confirmed empty genre, style or optional Discogs identifier response as incomplete enrichment. Only one queued, running or paused run can be active for your account at a time.
3. The worker processes that snapshot automatically and classifies each result as Ready to apply, Needs manual match, Needs barcode review, Changed since queued, or Unable to retrieve. Starting the run is deliberate; it is not a scheduled catalogue sync.
4. Open Ready to apply results to inspect the returned barcode, artist, release date, country, label, catalogue number, format, genre, style, matrix/runout, rights-society, label-code, price-code and other identifier evidence.
5. Use Match manually when no exact release can be selected safely. Use Review barcode when a release has distinct barcode choices or its provider barcode conflicts with the current manufacturer barcode. Existing barcodes are never replaced automatically.
6. Select up to 10 ready rows, acknowledge the release, Reference facts and optional sole barcode, then choose Apply selected catalogue facts. The acknowledgement and apply controls appear only while rows are selected.

Before saving, ChannelWeave checks every proposed release again. Changed Stock, ambiguous matches, barcode decisions and provider failures remain visible instead of being silently accepted. Those rows can be opened in the individual identification workbench. Products sharing a Release ID reuse the first allowlisted evidence captured in that run; every confirmation still refetches the release before writing Stock.

The run shows remaining Stock items and a planning estimate derived from the tenant background allowance. At the current 30-request-per-minute tenant limit, 50,000 items take about 27 hours 47 minutes when each needs one request, or about 55 hours 34 minutes when each needs two. Reused Release-ID evidence can reduce actual provider work; provider delays, other work and human review can extend elapsed time. You can pause a queued or running run, resume it later, or cancel it with explicit acknowledgement. Terminal run evidence is retained for 90 days, then removed by maintenance; confirmed Stock facts and durable events remain.

Confirmation is bound to the allowlisted facts shown in review. Reordering the same provider values does not create a false conflict, but a changed value, added fact or removed fact does. That row moves to Changed since queued for a fresh individual review rather than saving unseen evidence.

The web app and background worker share one Discogs request budget, with a second per-customer limit so one tenant cannot consume the shared allowance.

Ask ChannelWeave about Discogs classifications

After confirmed catalogue enrichment, the AI assistant can use exact Discogs genre and style classifications in your account's Stock and sales answers. For example:

• How many Stock items have Discogs genre "Jazz"?
• How is Discogs style "Ambient" performing this month?

Stock answers report Stock-item, on-hand and available quantities. Sales answers keep revenue separated by transaction currency. Gross margin before Channel fees is shown only when every included sales line has recorded COGS and the sales currency matches the account's Inventory valuation currency.

AI assistant also reports classification coverage: active Stock with one confirmed Discogs Release ID, how many of those releases have had genre/style enrichment, and how many remain unclassified. Because a release can have multiple genres and styles, totals across classification rows are not necessarily additive. Background enrichment stops at 45 shared or 30 customer requests per rolling minute; interactive catalogue work stops at 55 shared or 40 customer requests. These are ceilings, not guaranteed allowances: provider headers can lower the shared budget or require a longer cooldown. Rate-limit delays, including those longer than five minutes, are preserved. OAuth identity requests share the same budget. Rate-limited work is deferred, and retryable provider/network failures receive up to three bounded attempts instead of becoming terminal after the first failure. Worker waits can also stop promptly during shutdown.

Quicklister CSV export

Open Prepare listings after the relevant Stock items have a confirmed Discogs Release ID.

A row is ready only when it is active, has available quantity exactly 1, has one exact Release ID, has artist and release-title Reference facts, has a strong identifier, has a positive Stock sale price and has a valid Discogs Media Condition. An optional Sleeve Condition must also use Discogs' grading vocabulary. A Stock row containing several physical copies remains in Needs review until each copy is represented by its own quantity-one Stock item.

The workbench summarises Stock items, Ready to export, Needs review, Missing Media Condition and Missing sale price in responsive cards. The two missing-field counts can overlap because one Stock item may be missing both Media Condition and sale price.

Condition values use compact table text. Sale prices omit insignificant trailing storage zeroes on screen while retaining the reviewed value used by the export. Available quantities use the same compact display, so a whole copy appears as 1 rather than 1.0000; genuine fractional quantities remain visible. The Stock name links to the local Stock item; Data provided by Discogs is the row's single link to its Discogs release. The Identifiers column labels the release number Discogs release ID.

1. Start or resume a Quicklister campaign. The campaign fixes the Accept offers choice for every numbered batch and prevents the same Stock item being exported twice within that campaign.
2. Review Ready to export and Needs review.
3. If Stock needs a price, condition or catalogue correction, choose Review these items to open Stock catalogue review with the same export filters, or choose a row's Review link. Save the changes there, then use Back to prepare listings to continue the same campaign.
4. Recheck readiness. Prepare listings reads saved Stock and does not edit it. Only ready rows can be selected for export.
5. Select up to 500 ready rows and choose Download next CSV batch. The new file uses the current saved Stock prices; existing batches stay unchanged. The export-action row appears only while rows are selected; Review these items and its guidance remain available without a selection.
6. Upload the file yourself through Discogs Quicklister and choose when to publish it. Record the batch as Uploaded or Rejected, with an optional rejection note.
7. Continue with numbered batches, then complete or cancel the campaign.

Discogs Quicklister matches the CSV to its catalogue and uses the currency in your Discogs seller settings. ChannelWeave does not upload or publish the file.

Before exporting, set Settings → Home → Home currency in ChannelWeave to match Listing Currency in your Discogs Seller Settings. Home currency supplies the general pricing default, including the currency shown beside Discogs Stock price inputs; it is separate from Inventory valuation currency. Prepare listings displays Home currency as a reminder. ChannelWeave does not retrieve or change your Discogs setting. The CSV contains numeric prices, not a currency column. Changing Home currency does not convert saved prices or rewrite existing CSV batches. Review the amounts yourself before exporting in a different selling currency.

The CSV header is:

artist,title,label,catno,format,year,barcode,media_condition,sleeve_condition,price,comments,external_id,accept_offer

Price comes from the ChannelWeave Stock sale price. Comments use the Stock default listing description, falling back to the imported Collection Notes Reference fact, and otherwise remain blank. external_id contains a ChannelWeave SKU and Discogs Release ID reference. The file is UTF-8. ChannelWeave stores each exact generated CSV with its ordered Stock selection, row count and SHA-256 checksum. A prior batch can be downloaded again without rebuilding it from changed Stock. Uploaded and Rejected are manual operator outcomes, not a Discogs response or acceptance receipt. ChannelWeave does not upload the file, create a ChannelWeave listing or mark Stock as listed. The server applies search, readiness filters and page bounds before returning rows, so changing a filter does not load the customer's complete Stock catalogue into the web process.

Condition Reference facts and sale price belong directly to each selected Stock item. A bulk update changes only the explicitly selected rows.

Current listings CSV import

Use Import current listings when you already have live listings in Discogs and want to add or update confirmed current For Sale Listings in ChannelWeave after importing the physical Collection.

1. In Discogs, manually download a fresh Marketplace Inventory CSV.
2. Open Control Centre → Discogs tools → Import current listings.
3. In Step 1, drag and drop the file or choose it from your device, then explicitly select the seller currency and choose Review matches. The Discogs CSV contains numeric prices but does not identify their currency.
4. In Step 2, review the staged rows. The newest staged, queued, running or failed review resumes automatically if you leave and return. Use Discard staged review when you deliberately want to start again; discarding changes neither Stock nor Listings.
5. Only exact For Sale rows are eligible to add or update a local Listing. They appear before historical Sold rows by default, while the original CSV row order is preserved within each group. Sold rows are counted and shown as excluded evidence; they never create, update, end or remove Stock, Listings, Sales, quantities, or movements.
6. Review each proposed Stock match. The listing column keeps the imported grades, candidate Stock link and any review guidance together; the final Status / action column offers Match Stock only when that action is available. Historical Sold rows carry a neutral Sold status and no action. In the Stock picker, the fixed modal header keeps the imported grades visible while each candidate row shows only its Stock grades. Warning-coloured Stock grades and the specific Missing grades or Grades differ badge identify condition review; separate explanatory text remains only when a candidate cannot be matched or its grades cannot be applied safely. When a candidate is missing one or both grades and its product belongs to only that Stock item, Apply missing grades on confirmation appears before Match in the same left-aligned action group. Leave it selected to stage only the blank condition facts, or clear it to match without changing them. The staged grades are written only when you choose Confirm current listings, in the same transaction that adds or updates the Listings. Discard staged review therefore leaves both Stock and Listings unchanged. An existing grade is never overwritten. If several Stock copies differ, apply grades separately after reviewing each physical Stock item. Conflicts must be corrected at their source rather than overridden.
7. Confirm only when every current row has one valid Stock match. Confirmation queues durable background promotion, so you can leave the page while it completes. Reloading shows whether the job is queued, running, committed or failed. A failure leaves the complete import unapplied rather than exposing a partial set of Listings.

Current-listings import accepts up to 50,000 data rows in one UTF-8 CSV, within a 50 MB file limit. Validated staging rows are inserted in 1,000-row database chunks. The review table is filtered, sorted and paged in PostgreSQL and returns 10–100 rows at a time, so the browser does not load the complete import merely to search or change pages.

Automatic matching is identifier-led and deliberately narrow:

1. an existing ChannelWeave Discogs Listing with the same Discogs Listing ID, provided its linked Stock remains active, available, and has the exact Release ID
2. the exact Quicklister reference CW:<sku>;D:<release_id>, provided both values agree with eligible Stock
3. exactly one active, available, unclaimed Stock item with the exact Discogs Release ID

Titles, artists and even a shared Release ID never establish physical-copy identity. Every current listing must resolve to one distinct, available Stock item representing that physical copy. Manual matching also requires the exact Release ID, quantity 1, available tenant Stock, and no existing Discogs Listing or other staged claim. A Release-ID conflict cannot be overridden in the picker; correct the catalogue identity first. If the physical copy does not exist in Stock, use Create a Stock item and confirm its Discogs Release ID, or import the physical copy through Import collection, before returning to the staged row.

The background worker locks and revalidates the complete job, fills only the reviewed missing condition facts, and adds or updates every confirmed current For Sale Listing in one transaction. It stores the Discogs Listing ID as the stable remote identity and preserves the explicit seller currency. The staging, manual-match, queue, start, commit, failure and discard transitions are written to the tenant event log; each promoted Listing also receives a link event. An audit-write failure rolls back the same business transaction.

It does not change Stock quantity, fabricate a Discogs order or sale, or operate the remote listing. A newer file can add or update another explicitly confirmed For Sale row, but omission from that file or a Sold row never ends, removes or otherwise changes an existing local Listing. There is no API retrieval, deletion inference or automatic synchronisation. Terminal imported review jobs and their normalised source rows are retained for 90 days for diagnosis, then removed by application maintenance; durable events and promoted Listings remain.

After import, a live Discogs Listing detail offers three explicit local actions. Order placed creates a ChannelWeave Sales order, reserves the linked Stock item and ends the local Discogs Listing. That reservation fans the new availability out to every other linked Channel: Website changes locally; Amazon, eBay, Shopify and WooCommerce continue through their inventory workers. If availability reaches zero, the eBay worker explicitly ends the Listing and records success before marking it ended locally. Mark ended ends the local Discogs Listing without claiming an order or changing Stock. Restore as live reverses an accidental local end after you confirm the Listing is live on Discogs, but it is blocked while a linked Discogs Sales order remains active. None of these actions operates the remote Discogs Listing.

After confirmation, the Discogs Control Centre card shows ChannelWeave's count of canonical live Discogs Listings and the latest completed import time. The count links to the filtered Discogs Listings view. These values describe the reviewed state stored in ChannelWeave; they are not a live Discogs Marketplace total or sync timestamp.

Product images

Discogs catalogue reads do not request or store Discogs-hosted images. Use your own product photography in your ChannelWeave Media Library when an image is needed for Stock or another Channel. Name photographs with the exact SKU, such as CW-0001.jpg, or an explicit suffix such as CW-0001-front.jpg. ChannelWeave checks new and renamed files in the background, links one unambiguous active Stock match and leaves no-match, ambiguous and failed files in a visible exception count for correction and retry. It never guesses between multiple SKU candidates.

Attribution

This application uses Discogs’ API but is not affiliated with, sponsored or endorsed by Discogs. ‘Discogs’ is a trademark of Zink Media, LLC. Data provided by Discogs.

If a catalogue search fails

• Retry after the displayed delay when the provider rate limit is reached. The shared cooldown honours longer provider-requested waits.
• Check that the Release ID, barcode, catalogue number or product details you searched for are correct.
• Keep a failed catalogue-enrichment run for review; do not start a replacement while the original run is still active.
• If processing does not resume, note the time, visible error and run reference, then send them to ChannelWeave support.