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

src/orb/resources/customers/credits/ledger.py

@@ -286,8 +286,12 @@ def create_entry(
         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.
+        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
 
@@ -460,8 +464,12 @@ def create_entry(
         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.
+        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
 
@@ -621,8 +629,12 @@ def create_entry(
         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.
+        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
 
@@ -790,8 +802,12 @@ def create_entry(
         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.
+        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
 
@@ -953,8 +969,12 @@ def create_entry(
         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.
+        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
 
@@ -1193,8 +1213,12 @@ def create_entry_by_external_id(
         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.
+        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
 
@@ -1367,8 +1391,12 @@ def create_entry_by_external_id(
         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.
+        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
 
@@ -1528,8 +1556,12 @@ def create_entry_by_external_id(
         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.
+        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
 
@@ -1697,8 +1729,12 @@ def create_entry_by_external_id(
         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.
+        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
 
@@ -1860,8 +1896,12 @@ def create_entry_by_external_id(
         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.
+        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
 
@@ -2443,8 +2483,12 @@ async def create_entry(
         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.
+        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
 
@@ -2617,8 +2661,12 @@ async def create_entry(
         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.
+        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
 
@@ -2778,8 +2826,12 @@ async def create_entry(
         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.
+        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
 
@@ -2947,8 +2999,12 @@ async def create_entry(
         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.
+        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
 
@@ -3110,8 +3166,12 @@ async def create_entry(
         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.
+        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
 
@@ -3350,8 +3410,12 @@ async def create_entry_by_external_id(
         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.
+        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
 
@@ -3524,8 +3588,12 @@ async def create_entry_by_external_id(
         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.
+        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
 
@@ -3685,8 +3753,12 @@ async def create_entry_by_external_id(
         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.
+        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
 
@@ -3854,8 +3926,12 @@ async def create_entry_by_external_id(
         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.
+        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
 
@@ -4017,8 +4093,12 @@ async def create_entry_by_external_id(
         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.
+        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
 

src/orb/types/customers/credits/ledger_create_entry_by_external_id_params.py

@@ -137,8 +137,8 @@ class AddIncrementCreditLedgerEntryRequestParamsInvoiceSettings(TypedDict, total
     Due date is calculated 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.
+    customer has 30 days to pay the invoice. You must set either `net_terms` or
+    `custom_due_date`, but not both.
     """
 
     require_successful_payment: bool

src/orb/types/customers/credits/ledger_create_entry_params.py

@@ -137,8 +137,8 @@ class AddIncrementCreditLedgerEntryRequestParamsInvoiceSettings(TypedDict, total
     Due date is calculated 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.
+    customer has 30 days to pay the invoice. You must set either `net_terms` or
+    `custom_due_date`, but not both.
     """
 
     require_successful_payment: bool