feat(export invoices): extend GET /invoices by amount and metadata

src/resources/invoices.yaml

@@ -34,6 +34,22 @@ get:
     - $ref: '../parameters/page.yaml'
     - $ref: '../parameters/per_page.yaml'
     - $ref: '../parameters/external_customer_id.yaml'
+    - name: amount_from
+      in: query
+      description: Filter invoices of at least a specific amount. This parameter must be defined in cents to ensure consistent handling for all currency types.
+      required: false
+      explode: true
+      schema:
+        type: integer
+        example: 9000
+    - name: amount_to
+      in: query
+      description: Filter invoices up to a specific amount. This parameter must be defined in cents to ensure consistent handling for all currency types.
+      required: false
+      explode: true
+      schema:
+        type: integer
+        example: 100000
     - name: issuing_date_from
       in: query
       description: Filter invoices starting from a specific date.
@@ -118,6 +134,14 @@ get:
           - credit
           - one_off
           - advance_charges
+    - name: metadata[key]
+      in: query
+      description: Filter invoices by metadata. Replace `key` with the actual metadata key you want to match, and provide the corresponding value. For example, `metadata[color]=blue`.
+      required: false
+      explode: true
+      schema:
+        type: string
+        example: "someValue"
   responses:
     '200':
       description: Invoices
@@ -126,4 +150,4 @@ get:
           schema:
             $ref: '../schemas/InvoicesPaginated.yaml'
     '401':
-      $ref: '../responses/Unauthorized.yaml'
+      $ref: '../responses/Unauthorized.yaml'