Importer operations guide
Wine Product Data Management for Importer Operations Teams
A practical operating model for controlling wine product records, identifiers, market and vintage variations, assets, access, changes, and quality.
- Published
- Reading time
- 11 minutes
Manage wine data around the commercial item
This guide is for alcohol importer operations teams responsible for maintaining wine product details across portfolio files, sales materials, distributor requests, and internal systems. It covers record design, sources of truth, identifiers, vintage and market variations, change control, asset relationships, permissions, validation, and implementation.
Wine product data management is the work of keeping one dependable description of each sellable item while preserving the evidence, decisions, and history behind it. The goal is not to place every fact in one large spreadsheet. The goal is to let a colleague identify the exact wine, know which values are current for a market, find the approved assets, and correct a field without creating another unofficial copy.
Keep compliance decisions with qualified reviewers. A database can require evidence and record an approval, but it cannot decide whether a label, claim, designation, or sales document satisfies federal, state, distributor, or destination-market requirements.
Define the records before defining the fields
Start by deciding what each record represents. If a row sometimes means a wine, sometimes a vintage, and sometimes a distributor item, no naming convention will remove the ambiguity.
A practical model separates these records:
- Producer: The stable winery or estate identity, including approved producer copy, people, locations, and shared brand assets.
- Wine: The continuing cuvée or portfolio identity, including the controlled commercial name and product family relationships.
- Release: A vintage or a deliberately managed non-vintage release, including vintage-sensitive production, analysis, tasting, and accolade information.
- Market item: The sellable configuration for a destination market, including language, bottle volume, pack, importer SKU, barcode identifier where used, package, and availability.
- Asset: A file or published output linked to the records it describes, with its owner, status, revision, audience, and rights.
Do not create a separate copy of the producer whenever a vintage changes. Do not overwrite the prior vintage to create the next one. Do not treat two bottle sizes as the same market item merely because the liquid and vintage match.
Relationships carry shared information without hiding important differences. A producer story can serve several wines. A tasting note can belong to one release. A back-label image can belong to one market item. A logo can remain at producer or brand level and be linked to every applicable item.
Assign a source of truth by field
The phrase single source of truth is useful only after the team names the source for each type of information. One system rarely originates every product fact. A producer may own harvest and cellar details. The approved label record may govern label presentation. The importer’s item system may govern SKU, pack, and status. A distributor may assign its own item code.
Create a field authority table with these columns:
- field or field group
- authoritative source
- internal owner
- required evidence
- review role
- downstream outputs
- change trigger
For example, the producer’s signed technical information may be the source for fermentation details, while the operations item master is the source for the importer SKU. The distributor’s own confirmation should govern its item code. An approved PDF should be an output when its values come from controlled records, not the place where a colleague must recover the only known value.
Preserve provenance beside sensitive fields. Record the source document or message, source date, contributor, verification state, reviewer, and review date. Use states such as unverified, verified, approved for use, superseded, and not applicable. A blank field should not silently combine unknown, unavailable, awaiting confirmation, and irrelevant.
When sources disagree, mark the field unresolved. Do not select the value from the newest email or the best-looking sheet without checking which source has authority. Record the decision and its evidence so the next vintage does not reopen the same conflict from memory.
Use identifiers that survive names and handoffs
Names help people search, but names alone make weak identifiers. Spelling, accents, abbreviations, translations, and portfolio naming decisions can change. Give each producer, wine, release, market item, and asset an internal identifier that remains stable when display text changes.
Keep different identifier systems in separate fields:
- internal producer ID
- internal wine ID
- release ID
- importer SKU
- UPC or GTIN where used
- distributor item code
- state or control-market code where applicable
- supplier’s item reference
- asset ID and revision
Do not place several codes in one item number field. The same code can mean different things to a supplier, importer, warehouse, and distributor. Store the issuing organization, code type, value, applicable market, and status.
Treat a barcode identifier as one attribute of a market item, not as the identity of the complete product record. If a supplier changes packaging or provides a replacement code, preserve the prior value and its effective context. Do not repurpose an old internal ID for a different item.
Display names still need control. Define how producer, brand, cuvée, vintage, appellation, bottle volume, and market appear in full names and short names. Preserve accented characters in customer-facing content. Keep search aliases separately rather than changing the approved name to match every abbreviation people use.
Model vintage and market variation explicitly
A new vintage should create a successor release connected to the continuing wine. Start it from a template or inheritance process, but do not mark inherited release-sensitive values as confirmed.
Reopen fields that can change with the release:
- vintage or non-vintage treatment
- grape varieties and blend percentages
- vineyard and harvest details
- appellation and origin presentation
- fermentation and aging
- alcohol and other technical analysis
- production claims and certifications
- tasting notes and service guidance
- accolades and review quotations
- bottle, label, tech sheet, and sell sheet assets
Classify inherited values as confirmed unchanged, changed, awaiting evidence, or not applicable. This makes rollover a review process rather than a copy-and-replace exercise.
Market variation belongs on a separate layer. An importer statement, language, bottle size, pack, back label, barcode, distributor code, warehouse status, price file, and approved asset set can vary while the wine and release remain the same. Create one market item for each configuration the business actually sells or distributes.
Use effective status with context. Current should answer current for which wine, release, market, package, and audience. When two vintages remain in distribution, both can be active market items. Do not force the newer release to replace the prior one before inventory and distributor needs support that change.
TTB’s wine labeling guidance separates mandatory and optional label information and provides specific resources for imported wines on its official wine labeling page. Use the qualified compliance owner’s approved evidence for regulated identity and label statements rather than copying values from an old sales document.
Control changes as complete impact sets
A product correction rarely ends in one field. The same value may appear on a product page, tech sheet, sell sheet, portfolio book, distributor collection, bottle image metadata, and sales presentation.
Open a change record when a controlled value or current asset changes. Capture:
- affected records and markets
- requested change and reason
- source evidence
- owner and required reviewers
- affected outputs
- effective date or release condition
- replacement and retirement actions
- completed checks
Before approval, compare the proposed value with its governing source and identify every output that repeats it. After approval, update the controlled record first. Regenerate or revise affected outputs from that record. Publish the replacement and retire the predecessor as part of the same change.
Preserve history. An audit entry should show the prior value, new value, person, time, source, and approval. Avoid destructive edits that make it impossible to determine which information supported an earlier distributor file.
Use a defined correction route for urgent errors. Hiding an incorrect PDF from a portal may be necessary, but it is not the full correction. The source field, linked assets, cached collections, direct links, and recipient communication may also need action.
Connect assets to exact product records
Product data and product assets should be related without being confused. A PDF is an asset. Its alcohol value, product name, item code, and vintage are structured data represented inside that asset.
For each asset, record:
- asset type and stable asset ID
- linked producer, wine, release, and market item
- source and owner
- draft, approved, current, superseded, or archived status
- revision and approval record
- intended audience
- rights or usage restrictions where applicable
- filename and format
- predecessor and replacement relationships
A current bottle image should identify the exact package it depicts. A review quotation should link to the release it evaluates. A producer logo can link broadly. A market-specific sell sheet should not appear in another market’s default collection merely because both items share a wine record.
Use filenames that retain identity after download, such as producer-wine-vintage-market-asset-revision.ext. Do not use final, latest, or new as revision control. Currentness belongs in the managed status, while the filename helps recipients distinguish copies outside the system.
If product data changes, query the asset relationships to produce an impact list. This is more dependable than asking colleagues to remember every presentation and folder where the value may have been pasted.
Separate access, editing, approval, and publishing
Access should follow the work people perform. Separate permission to view, edit product facts, upload evidence, approve content, publish assets, retire assets, and administer users.
Operations may own market items and availability. Portfolio managers may contribute producer and wine copy. Marketing may own imagery and layouts. Compliance may review regulated identity and claims. Distributor users may need only the approved current collection for assigned markets.
One person can hold several roles in a small team, but the actions should remain distinct. An upload should not become distributor-visible simply because the uploader also has broad folder access.
Keep supplier correspondence, contracts, banking records, internal pricing decisions, unreleased labels, and personal information outside ordinary distributor access. Review inherited permissions, public links, market groups, and former user accounts when responsibilities or relationships change.
Validate data before validating documents
Quality assurance should test field values, relationships, workflow state, and rendered outputs. A polished PDF can still describe the wrong bottle size or prior vintage.
Use structural validation for rules the system can evaluate:
- required identifiers are present and unique within their defined scope
- controlled values use the approved vocabulary
- numeric fields use the expected units and ranges set by the team
- percentages that are intended to form a complete blend are reviewed together
- current assets have an approval record
- a market item links to one intended release and package configuration
- superseded assets do not appear in current distributor collections
Use human review where context and evidence matter. A qualified reviewer should compare regulated identity, origin, claims, label presentation, and market requirements with the approved sources. Portfolio and producer owners should review production details and brand language. Operations should compare SKU, volume, pack, status, and distributor codes with operational records.
Some trade materials may be wine advertising depending on their publisher, content, use, and distribution. The federal definition includes trade booklets, catalogs, promotional material, and sales pamphlets in 27 CFR 4.61. Covered advertising has mandatory-statement requirements in 27 CFR 4.62, and the rules address false, misleading, and label-inconsistent statements in 27 CFR 4.64. Route the actual material and market context to the qualified owner. Product software does not replace that review.
Before publication, compare the complete current set. The bottle image, product page, tech sheet, sell sheet, item identifiers, pack, and market should all describe the same commercial item. Search for the prior vintage and retired codes across filenames, text, PDF metadata, collections, and direct links.
Implement with one representative portfolio slice
Do not begin by importing every supplier folder. Choose one producer with enough variation to expose the model, such as two wines, overlapping vintages, more than one bottle size, and market-specific assets.
Use this implementation sequence:
- Inventory existing records, fields, codes, sources, and files.
- Define the producer, wine, release, market item, and asset boundaries.
- Assign field authorities, owners, statuses, and required evidence.
- Create stable internal identifiers and map external codes separately.
- Migrate only the pilot slice, preserving source files and prior revisions.
- Resolve conflicts instead of importing them as accepted facts.
- Test a vintage rollover, market variation, correction, asset replacement, and distributor request.
- Compare every published output with the controlled record and approved evidence.
- Document the correction path and train users to update the source record first.
- Expand only after the pilot’s record boundaries and workflows hold up.
Measure implementation by operational outcomes. A distributor colleague should be able to find the correct current asset. An operator should be able to trace an important value to its source. A reviewer should see what changed. The team should be able to create a successor vintage without erasing the prior record or carrying unverified facts forward.
Depletement’s pre-launch workspace for alcohol importer operations teams is being designed to organize current product details, sales assets, distributor asset access, technical sheets, sell sheets, and vintage updates. It is not presented as a substitute for the operating model or for qualified review. Whether the team uses a future workspace, an existing product system, or a carefully governed database, dependable wine product data comes from exact record boundaries, named field authorities, controlled changes, and evidence-backed review.