ADM-TRANSACTION-551 - List transaction events with search, filters and sorting

GET https://example.com/v1/transactions/events

Returns the chronological list of events attached to a transaction.

User scoping

• OPERATOR and SUPPLIER clients only for this route.
  
  

Visibility

• OPERATOR can access events for any transaction across all suppliers.
  
• SUPPLIER can access events only for transactions linked to the authenticated supplier.
  
• If the transaction is outside the caller visibility scope, return 403.
  
  

Search

• OPERATOR : optional text search applied on the order references, the supplier (name, externalId), and eventId.
  
  
• SUPPLIER : optional text search applied on the order references and eventId.
  
  

Filters

• AND between different keys; OR between values of the same key. Unknown values are ignored; empty lists mean no filter.
  
• Supported filters: status, amountMin, amountMax, transactionId, logisticOrderReference.
  
• transactionId and logisticOrderReference follow a precedence rule when both are provided:
  
  • OPERATOR: logisticOrderReference is ignored.
    
  • SUPPLIER: transactionId is ignored.
    
    
• When both filters are missing or do not match any existing resource, they are ignored:
  
  • OPERATOR: all events within th e commercial transaction scope are returned.
    
  • SUPPLIER: all events across all logistic orders belonging to the supplier scope are returned.
    
    

Sorting

• Sorting expression following the format: <field>:<direction>.
  
• Supported fields: amount, status, orderReference, createdAt.
  
• Default sort: createdAt:asc.
  
• Invalid sorts are silently ignored.