feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 116
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-612316c13276a207f56e2e2c7bbc68f4bb73de85e3661595a23f23d9ccc80276.yml
-openapi_spec_hash: 6e125f05e40521ec485edf6e15beec2e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-e79a36262fa3c577305a43717398fb70482bb2dca47cdb3e201cbb2a590c359c.yml
+openapi_spec_hash: 1e04880dccbcc082ba451083e421a471
 config_hash: 3c3524be9607afb24d2139ce26ce5389

orb-java-core/src/main/kotlin/com/withorb/api/models/CreditNoteCreateParams.kt

@@ -69,10 +69,9 @@ private constructor(
     fun reason(): Reason = body.reason()
 
     /**
-     * A date string to specify the global credit note service period end date in the customer's
-     * timezone. This will be applied to all line items that don't have their own individual service
-     * periods specified. If not provided, line items will use their original invoice line item
-     * service periods. This date is inclusive.
+     * An optional date string to specify the global credit note service period end date in the
+     * customer's timezone. This will be applied to all line items. If not provided, line items will
+     * use their original invoice line item service periods. This date is inclusive.
      *
      * @throws OrbInvalidDataException if the JSON field has an unexpected type (e.g. if the server
      *   responded with an unexpected value).
@@ -88,10 +87,9 @@ private constructor(
     fun memo(): Optional<String> = body.memo()
 
     /**
-     * A date string to specify the global credit note service period start date in the customer's
-     * timezone. This will be applied to all line items that don't have their own individual service
-     * periods specified. If not provided, line items will use their original invoice line item
-     * service periods. This date is inclusive.
+     * An optional date string to specify the global credit note service period end date in the
+     * customer's timezone. This will be applied to all line items. If not provided, line items will
+     * use their original invoice line item service periods. This date is inclusive.
      *
      * @throws OrbInvalidDataException if the JSON field has an unexpected type (e.g. if the server
      *   responded with an unexpected value).
@@ -213,10 +211,9 @@ private constructor(
         fun reason(reason: JsonField<Reason>) = apply { body.reason(reason) }
 
         /**
-         * A date string to specify the global credit note service period end date in the customer's
-         * timezone. This will be applied to all line items that don't have their own individual
-         * service periods specified. If not provided, line items will use their original invoice
-         * line item service periods. This date is inclusive.
+         * An optional date string to specify the global credit note service period end date in the
+         * customer's timezone. This will be applied to all line items. If not provided, line items
+         * will use their original invoice line item service periods. This date is inclusive.
          */
         fun endDate(endDate: LocalDate?) = apply { body.endDate(endDate) }
 
@@ -247,10 +244,9 @@ private constructor(
         fun memo(memo: JsonField<String>) = apply { body.memo(memo) }
 
         /**
-         * A date string to specify the global credit note service period start date in the
-         * customer's timezone. This will be applied to all line items that don't have their own
-         * individual service periods specified. If not provided, line items will use their original
-         * invoice line item service periods. This date is inclusive.
+         * An optional date string to specify the global credit note service period end date in the
+         * customer's timezone. This will be applied to all line items. If not provided, line items
+         * will use their original invoice line item service periods. This date is inclusive.
          */
         fun startDate(startDate: LocalDate?) = apply { body.startDate(startDate) }
 
@@ -450,10 +446,9 @@ private constructor(
         fun reason(): Reason = reason.getRequired("reason")
 
         /**
-         * A date string to specify the global credit note service period end date in the customer's
-         * timezone. This will be applied to all line items that don't have their own individual
-         * service periods specified. If not provided, line items will use their original invoice
-         * line item service periods. This date is inclusive.
+         * An optional date string to specify the global credit note service period end date in the
+         * customer's timezone. This will be applied to all line items. If not provided, line items
+         * will use their original invoice line item service periods. This date is inclusive.
          *
          * @throws OrbInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -469,10 +464,9 @@ private constructor(
         fun memo(): Optional<String> = memo.getOptional("memo")
 
         /**
-         * A date string to specify the global credit note service period start date in the
-         * customer's timezone. This will be applied to all line items that don't have their own
-         * individual service periods specified. If not provided, line items will use their original
-         * invoice line item service periods. This date is inclusive.
+         * An optional date string to specify the global credit note service period end date in the
+         * customer's timezone. This will be applied to all line items. If not provided, line items
+         * will use their original invoice line item service periods. This date is inclusive.
          *
          * @throws OrbInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -602,10 +596,10 @@ private constructor(
             fun reason(reason: JsonField<Reason>) = apply { this.reason = reason }
 
             /**
-             * A date string to specify the global credit note service period end date in the
-             * customer's timezone. This will be applied to all line items that don't have their own
-             * individual service periods specified. If not provided, line items will use their
-             * original invoice line item service periods. This date is inclusive.
+             * An optional date string to specify the global credit note service period end date in
+             * the customer's timezone. This will be applied to all line items. If not provided,
+             * line items will use their original invoice line item service periods. This date is
+             * inclusive.
              */
             fun endDate(endDate: LocalDate?) = endDate(JsonField.ofNullable(endDate))
 
@@ -637,10 +631,10 @@ private constructor(
             fun memo(memo: JsonField<String>) = apply { this.memo = memo }
 
             /**
-             * A date string to specify the global credit note service period start date in the
-             * customer's timezone. This will be applied to all line items that don't have their own
-             * individual service periods specified. If not provided, line items will use their
-             * original invoice line item service periods. This date is inclusive.
+             * An optional date string to specify the global credit note service period end date in
+             * the customer's timezone. This will be applied to all line items. If not provided,
+             * line items will use their original invoice line item service periods. This date is
+             * inclusive.
              */
             fun startDate(startDate: LocalDate?) = startDate(JsonField.ofNullable(startDate))
 
@@ -794,21 +788,21 @@ private constructor(
         fun invoiceLineItemId(): String = invoiceLineItemId.getRequired("invoice_line_item_id")
 
         /**
-         * A date string to specify this line item's credit note service period end date in the
-         * customer's timezone. If provided, this will be used for this specific line item. If not
-         * provided, will use the global end_date if available, otherwise defaults to the original
-         * invoice line item's end date. This date is inclusive.
+         * An optional date string to specify this line item's credit note service period end date
+         * in the customer's timezone. If provided, this will be used for this specific line item.
+         * If not provided, will use the global end_date if available, otherwise defaults to the
+         * original invoice line item's end date. This date is inclusive.
          *
          * @throws OrbInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
         fun endDate(): Optional<LocalDate> = endDate.getOptional("end_date")
 
         /**
-         * A date string to specify this line item's credit note service period start date in the
-         * customer's timezone. If provided, this will be used for this specific line item. If not
-         * provided, will use the global start_date if available, otherwise defaults to the original
-         * invoice line item's start date. This date is inclusive.
+         * An optional date string to specify this line item's credit note service period start date
+         * in the customer's timezone. If provided, this will be used for this specific line item.
+         * If not provided, will use the global start_date if available, otherwise defaults to the
+         * original invoice line item's start date. This date is inclusive.
          *
          * @throws OrbInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -920,10 +914,10 @@ private constructor(
             }
 
             /**
-             * A date string to specify this line item's credit note service period end date in the
-             * customer's timezone. If provided, this will be used for this specific line item. If
-             * not provided, will use the global end_date if available, otherwise defaults to the
-             * original invoice line item's end date. This date is inclusive.
+             * An optional date string to specify this line item's credit note service period end
+             * date in the customer's timezone. If provided, this will be used for this specific
+             * line item. If not provided, will use the global end_date if available, otherwise
+             * defaults to the original invoice line item's end date. This date is inclusive.
              */
             fun endDate(endDate: LocalDate?) = endDate(JsonField.ofNullable(endDate))
 
@@ -940,10 +934,10 @@ private constructor(
             fun endDate(endDate: JsonField<LocalDate>) = apply { this.endDate = endDate }
 
             /**
-             * A date string to specify this line item's credit note service period start date in
-             * the customer's timezone. If provided, this will be used for this specific line item.
-             * If not provided, will use the global start_date if available, otherwise defaults to
-             * the original invoice line item's start date. This date is inclusive.
+             * An optional date string to specify this line item's credit note service period start
+             * date in the customer's timezone. If provided, this will be used for this specific
+             * line item. If not provided, will use the global start_date if available, otherwise
+             * defaults to the original invoice line item's start date. This date is inclusive.
              */
             fun startDate(startDate: LocalDate?) = startDate(JsonField.ofNullable(startDate))
 

orb-java-core/src/test/kotlin/com/withorb/api/models/CreditNoteCreateParamsTest.kt

@@ -15,14 +15,14 @@ internal class CreditNoteCreateParamsTest {
                 CreditNoteCreateParams.LineItem.builder()
                     .amount("amount")
                     .invoiceLineItemId("4khy3nwzktxv7")
-                    .endDate(LocalDate.parse("2023-09-22"))
-                    .startDate(LocalDate.parse("2023-09-22"))
+                    .endDate(LocalDate.parse("2023-01-31"))
+                    .startDate(LocalDate.parse("2023-01-01"))
                     .build()
             )
             .reason(CreditNoteCreateParams.Reason.DUPLICATE)
-            .endDate(LocalDate.parse("2023-09-22"))
+            .endDate(LocalDate.parse("2023-01-31"))
             .memo("An optional memo for my credit note.")
-            .startDate(LocalDate.parse("2023-09-22"))
+            .startDate(LocalDate.parse("2023-01-01"))
             .build()
     }
 
@@ -34,14 +34,14 @@ internal class CreditNoteCreateParamsTest {
                     CreditNoteCreateParams.LineItem.builder()
                         .amount("amount")
                         .invoiceLineItemId("4khy3nwzktxv7")
-                        .endDate(LocalDate.parse("2023-09-22"))
-                        .startDate(LocalDate.parse("2023-09-22"))
+                        .endDate(LocalDate.parse("2023-01-31"))
+                        .startDate(LocalDate.parse("2023-01-01"))
                         .build()
                 )
                 .reason(CreditNoteCreateParams.Reason.DUPLICATE)
-                .endDate(LocalDate.parse("2023-09-22"))
+                .endDate(LocalDate.parse("2023-01-31"))
                 .memo("An optional memo for my credit note.")
-                .startDate(LocalDate.parse("2023-09-22"))
+                .startDate(LocalDate.parse("2023-01-01"))
                 .build()
 
         val body = params._body()
@@ -51,14 +51,14 @@ internal class CreditNoteCreateParamsTest {
                 CreditNoteCreateParams.LineItem.builder()
                     .amount("amount")
                     .invoiceLineItemId("4khy3nwzktxv7")
-                    .endDate(LocalDate.parse("2023-09-22"))
-                    .startDate(LocalDate.parse("2023-09-22"))
+                    .endDate(LocalDate.parse("2023-01-31"))
+                    .startDate(LocalDate.parse("2023-01-01"))
                     .build()
             )
         assertThat(body.reason()).isEqualTo(CreditNoteCreateParams.Reason.DUPLICATE)
-        assertThat(body.endDate()).contains(LocalDate.parse("2023-09-22"))
+        assertThat(body.endDate()).contains(LocalDate.parse("2023-01-31"))
         assertThat(body.memo()).contains("An optional memo for my credit note.")
-        assertThat(body.startDate()).contains(LocalDate.parse("2023-09-22"))
+        assertThat(body.startDate()).contains(LocalDate.parse("2023-01-01"))
     }
 
     @Test

orb-java-core/src/test/kotlin/com/withorb/api/services/async/CreditNoteServiceAsyncTest.kt

@@ -28,14 +28,14 @@ internal class CreditNoteServiceAsyncTest {
                         CreditNoteCreateParams.LineItem.builder()
                             .amount("amount")
                             .invoiceLineItemId("4khy3nwzktxv7")
-                            .endDate(LocalDate.parse("2023-09-22"))
-                            .startDate(LocalDate.parse("2023-09-22"))
+                            .endDate(LocalDate.parse("2023-01-31"))
+                            .startDate(LocalDate.parse("2023-01-01"))
                             .build()
                     )
                     .reason(CreditNoteCreateParams.Reason.DUPLICATE)
-                    .endDate(LocalDate.parse("2023-09-22"))
+                    .endDate(LocalDate.parse("2023-01-31"))
                     .memo("An optional memo for my credit note.")
-                    .startDate(LocalDate.parse("2023-09-22"))
+                    .startDate(LocalDate.parse("2023-01-01"))
                     .build()
             )
 

orb-java-core/src/test/kotlin/com/withorb/api/services/blocking/CreditNoteServiceTest.kt

@@ -28,14 +28,14 @@ internal class CreditNoteServiceTest {
                         CreditNoteCreateParams.LineItem.builder()
                             .amount("amount")
                             .invoiceLineItemId("4khy3nwzktxv7")
-                            .endDate(LocalDate.parse("2023-09-22"))
-                            .startDate(LocalDate.parse("2023-09-22"))
+                            .endDate(LocalDate.parse("2023-01-31"))
+                            .startDate(LocalDate.parse("2023-01-01"))
                             .build()
                     )
                     .reason(CreditNoteCreateParams.Reason.DUPLICATE)
-                    .endDate(LocalDate.parse("2023-09-22"))
+                    .endDate(LocalDate.parse("2023-01-31"))
                     .memo("An optional memo for my credit note.")
-                    .startDate(LocalDate.parse("2023-09-22"))
+                    .startDate(LocalDate.parse("2023-01-01"))
                     .build()
             )