UNFI Product

Schema representing a product in the UNFI wholesale food distribution catalog.

Food DistributionWholesaleNatural FoodsSupply ChainFortune 500

Properties

Name Type Description
productId string UNFI product identifier
upc string Universal Product Code (12 digits)
gtin string Global Trade Item Number (GS1 GDSN 14 digits)
name string Product name
brand string Brand name
description string Product description
category string Primary product category (e.g., Snacks, Beverages, Frozen Foods)
subCategory string Product subcategory
certifications array Product certifications
unitSize string Unit size (e.g., 7 oz, 1 lb)
unitsPerCase integer Number of units per case
retailPrice number Suggested retail price in USD
status string Product availability status
View JSON Schema on GitHub

JSON Schema

unfi-supplier-product-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/united-natural-foods/main/json-schema/unfi-supplier-product-schema.json",
  "title": "UNFI Product",
  "description": "Schema representing a product in the UNFI wholesale food distribution catalog.",
  "type": "object",
  "properties": {
    "productId": {
      "type": "string",
      "description": "UNFI product identifier",
      "examples": ["UNFI-0012345"]
    },
    "upc": {
      "type": "string",
      "description": "Universal Product Code (12 digits)",
      "pattern": "^[0-9]{12}$"
    },
    "gtin": {
      "type": "string",
      "description": "Global Trade Item Number (GS1 GDSN 14 digits)",
      "pattern": "^[0-9]{14}$"
    },
    "name": {
      "type": "string",
      "description": "Product name"
    },
    "brand": {
      "type": "string",
      "description": "Brand name"
    },
    "description": {
      "type": "string",
      "description": "Product description"
    },
    "category": {
      "type": "string",
      "description": "Primary product category (e.g., Snacks, Beverages, Frozen Foods)"
    },
    "subCategory": {
      "type": "string",
      "description": "Product subcategory"
    },
    "certifications": {
      "type": "array",
      "description": "Product certifications",
      "items": {
        "type": "string",
        "enum": ["organic", "non-gmo", "kosher", "gluten-free", "vegan", "fair-trade"]
      },
      "uniqueItems": true
    },
    "unitSize": {
      "type": "string",
      "description": "Unit size (e.g., 7 oz, 1 lb)",
      "examples": ["7 oz"]
    },
    "unitsPerCase": {
      "type": "integer",
      "minimum": 1,
      "description": "Number of units per case"
    },
    "retailPrice": {
      "type": "number",
      "format": "double",
      "minimum": 0,
      "description": "Suggested retail price in USD"
    },
    "status": {
      "type": "string",
      "enum": ["active", "discontinued", "seasonal"],
      "description": "Product availability status"
    }
  },
  "required": ["upc", "name", "brand", "category", "status"]
}