feat: add support for invoice consolidation attribute

src/schemas/SubscriptionCreateInput.yaml

@@ -75,3 +75,12 @@ properties:
       payment_method:
         $ref: "./PaymentMethodReference.yaml"
         description: Optional payment method to use for processing subscription payments.
+      consolidate_invoice:
+        type: boolean
+        default: true
+        example: true
+        description: |
+          Defines whether this subscription should be grouped with other subscriptions of the same customer when generating recurring invoices.
+
+          - `true` (default): the subscription is included in the customer's standard invoice grouping (by billing entity, currency and payment method).
+          - `false`: the subscription is excluded from consolidation and always billed on its own dedicated invoice.

src/schemas/SubscriptionObject.yaml

@@ -200,3 +200,12 @@ properties:
   payment_method:
     $ref: "./PaymentMethodReference.yaml"
     description: The payment method assigned to this subscription for processing payments.
+  consolidate_invoice:
+    type: boolean
+    default: true
+    example: true
+    description: |
+      Controls whether this subscription is eligible to be grouped with other subscriptions of the same customer on a consolidated recurring invoice.
+
+      - `true` (default): the subscription is included in the customer's standard invoice grouping (by billing entity, currency and payment method).
+      - `false`: the subscription is excluded from consolidation and always billed on its own dedicated invoice, regardless of other grouping criteria.

src/schemas/SubscriptionUpdateInput.yaml

@@ -39,3 +39,11 @@ properties:
       payment_method:
         $ref: "./PaymentMethodReference.yaml"
         description: Optional payment method to use for processing subscription payments.
+      consolidate_invoice:
+        type: boolean
+        example: false
+        description: |
+          Defines whether this subscription should be grouped with other subscriptions of the same customer when generating recurring invoices.
+
+          - `true`: the subscription is included in the customer's standard invoice grouping (by billing entity, currency and payment method).
+          - `false`: the subscription is excluded from consolidation and always billed on its own dedicated invoice.