feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 139
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-3c7ee3ec9931aaeeb5e015a598812cde9edc09f114adb8759ef4c2054c90f7dc.yml
-openapi_spec_hash: a14720041156fe4f353449142edacf0d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-563cf1475c193333d5f8cab934fbf844e439db6218c5b9eccb089b5c1d797b4b.yml
+openapi_spec_hash: f2b06aac248aecb248e975af25f3911c
 config_hash: 3279841440b02d4e8303c961d6983492

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

@@ -78,8 +78,11 @@ import kotlin.jvm.optionals.getOrNull
  * pass `invoice_settings` in the body of this request, Orb will also generate a one-off invoice for
  * the customer for the credits pre-purchase. Note that you _must_ provide the
  * `per_unit_cost_basis`, since the total charges on the invoice are calculated by multiplying the
- * cost basis with the number of credit units added. Additionally, Orb also enforces invoice
- * generation when a non-zero `per_unit_cost_basis` value is provided.
+ * cost basis with the number of credit units added.
+ * * if `per_unit_cost_basis` is greater than zero, an invoice will be generated and
+ *   `invoice_settings` must be included
+ * * if `invoice_settings` is passed, one of either `custom_due_date` or `net_terms` is required to
+ *   determine the due date
  *
  * ## Deducting Credits
  * Orb allows you to deduct credits from a customer by creating an entry of type `decrement`. Orb
