3.26.05

Feature Enhancements

Custom Service Levels — Licensee-Specific Configuration

Overview

Grasshopper now supports custom service levels, allowing licensees to define their own service level offerings on top of the Grasshopper system baseline (White Glove, Room of Choice, Curbside, Parcel, etc.). This capability gives licensees the flexibility to tailor their service catalog to their specific business needs and client requirements — without impacting other licensees or the system baseline. Custom service levels are scoped per licensee and follow the same structure and conventions as system service levels. A licensee’s full service level list is the combination of the Grasshopper system baseline plus their own custom entries. System baseline service levels remain protected and cannot be modified or removed by anyone. Important: This capability is available to licensees only — it is not supported in the Virtual Carrier (VC) flow and is explicitly out of scope for Virtual Carrier environments. Custom service levels cannot be permanently deleted. Instead, a soft delete (deactivation) echanism is used — deactivated service levels are hidden from all forward-facing surfaces (order creation, selectors, filters, pricing) while their historical data and order references remain fully intact and resolvable. This preserves data integrity across existing orders, reports, and audit trails. Custom service level names and descriptions are also visible on the public order tracking page, ensuring consignees see the correct, licensee-defined service level information when tracking their order.

Key Enhancements

• Licensees can define custom service levels with a name, code, and description, following the same conventions as system service levels
• Custom service levels are selectable when creating orders via the UI, import, and API
• Custom service levels appear in the Orders grid service level column and filter
• Pricing sets and retailer default service level configuration support custom service levels
• Photo requirements in Advanced Settings can be configured per custom service level
• Real-time pricing, Pricing Calculator, and Get Quote API all support custom service levels
• Custom service level names and descriptions are displayed on the public order tracking page
• Deactivated custom service levels are hidden from all forward-facing surfaces but continue to resolve correctly on historical orders and records
• Virtual Carrier environments are not in scope for this feature — behavior in VC environments is unchanged
• Driver App displays the custom service level on the order details

Custom Service Levels — Licensee Admin Management Screen

Overview

A new Service Levels management screen is now available to Admins and Super Admins, allowing them to create and edit custom service levels for their licensee without involving the Grasshopper help desk.

Key Enhancements

• Admins and Super Admins can create custom service levels with name, code, anddescription
• Supervisors, Dispatchers, and Customer Service roles have view-only access
• Both system (read-only) and custom service levels are displayed in a single grid
• Columns include Name, Code, Type, Created At, Created By, Last Updated At, Last Updated By
• System baseline service levels are clearly marked as read-only and cannot be modified
• Custom service level codes are validated for uniqueness and cannot use the reserved GH_ prefix

Custom Service Levels — Warehouse App Service Level Display

Overview

The Warehouse Mobile App Order Details page now correctly resolves and displays custom service level names. Previously the app relied on a hardcoded client-side lookup that did not support custom service levels — resolution is now handled server-side.

Key Enhancements

• Service level name and VIP status are now resolved server-side and returned as separate fields
• Hardcoded service level lookup has been removed from the mobile client

Service Level Descriptions — Consolidated Across All Surfaces

Overview

Service level descriptions are now consistent across the Grasshopper app,Driver application, and the public order tracking page. Previously these descriptions diverged across surfaces. All 13 system service levels now display a single agreed-upon description everywhere.

Key Enhancements

Descriptions updated and aligned across Grasshopper app, and public tracking page for all system service levels including White Glove, Room of Choice, Threshold, Curbside, Parcel, Will Call, and others

Defects

Order Summary — Service Level Duplication on Pre-Inspection Toggle

Overview

Rapidly toggling the Pre-Inspection option on the Order Summary page caused duplicate entries to appear in the service level list. This has been fixed.

Key Fixes

Service level list no longer shows duplicate entries when the Pre-Inspection toggle is clicked multiple times in quick succession

Order Import — Empty Service Level Defaulting to White Glove

Overview

Importing orders with an empty service level column was incorrectly defaulting to White Glove instead of the licensee's configured default service level. This now behaves consistently with non-matching service level codes.

Key Fixes

Orders imported with an empty service level now correctly fall back to the retailer's default service level, consistent with the behavior for non-matching codes

Warehouse App — Custom Service Level Not Visible on Line Item Card

Overview

Custom service levels were not displaying on order line item cards in the Warehouse App's Freight tab. This has been resolved.

Key Fixes

Custom service level values now appear correctly on line item detail cards in the Warehouse App