more flex and filters

Controllers/ReceivedInvoicesController.cs

@@ -18,10 +18,21 @@ public sealed class ReceivedInvoicesController : ControllerBase
 
     public ReceivedInvoicesController(ReceivedInvoicesService service) => _service = service;
 
-    /// <summary>List received invoices (paged).</summary>
+    /// <summary>
+    /// List received invoices (paged, optionally filtered and sorted).
+    /// </summary>
+    /// <param name="filter">Optional iDoklad-style filter (see IssuedInvoices for the syntax).</param>
+    /// <param name="filtertype">How multiple conditions combine: <c>and</c> (default) or <c>or</c>.</param>
+    /// <param name="sort">Optional sort, e.g. <c>DateOfReceiving~desc</c>.</param>
     [HttpGet]
-    public async Task<IActionResult> List([FromQuery] int page = 1, [FromQuery] int pageSize = 20, CancellationToken ct = default)
-        => Ok(await _service.ListAsync(page, pageSize, ct));
+    public async Task<IActionResult> List(
+        [FromQuery] int page = 1,
+        [FromQuery] int pageSize = 20,
+        [FromQuery] string? filter = null,
+        [FromQuery] string? filtertype = null,
+        [FromQuery] string? sort = null,
+        CancellationToken ct = default)
+        => Ok(await _service.ListAsync(page, pageSize, filter, filtertype, sort, ct));
 
     /// <summary>Get a received invoice detail by id.</summary>
     [HttpGet("{id:int}")]