schema.nfh.global

GroceryResource

Canonical term page (persistent IRI). Versioned resource URLs are listed below for easy copy/paste.

Canonical IRI

https://schema.nfh.global/GroceryResource

Developer URLs

GroceryResource Schema

Container: Resource.resourceAttributes Protocol Version: 2.0 Semantic Model: generalised Use Cases: Packaged foods, fresh produce, grocery items Tag: grocery resource

Overview

Grocery-specific resource attributes for packaged food items and fresh produce on Beckn v2.1. Extends RetailResource via allOf to add domain-specific properties for nutrition and fresh produce handling.

Migrated from GroceryItem (v2) — the container changes from itemAttributes to resourceAttributes to align with the v2.1 generalised Resource model.

Attachment Points

  • Resource.resourceAttributes — primary attachment. All grocery resources carry these attributes.

Design Rationale

  • Nutrition as an array: Multiple nutrition facts (energy, protein, carbs, fat, fiber, sodium)

are modeled as an array of {nutrient, value} objects to support flexible, per-100g or per-serving declarations.

  • Fresh produce flag: freshProduce.netQuantityDeclaration identifies non-standard packaging items

(bulk, harvested) that rely on weight/count declarations rather than pre-packaged quantities.

  • Extends RetailCore: Inherits identity, physical, food classification, packaged goods declaration,

regulatory disclosures, and credentials from RetailResource.

Non-Goals

  • Pricing (belongs in offerAttributes)
  • Availability and stock (belongs in performanceAttributes)
  • Promotional bundles (belong in offerAttributes)

Examples

Related Schemas

  • RetailResource — base retail resource schema (identity, physical, food)
  • FoodAndBeverageResource — prepared foods and beverages (cuisine, allergens, preparation)
  • HomeAndKitchenResource — non-food home and kitchen products