E109: List ledger entries

GET /api/finished-goods-inventory/ledger

Returns finished-goods ledger entries matching the supplied filters, newest first. Triggered from the Finished Goods Inventory Ledger page and the Finished Goods Inventory Transfers page (which filters by ref).

Authentication

Standard tenant route. Requires Authorization: Bearer <firebase-id-token> and X-Org-Id: <org-id>. Access: Member. Also reachable with an org-scoped PAT.

Request

No body. All filters are optional and combine with AND:

• ?skuId= / ?locationId= — exact match.
• ?eventType= — one of the ledger event types (e.g. TRANSFER, RECEIVE, ADJUST, DISPOSE).
• ?ref= — a SQL LIKE pattern; use % as the wildcard (e.g. TFR-FG-% for transfer rows). Without a wildcard it is an exact match.
• ?dateFrom= / ?dateTo= — inclusive bounds on event_date.

The list is unpaginated (the ledger is bounded per org in v1).

Response — 200 OK

{ "data": [ LedgerEntry ] }

Entries ordered by event_date then created_at, descending. See E110 for the full entry shape.

Errors

HTTP	code	Condition
422	validation_failed	eventType is not a recognized ledger event type.

Workflow

Calls W109 List ledger entries.