@@ -1892,7 +1895,7 @@ private constructor(
                  * based on the invoice or issuance date, depending on the account's configured due
                  * date calculation method. A value of '0' here represents that the invoice is due
                  * on issue, whereas a value of '30' represents that the customer has 30 days to pay
-                 * the invoice. Do not set this field if you want to set a custom due date.
+                 * the invoice. You must set either `net_terms` or `custom_due_date`, but not both.
                  *
                  * @throws OrbInvalidDataException if the JSON field has an unexpected type (e.g. if
                  *   the server responded with an unexpected value).
@@ -2169,8 +2172,8 @@ private constructor(
                      * based on the invoice or issuance date, depending on the account's configured
                      * due date calculation method. A value of '0' here represents that the invoice
                      * is due on issue, whereas a value of '30' represents that the customer has 30
-                     * days to pay the invoice. Do not set this field if you want to set a custom
-                     * due date.
+                     * days to pay the invoice. You must set either `net_terms` or
+                     * `custom_due_date`, but not both.
                      */
                     fun netTerms(netTerms: Long?) = netTerms(JsonField.ofNullable(netTerms))
 

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

@@ -78,8 +78,11 @@ import kotlin.jvm.optionals.getOrNull
  * pass `invoice_settings` in the body of this request, Orb will also generate a one-off invoice for
  * the customer for the credits pre-purchase. Note that you _must_ provide the
  * `per_unit_cost_basis`, since the total charges on the invoice are calculated by multiplying the
- * cost basis with the number of credit units added. Additionally, Orb also enforces invoice
- * generation when a non-zero `per_unit_cost_basis` value is provided.
+ * cost basis with the number of credit units added.
+ * * if `per_unit_cost_basis` is greater than zero, an invoice will be generated and
+ *   `invoice_settings` must be included
+ * * if `invoice_settings` is passed, one of either `custom_due_date` or `net_terms` is required to
+ *   determine the due date
  *
  * ## Deducting Credits
  * Orb allows you to deduct credits from a customer by creating an entry of type `decrement`. Orb
@@ -1884,7 +1887,7 @@ private constructor(
                  * based on the invoice or issuance date, depending on the account's configured due
                  * date calculation method. A value of '0' here represents that the invoice is due
                  * on issue, whereas a value of '30' represents that the customer has 30 days to pay
-                 * the invoice. Do not set this field if you want to set a custom due date.
+                 * the invoice. You must set either `net_terms` or `custom_due_date`, but not both.
                  *
                  * @throws OrbInvalidDataException if the JSON field has an unexpected type (e.g. if
                  *   the server responded with an unexpected value).
@@ -2161,8 +2164,8 @@ private constructor(
                      * based on the invoice or issuance date, depending on the account's configured
                      * due date calculation method. A value of '0' here represents that the invoice
                      * is due on issue, whereas a value of '30' represents that the customer has 30
-                     * days to pay the invoice. Do not set this field if you want to set a custom
-                     * due date.
+                     * days to pay the invoice. You must set either `net_terms` or
+                     * `custom_due_date`, but not both.
                      */
                     fun netTerms(netTerms: Long?) = netTerms(JsonField.ofNullable(netTerms))
 

orb-java-core/src/main/kotlin/com/withorb/api/services/async/customers/credits/LedgerServiceAsync.kt

@@ -179,8 +179,11 @@ interface LedgerServiceAsync {
      * you pass `invoice_settings` in the body of this request, Orb will also generate a one-off
      * invoice for the customer for the credits pre-purchase. Note that you _must_ provide the
      * `per_unit_cost_basis`, since the total charges on the invoice are calculated by multiplying
-     * the cost basis with the number of credit units added. Additionally, Orb also enforces invoice
-     * generation when a non-zero `per_unit_cost_basis` value is provided.
+     * the cost basis with the number of credit units added.
+     * * if `per_unit_cost_basis` is greater than zero, an invoice will be generated and
+     *   `invoice_settings` must be included
+     * * if `invoice_settings` is passed, one of either `custom_due_date` or `net_terms` is required
+     *   to determine the due date
      *
      * ## Deducting Credits
      * Orb allows you to deduct credits from a customer by creating an entry of type `decrement`.
@@ -305,8 +308,11 @@ interface LedgerServiceAsync {
      * you pass `invoice_settings` in the body of this request, Orb will also generate a one-off
      * invoice for the customer for the credits pre-purchase. Note that you _must_ provide the
      * `per_unit_cost_basis`, since the total charges on the invoice are calculated by multiplying
-     * the cost basis with the number of credit units added. Additionally, Orb also enforces invoice
-     * generation when a non-zero `per_unit_cost_basis` value is provided.
+     * the cost basis with the number of credit units added.
+     * * if `per_unit_cost_basis` is greater than zero, an invoice will be generated and
+     *   `invoice_settings` must be included
+     * * if `invoice_settings` is passed, one of either `custom_due_date` or `net_terms` is required
+     *   to determine the due date
      *
      * ## Deducting Credits
      * Orb allows you to deduct credits from a customer by creating an entry of type `decrement`.

orb-java-core/src/main/kotlin/com/withorb/api/services/blocking/customers/credits/LedgerService.kt

@@ -174,8 +174,11 @@ interface LedgerService {
      * you pass `invoice_settings` in the body of this request, Orb will also generate a one-off
      * invoice for the customer for the credits pre-purchase. Note that you _must_ provide the
      * `per_unit_cost_basis`, since the total charges on the invoice are calculated by multiplying
-     * the cost basis with the number of credit units added. Additionally, Orb also enforces invoice
-     * generation when a non-zero `per_unit_cost_basis` value is provided.
+     * the cost basis with the number of credit units added.
+     * * if `per_unit_cost_basis` is greater than zero, an invoice will be generated and
+     *   `invoice_settings` must be included
+     * * if `invoice_settings` is passed, one of either `custom_due_date` or `net_terms` is required
+     *   to determine the due date
      *
      * ## Deducting Credits
      * Orb allows you to deduct credits from a customer by creating an entry of type `decrement`.
@@ -299,8 +302,11 @@ interface LedgerService {
      * you pass `invoice_settings` in the body of this request, Orb will also generate a one-off
      * invoice for the customer for the credits pre-purchase. Note that you _must_ provide the
      * `per_unit_cost_basis`, since the total charges on the invoice are calculated by multiplying
-     * the cost basis with the number of credit units added. Additionally, Orb also enforces invoice
-     * generation when a non-zero `per_unit_cost_basis` value is provided.
+     * the cost basis with the number of credit units added.
+     * * if `per_unit_cost_basis` is greater than zero, an invoice will be generated and
+     *   `invoice_settings` must be included
+     * * if `invoice_settings` is passed, one of either `custom_due_date` or `net_terms` is required
+     *   to determine the due date
      *
      * ## Deducting Credits
      * Orb allows you to deduct credits from a customer by creating an entry of type `decrement`.