Data model — Product and ProductVariant

This article describes the actually persisted shape of a product: the source is the Mongoose schema (Lib/Services/Products/src/model/schema.ts), not the public TypeScript type from the @fenicia/core package.

Product — main fields

status — 3 real values, not 5

The Mongoose schema only accepts:

active | disabled | draft     (default: draft)

The public TS type declares 5 values: active | disabled | inactive | draft | out_of_stock. inactive and out_of_stock do not exist in the real enum — if your client tries to save a product with either of those two values, Mongoose rejects the save via enum validation.

condition — 12 real values, not 3

The public TS type declares only 3 values (the exact subset was not captured during this article's audit). The real Mongoose schema accepts 12: new, new-open-box, new-oem, refurbished, plus 4 variants grouped under the used-* prefix and 4 variants grouped under the collectible-* prefix (the exact suffixes of those 8 values were not captured during the audit — check the source schema if your integration depends on the literal value).

productType vs type — three definitions that don't match

There are three different places in the code that define "product type", and they don't match each other:

1. The library's PRODUCT_TYPES constant declares 3 values: simple | variable | bundle.
2. The public TS type Product.type declares 5 values: simple | variable | bundle | supply | material.
3. The real Mongoose schema has no type field at all. It only has productType, with a 6-value enum that mixes physical nature with composition structure:

physical | digital | service | bundle | supply | material

ProductVariant — main fields

Relevant sub-shapes

• Price (ProductPriceSchema): id, name (req), isWholesale: boolean (default false), content: Mixed (req), currency (req, ISO-3), target: 'customers' | 'client' | 'segment' (req); channels/client/segment become conditionally required depending on target.
• Cost (ProductCostSchema): id, name, type: 'money' | 'rate' (req), cost ≥ 0 (req), currency (req), reason: enum['tax','delivery-packaging','fees','material','inventory','custom'] (req).
• Media (ProductMediaSchema): id, src (regex ^https?://, req), name (req), type: 'image' | 'video' | 'audio' | 'document' (default image), size: Mixed, position ≥ 0 (req), alt: TranslatedField (req), bindings[].
• Category (ProductCategorySchema): id, name (req), channels[], mappings.claro / mappings.mercadoLibre.{mexico,argentina,colombia}, path (req), selectable: boolean (default true).
• SEO: metaTitle (max 60) / metaDescription (max 160) / slug (lowercase, regex /^[a-z0-9-]+$/).
• Metafields: namespace, key (req, indexed), type: enum[string,json,number_integer,number_decimal,date,date_time,url,boolean] (req, default string), value: Mixed (req).

Binding — inconsistent channel enum

ProductBindingSchema: channelId, handle (req), type: enum[mercadolibre,shopify,amazon,walmart,shein,woocommerce,t1,claroshop,linio,coppel] (req), status/desiredStatus: enum['active','inactive','pending','error','paused'], syncStatus: enum['synced','pending','error'], plus reservedStock (default 0), overrides[], customValues[], and channel-specific data (mercadoLibreData, sheinData, coppelData, t1Channels[]).

Bundle (bundleConfig)

Applies only when productType === 'bundle': inventoryMode: 'calculated' | 'reserved' (default calculated), components[] (minimum 1, req): productSku (req), variantMode: 'fixed' | 'selectable' | 'any' (default fixed), quantity ≥ 1 (req, default 1), required (default true).

Materials / Supplies / BOM / Modifiers

Sub-shapes outside the core Product/ProductVariant but part of the same document; their endpoints are in Materials and BOM.

• Supply (productType: 'supply'): supplyCategory: enum[packaging,shipping,office,cleaning,tools,labels,other] (default other), consumptionUnit (req, default pza), stockAlerts { minStock, reorderPoint, reorderQuantity (all ≥ 0, req), alertEmails[], alertEnabled (default true) }, typicalUsagePerOrder, shippingAssociation, preferredSupplierId.
• Material (productType: 'material'): baseUnit { code, name, precision ≤ 6 } (req), alternativeUnits[], costing (req, methods fifo | lifo | average | last_purchase), expiration { expires, shelfLifeDays, expirationPolicy }, suppliers[], stockAlerts (req), lotTrackingEnabled.
• BOM (billOfMaterials, applies to any product, not gated by productType): consumptionMode: 'on_sale' | 'on_production' | 'manual', yield { quantity, unit }, components[] (minimum 1, req; each one materialSku + quantity + unit, req, with substitutes[]), wastagePercent ≤ 100.
• Modifiers (food-delivery style modifier groups — Uber Eats/Rappi/DiDi): enabled (default false), groups[] with code, name (req), selectionRule, modifiers[] (minimum 1, req; each one code, name, priceAdjustment { type: fixed|percentage|replace, value, currency }, channelBindings[] with channelType: enum['uber-eats','rappi','didi-food','mercado-libre','shopify','other']), conditions { variantSkus[], availableHours { start, end } (regex HH:MM), availableDays[] }.

Next steps

• Catalog and search
• Manage products
• Materials and BOM
• Error catalog