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-373ca3e805c414f75a90b0088c57cbb60ff207abdca0a8e397c551de88606c4a.yml
-openapi_spec_hash: 1c30d01bd9c38f8a2aa4bd088fbe69bc
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/orb%2Forb-a44cccd16bb58080f7cc0669999403f6ed3f77287fad901caa6fd2523f2fbafd.yml
+openapi_spec_hash: af6444648d0b2a70b7f7ad234bd37541
 config_hash: 1f535c1fa222aacf28b636eed21bec72

src/orb/resources/invoices.py

@@ -57,12 +57,12 @@ def create(
         currency: str,
         invoice_date: Union[str, datetime],
         line_items: Iterable[invoice_create_params.LineItem],
-        net_terms: int,
         customer_id: Optional[str] | NotGiven = NOT_GIVEN,
         discount: Optional[Discount] | NotGiven = NOT_GIVEN,
         external_customer_id: Optional[str] | NotGiven = NOT_GIVEN,
         memo: Optional[str] | NotGiven = NOT_GIVEN,
         metadata: Optional[Dict[str, Optional[str]]] | NotGiven = NOT_GIVEN,
+        net_terms: Optional[int] | NotGiven = NOT_GIVEN,
         will_auto_issue: bool | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -82,11 +82,6 @@ def create(
           invoice_date: Optional invoice date to set. Must be in the past, if not set, `invoice_date` is
               set to the current time in the customer's timezone.
 
-          net_terms: Determines the difference between the invoice issue date for subscription
-              invoices as the date that they are due. 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.
-
           customer_id: The id of the `Customer` to create this invoice for. One of `customer_id` and
               `external_customer_id` are required.
 
@@ -101,6 +96,11 @@ def create(
               by setting the value to `null`, and the entire metadata mapping can be cleared
               by setting `metadata` to `null`.
 
+          net_terms: Determines the difference between the invoice issue date for subscription
+              invoices as the date that they are due. 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.
+
           will_auto_issue: When true, this invoice will be submitted for issuance upon creation. When
               false, the resulting invoice will require manual review to issue. Defaulted to
               false.
@@ -122,12 +122,12 @@ def create(
                     "currency": currency,
                     "invoice_date": invoice_date,
                     "line_items": line_items,
-                    "net_terms": net_terms,
                     "customer_id": customer_id,
                     "discount": discount,
                     "external_customer_id": external_customer_id,
                     "memo": memo,
                     "metadata": metadata,
+                    "net_terms": net_terms,
                     "will_auto_issue": will_auto_issue,
                 },
                 invoice_create_params.InvoiceCreateParams,
@@ -597,12 +597,12 @@ async def create(
         currency: str,
         invoice_date: Union[str, datetime],
         line_items: Iterable[invoice_create_params.LineItem],
-        net_terms: int,
         customer_id: Optional[str] | NotGiven = NOT_GIVEN,
         discount: Optional[Discount] | NotGiven = NOT_GIVEN,
         external_customer_id: Optional[str] | NotGiven = NOT_GIVEN,
         memo: Optional[str] | NotGiven = NOT_GIVEN,
         metadata: Optional[Dict[str, Optional[str]]] | NotGiven = NOT_GIVEN,
+        net_terms: Optional[int] | NotGiven = NOT_GIVEN,
         will_auto_issue: bool | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -622,11 +622,6 @@ async def create(
           invoice_date: Optional invoice date to set. Must be in the past, if not set, `invoice_date` is
               set to the current time in the customer's timezone.
 
-          net_terms: Determines the difference between the invoice issue date for subscription
-              invoices as the date that they are due. 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.
-
           customer_id: The id of the `Customer` to create this invoice for. One of `customer_id` and
               `external_customer_id` are required.
 
@@ -641,6 +636,11 @@ async def create(
               by setting the value to `null`, and the entire metadata mapping can be cleared
               by setting `metadata` to `null`.
 
+          net_terms: Determines the difference between the invoice issue date for subscription
+              invoices as the date that they are due. 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.
+
           will_auto_issue: When true, this invoice will be submitted for issuance upon creation. When
               false, the resulting invoice will require manual review to issue. Defaulted to
               false.
@@ -662,12 +662,12 @@ async def create(
                     "currency": currency,
                     "invoice_date": invoice_date,
                     "line_items": line_items,
-                    "net_terms": net_terms,
                     "customer_id": customer_id,
                     "discount": discount,
                     "external_customer_id": external_customer_id,
                     "memo": memo,
                     "metadata": metadata,
+                    "net_terms": net_terms,
                     "will_auto_issue": will_auto_issue,
                 },
                 invoice_create_params.InvoiceCreateParams,

src/orb/types/invoice_create_params.py

@@ -29,14 +29,6 @@ class InvoiceCreateParams(TypedDict, total=False):
 
     line_items: Required[Iterable[LineItem]]
 
-    net_terms: Required[int]
-    """
-    Determines the difference between the invoice issue date for subscription
-    invoices as the date that they are due. 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.
-    """
-
     customer_id: Optional[str]
     """The id of the `Customer` to create this invoice for.
 
@@ -62,6 +54,14 @@ class InvoiceCreateParams(TypedDict, total=False):
     metadata mapping can be cleared by setting `metadata` to `null`.
     """
 
+    net_terms: Optional[int]
+    """
+    Determines the difference between the invoice issue date for subscription
+    invoices as the date that they are due. 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.
+    """
+
     will_auto_issue: bool
     """When true, this invoice will be submitted for issuance upon creation.
 

tests/api_resources/test_invoices.py

@@ -38,7 +38,6 @@ def test_method_create(self, client: Orb) -> None:
                     "unit_config": {"unit_amount": "unit_amount"},
                 }
             ],
-            net_terms=0,
         )
         assert_matches_type(Invoice, invoice, path=["response"])
 
@@ -58,7 +57,6 @@ def test_method_create_with_all_params(self, client: Orb) -> None:
                     "unit_config": {"unit_amount": "unit_amount"},
                 }
             ],
-            net_terms=0,
             customer_id="4khy3nwzktxv7",
             discount={
                 "discount_type": "percentage",
@@ -76,6 +74,7 @@ def test_method_create_with_all_params(self, client: Orb) -> None:
             external_customer_id="external-customer-id",
             memo="An optional memo for my invoice.",
             metadata={"foo": "string"},
+            net_terms=0,
             will_auto_issue=False,
         )
         assert_matches_type(Invoice, invoice, path=["response"])
@@ -96,7 +95,6 @@ def test_raw_response_create(self, client: Orb) -> None:
                     "unit_config": {"unit_amount": "unit_amount"},
                 }
             ],
-            net_terms=0,
         )
 
         assert response.is_closed is True
@@ -120,7 +118,6 @@ def test_streaming_response_create(self, client: Orb) -> None:
                     "unit_config": {"unit_amount": "unit_amount"},
                 }
             ],
-            net_terms=0,
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -491,7 +488,6 @@ async def test_method_create(self, async_client: AsyncOrb) -> None:
                     "unit_config": {"unit_amount": "unit_amount"},
                 }
             ],
-            net_terms=0,
         )
         assert_matches_type(Invoice, invoice, path=["response"])
 
@@ -511,7 +507,6 @@ async def test_method_create_with_all_params(self, async_client: AsyncOrb) -> No
                     "unit_config": {"unit_amount": "unit_amount"},
                 }
             ],
-            net_terms=0,
             customer_id="4khy3nwzktxv7",
             discount={
                 "discount_type": "percentage",
@@ -529,6 +524,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncOrb) -> No
             external_customer_id="external-customer-id",
             memo="An optional memo for my invoice.",
             metadata={"foo": "string"},
+            net_terms=0,
             will_auto_issue=False,
         )
         assert_matches_type(Invoice, invoice, path=["response"])
@@ -549,7 +545,6 @@ async def test_raw_response_create(self, async_client: AsyncOrb) -> None:
                     "unit_config": {"unit_amount": "unit_amount"},
                 }
             ],
-            net_terms=0,
         )
 
         assert response.is_closed is True
@@ -573,7 +568,6 @@ async def test_streaming_response_create(self, async_client: AsyncOrb) -> None:
                     "unit_config": {"unit_amount": "unit_amount"},
                 }
             ],
-            net_terms=0,
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"