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.netQuantityDeclarationidentifies 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