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