Skip to main content

echoInventoryChanges

Lists every recorded change to inventory for the current company, newest first by default, one row per change with the levels it left behind. Use it to follow how stock moved, rather than where it stands: for one SKU's history use echoInventoryItemChanges, and for the daily position use echoInventoryRecords.

Business Rules​

  • Each row carries the warehouse and location totals the change left behind, so a row is a position and not a movement.
  • By default, changes are listed newest first. Changes that share a moment are listed in reverse write order, so the first row of a shared moment is the state that moment ended at.
  • The history covers changes made through inventory operations, and the corrections the nightly repair sweep makes when a level has drifted. Each row says which of the two it was.
  • Bulk recalculations, which an operator can ask for, write to the level tables directly and do not appear here.

Error Scenarios​

  • No change matches the filter: an empty list.

Permissions Required​

  • echo:read
echoInventoryChanges(
  after: String
  before: String
  filter: InventoryChangeFilterInput
  first: Int
  last: Int
  sortField: InventoryChangeSortFieldEnum = CAPTURED_AT
  sortType: SortTypeEnum = DESC
): InventoryChangeRecordConnection!

Arguments​

echoInventoryChanges.after ● String scalar common​

Returns the elements in the list that come after the specified cursor.

echoInventoryChanges.before ● String scalar common​

Returns the elements in the list that come before the specified cursor.

echoInventoryChanges.filter ● InventoryChangeFilterInput input common​

Optional filters, all combined with AND.

echoInventoryChanges.first ● Int scalar common​

Returns the first _n_ elements from the list.

echoInventoryChanges.last ● Int scalar common​

Returns the last _n_ elements from the list.

echoInventoryChanges.sortField ● InventoryChangeSortFieldEnum enum common​

Field used to sort records. Defaults to date.

echoInventoryChanges.sortType ● SortTypeEnum enum common​

Sort direction. Defaults to descending.

Type​

InventoryChangeRecordConnection object common​

The connection type for InventoryChangeRecord.