Skip to main content

echoDemandStockExceptions

Products with positive recorded demand and current oversold or low-stock inventory.

Business Rules​

  • Uses the shared demand filters and defaults to the last 30 completed UTC days.
  • Examines all current active stock exceptions and returns up to 10 demand matches.
  • Ranks by recorded quantity, then SKU.
  • Matches active products by company and SKU.
  • Recorded demand includes imported and automatic history and may be incomplete.
  • Inventory quantities retain their product units. Demand is recorded units, not a forecast.
  • Observation time is when the evidence was checked, not when inventory was refreshed.
  • Uses company context, including requests with a brand header.

Error Scenarios​

  • Invalid limits, reversed periods, or incomplete end dates are rejected.
  • Missing Echo entitlement or either required permission denies access.

Permissions Required​

  • echo:read
  • list_inventory
echoDemandStockExceptions(
  filter: DemandFilterInput
  top: Int = 5
  unit: ProductUomEnum = EACH
): DemandStockExceptions!

Arguments​

echoDemandStockExceptions.filter ● DemandFilterInput input common​

Optional demand filters, combined with AND.

echoDemandStockExceptions.top ● Int scalar common​

Maximum matching products, between 1 and 10.

echoDemandStockExceptions.unit ● ProductUomEnum enum products​

Compare recorded demand only in this unit; defaults to EACH.

Type​

DemandStockExceptions object common​

Recorded demand alongside current inventory exceptions for matched products.