schema-aggregator

RetailPerformance Schema Pack v2.1

Overview

RetailPerformance is a Beckn v2.1 schema pack that declares performance execution and delivery capability parameters for retail fulfillment. This schema was migrated from v2’s RetailCoreFulfillmentAttributes with significant renaming and structural enhancements to better reflect the semantic intent of performance modes rather than fulfillment types.

The schema enables providers to declare:

• Performance modes (DELIVERY, PICKUP, SERVICE) they can execute
• Delivery specifications (address, contact, operating hours, closures)
• Service-level agreements with defined minimum/maximum durations
• Handling capabilities for specialized items (fragile, cold chain, hazardous, etc.)
• Installation scheduling for home and kitchen items (new in v2.1)

Attachment Points

This schema attaches to the following Beckn v2.0 core entities via the performanceAttributes container:

• Catalog/Provider: Declares global fulfillment capabilities
• Item: Item-level fulfillment constraints and special handling
• Fulfillment: Specific fulfillment execution details
• Commitment: Per-commitment performance specifications

Non-Goals

This schema does not:

• Specify actual fulfillment state or progress (use Fulfillment for that)
• Define item-by-item handling constraints (constraints are in Item schema)
• Encode pricing or surcharge models for special handling
• Model customer communication preferences (see ContractAttributes)
• Define post-delivery or last-mile specific behaviors (see Fulfillment schema)

Upstream Candidates

Future enhancement opportunities for v2.2+:

1. Surcharge Model: Optional array of handling surcharges (e.g., FRAGILE_SURCHARGE: {charge_percent: 5, min_charge: 500})
2. Availability Windows: availabilityWindows for time-slot booking with slot capacity
3. Temperature Ranges: temperatureRanges for precision control (min/max Celsius)
4. Weight Limits: weightLimits: {minKg, maxKg} for handling constraints
5. Geographic Restrictions: serviceableAreas referencing geo-fenced zones
6. Fulfillment Levels: Tiered service levels (standard, express, premium) with associated SLAs
7. Partner Integrations: partnerNetworks for third-party logistics providers
8. Eco-Credentials: ecoFeatures for sustainable delivery (carbon-neutral, package reuse, etc.)