Référence Medusa.js

Découvrez la référence officielle de Medusa.js pour l’entité ProductVariant.

Relations et colonnes ajoutées

  • bridge_metadata : Un objet JSON permettant de stocker des métadonnées spécifiques au bridge.
  • custom_product_variant_attributes : Une relation one-to-many vers l’entité CustomProductVariantAttribute.

Exemple de modèle JSON étendu

Voici un exemple de ce à quoi pourrait ressembler une instance de Product en JSON :

{
  "id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
  "title": "Small",
  "product_id": "prod_01G1G5V2MBA328390B5AXJ610F",
  "sku": "SHIRT-BLUE-SMALL",
  "barcode": "123456789",
  "ean": "9876543210",
  "upc": "1234567890123",
  "variant_rank": 1,
  "inventory_quantity": 100,
  "allow_backorder": false,
  "manage_inventory": true,
  "hs_code": "61091000",
  "origin_country": "US",
  "mid_code": null,
  "material": "100% cotton",
  "weight": 200,
  "length": 10,
  "height": 5,
  "width": 8,
  "created_at": "2023-07-15T12:00:00.000Z",
  "updated_at": "2023-07-15T14:30:00.000Z",
  "deleted_at": null,
  "metadata": {
    "bestseller": true
  },
  "bridge_metadata": {
    "import_date": "2023-07-10T09:00:00Z",
    "source_system": "legacy_erp",
    "external_id": "VAR-BLUE-S-001"
  },
  "custom_product_variant_attributes": [
    {
      "id": "cpva_01H1G5V27GYX4QXFXYD9G63301",
      "value": "Blue",
      "rank": 1,
      "product_variant_id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
      "custom_attribute_id": "cattr_01H1G5V27GYX4QXFXYD9G63300",
      "created_at": "2023-07-15T13:00:00.000Z",
      "updated_at": "2023-07-15T13:00:00.000Z",
      "bridge_metadata": {
        "import_date": "2023-07-10T09:00:00Z",
        "source_system": "legacy_catalog"
      },
      "custom_attribute": {
        "id": "cattr_01H1G5V27GYX4QXFXYD9G63300",
        "name": "Color",
        "is_facet": true,
        "external_id": "color_001"
      }
    },
    {
      "id": "cpva_01H1G5V27GYX4QXFXYD9G63302",
      "value": "Small",
      "rank": 2,
      "product_variant_id": "variant_01G1G5V2MRX2V3PVSR2WXYPFB6",
      "custom_attribute_id": "cattr_01H1G5V27GYX4QXFXYD9G63301",
      "created_at": "2023-07-15T13:05:00.000Z",
      "updated_at": "2023-07-15T13:05:00.000Z",
      "bridge_metadata": {
        "import_date": "2023-07-10T09:00:00Z",
        "source_system": "legacy_catalog"
      },
      "custom_attribute": {
        "id": "cattr_01H1G5V27GYX4QXFXYD9G63301",
        "name": "Size",
        "is_facet": true,
        "external_id": "size_001"
      }
    }
  ]
}