lago-python-client 1.49.0__tar.gz → 1.52.0__tar.gz

{lago_python_client-1.49.0 → lago_python_client-1.52.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lago-python-client
-Version: 1.49.0
+Version: 1.52.0
 Summary: Lago Python API Client
 Home-page: https://github.com/getlago/lago-python-client
 Author: Lovro Colic

{lago_python_client-1.49.0 → lago_python_client-1.52.0}/lago_python_client/client.py

@@ -25,6 +25,8 @@ from .invoice_collections.clients import InvoiceCollectionClient
 from .invoiced_usages.clients import InvoicedUsageClient
 from .invoices.clients import InvoiceClient
 from .mrrs.clients import MrrClient
+from .order_forms.clients import OrderFormClient
+from .orders.clients import OrderClient
 from .organizations.clients import OrganizationClient
 from .overdue_balances.clients import OverdueBalanceClient
 from .payment_receipts.clients import PaymentReceiptClient
@@ -33,6 +35,8 @@ from .payments.clients import PaymentClient
 from .plans.charges_client import PlanChargesClient
 from .plans.clients import PlanClient
 from .plans.fixed_charges_client import PlanFixedChargesClient
+from .quote_versions.clients import QuoteVersionClient
+from .quotes.clients import QuoteClient
 from .services.rate_limit import RateLimitCallback, RateLimitRetryConfig
 from .subscriptions.charges_client import SubscriptionChargesClient
 from .subscriptions.clients import SubscriptionClient
@@ -180,6 +184,14 @@ class Client:
     def mrrs(self) -> MrrClient:
         return self._create_client(MrrClient, self.base_api_url, self.api_key)
 
+    @callable_cached_property
+    def order_forms(self) -> OrderFormClient:
+        return self._create_client(OrderFormClient, self.base_api_url, self.api_key)
+
+    @callable_cached_property
+    def orders(self) -> OrderClient:
+        return self._create_client(OrderClient, self.base_api_url, self.api_key)
+
     @callable_cached_property
     def organizations(self) -> OrganizationClient:
         return self._create_client(OrganizationClient, self.base_api_url, self.api_key)
@@ -216,6 +228,14 @@ class Client:
     def plan_fixed_charges(self) -> PlanFixedChargesClient:
         return self._create_client(PlanFixedChargesClient, self.base_api_url, self.api_key)
 
+    @callable_cached_property
+    def quotes(self) -> QuoteClient:
+        return self._create_client(QuoteClient, self.base_api_url, self.api_key)
+
+    @callable_cached_property
+    def quote_versions(self) -> QuoteVersionClient:
+        return self._create_client(QuoteVersionClient, self.base_api_url, self.api_key)
+
     @callable_cached_property
     def subscriptions(self) -> SubscriptionClient:
         return self._create_client(SubscriptionClient, self.base_api_url, self.api_key)

{lago_python_client-1.49.0 → lago_python_client-1.52.0}/lago_python_client/invoices/clients.py

@@ -3,6 +3,7 @@ from typing import Any, ClassVar, Mapping, Optional, Type
 from ..base_client import BaseClient
 from ..mixins import (
     CreateCommandMixin,
+    DestroyCommandMixin,
     FindAllCommandMixin,
     FindCommandMixin,
     UpdateCommandMixin,
@@ -24,6 +25,7 @@ class InvoiceClient(
     FindAllCommandMixin[InvoiceResponse],
     UpdateCommandMixin[InvoiceResponse],
     CreateCommandMixin[InvoiceResponse],
+    DestroyCommandMixin[InvoiceResponse],
     BaseClient,
 ):
     API_RESOURCE: ClassVar[str] = "invoices"

{lago_python_client-1.49.0 → lago_python_client-1.52.0}/lago_python_client/models/__init__.py

@@ -218,6 +218,21 @@ from .minimum_commitment import (
 from .minimum_commitment import (
     MinimumCommitmentResponse as MinimumCommitmentResponse,
 )
+from .order import (
+    OrderExecute as OrderExecute,
+)
+from .order import (
+    OrderExecutionRecordResponse as OrderExecutionRecordResponse,
+)
+from .order import (
+    OrderResponse as OrderResponse,
+)
+from .order_form import (
+    OrderFormMarkAsSigned as OrderFormMarkAsSigned,
+)
+from .order_form import (
+    OrderFormResponse as OrderFormResponse,
+)
 from .organization import (
     Organization as Organization,
 )
@@ -234,7 +249,34 @@ from .payment_receipt import (
 from .payment_request import PaymentRequest as PaymentRequest
 from .payment_method import PaymentMethod as PaymentMethod, PaymentMethodResponse as PaymentMethodResponse
 from .plan import Plan as Plan
-from .subscription import Subscription as Subscription
+from .quote import (
+    QuoteBillingItemAddOnResponse as QuoteBillingItemAddOnResponse,
+)
+from .quote import (
+    QuoteBillingItemCouponResponse as QuoteBillingItemCouponResponse,
+)
+from .quote import (
+    QuoteBillingItemPlanResponse as QuoteBillingItemPlanResponse,
+)
+from .quote import (
+    QuoteBillingItemsResponse as QuoteBillingItemsResponse,
+)
+from .quote import (
+    QuoteBillingItemWalletCreditResponse as QuoteBillingItemWalletCreditResponse,
+)
+from .quote import (
+    QuoteOwnerResponse as QuoteOwnerResponse,
+)
+from .quote import (
+    QuoteResponse as QuoteResponse,
+)
+from .quote import (
+    QuoteVersionApprove as QuoteVersionApprove,
+)
+from .quote import (
+    QuoteVersionResponse as QuoteVersionResponse,
+)
+from .subscription import ActivationRuleInput as ActivationRuleInput, Subscription as Subscription
 from .tax import (
     Tax as Tax,
 )

{lago_python_client-1.49.0 → lago_python_client-1.52.0}/lago_python_client/models/credit_note.py

@@ -43,6 +43,7 @@ class CreditNoteResponse(BaseResponseModel):
     number: Optional[str]
     lago_invoice_id: Optional[str]
     invoice_number: Optional[str]
+    purchase_order_number: Optional[str]
     credit_status: Optional[str]
     refund_status: Optional[str]
     reason: Optional[str]

{lago_python_client-1.49.0 → lago_python_client-1.52.0}/lago_python_client/models/customer_usage.py

@@ -73,7 +73,7 @@ class CustomerUsageResponse(BaseResponseModel):
     from_datetime: str
     to_datetime: str
     issuing_date: str
-    invoice_id: Optional[str]
+    lago_invoice_id: Optional[str]
     currency: str
     amount_cents: int
     total_amount_cents: int

{lago_python_client-1.49.0 → lago_python_client-1.52.0}/lago_python_client/models/invoice.py

@@ -58,6 +58,7 @@ class OneOffInvoice(BaseModel):
     payment_method: Optional[PaymentMethod]
     invoice_custom_section: Optional[InvoiceCustomSectionInput]
     billing_entity_code: Optional[str]
+    purchase_order_number: Optional[str]
 
 
 class InvoicePreview(BaseModel):
@@ -115,6 +116,7 @@ class InvoiceResponse(BaseResponseModel):
     lago_id: str
     sequential_id: Optional[int]
     number: str
+    purchase_order_number: Optional[str]
     issuing_date: Optional[str]
     payment_dispute_lost_at: Optional[str]
     payment_due_date: Optional[str]
@@ -139,6 +141,7 @@ class InvoiceResponse(BaseResponseModel):
     prepaid_purchased_credit_amount_cents: Optional[int]
 
     file_url: Optional[str]
+    web_url: Optional[str]
     customer: Optional[CustomerResponse]
     billing_periods: Optional[BillingPeriodsResponse]
     subscriptions: Optional[SubscriptionsResponse]

lago_python_client-1.52.0/lago_python_client/models/order.py

@@ -0,0 +1,39 @@
+from typing import List, Optional
+
+from lago_python_client.base_model import BaseModel
+
+from ..base_model import BaseResponseModel
+from .quote import QuoteBillingItemsResponse
+
+
+class OrderExecute(BaseModel):
+    execution_mode: Optional[str]
+
+
+class OrderExecutionRecordResponse(BaseResponseModel):
+    executed_at: Optional[str]
+    execution_mode: Optional[str]
+    invoice_id: Optional[str]
+    subscription_ids: Optional[List[str]]
+    terminated_subscription_ids: Optional[List[str]]
+    applied_coupon_ids: Optional[List[str]]
+    wallet_ids: Optional[List[str]]
+    errors: Optional[List[str]]
+
+
+class OrderResponse(BaseResponseModel):
+    lago_id: str
+    number: str
+    status: str
+    order_type: str
+    execution_mode: Optional[str]
+    currency: Optional[str]
+    executed_at: Optional[str]
+    execution_record: Optional[OrderExecutionRecordResponse]
+    lago_organization_id: str
+    lago_customer_id: str
+    lago_order_form_id: str
+    created_at: str
+    updated_at: str
+    # Omitted from the webhook payloads, being a heavy blob.
+    billing_snapshot: Optional[QuoteBillingItemsResponse]

lago_python_client-1.52.0/lago_python_client/models/order_form.py

@@ -0,0 +1,28 @@
+from typing import Optional
+
+from lago_python_client.base_model import BaseModel
+
+from ..base_model import BaseResponseModel
+
+
+class OrderFormMarkAsSigned(BaseModel):
+    signed_document: Optional[str]
+    execution_mode: Optional[str]
+    execute_at: Optional[str]
+
+
+class OrderFormResponse(BaseResponseModel):
+    lago_id: str
+    number: str
+    status: str
+    void_reason: Optional[str]
+    expires_at: Optional[str]
+    signed_at: Optional[str]
+    voided_at: Optional[str]
+    signed_document_url: Optional[str]
+    lago_organization_id: str
+    lago_customer_id: str
+    lago_quote_id: str
+    lago_quote_version_id: str
+    created_at: str
+    updated_at: str

{lago_python_client-1.49.0 → lago_python_client-1.52.0}/lago_python_client/models/payment_request.py

@@ -33,6 +33,7 @@ class PaymentRequestInvoiceResponse(BaseResponseModel):
     total_amount_cents: int
     prepaid_credit_amount_cents: int
     file_url: Optional[str]
+    web_url: Optional[str]
 
 
 class PaymentRequestInvoicesResponse(BaseResponseModel):

lago_python_client-1.52.0/lago_python_client/models/quote.py

@@ -0,0 +1,83 @@
+from typing import Any, Dict, List, Optional
+
+from lago_python_client.base_model import BaseModel
+
+from ..base_model import BaseResponseModel
+
+
+class QuoteVersionApprove(BaseModel):
+    expires_at: Optional[str]
+
+
+class QuoteBillingItemAddOnResponse(BaseResponseModel):
+    id: Optional[str]
+    localId: Optional[str]
+    type: Optional[str]
+    payload: Optional[Dict[str, Any]]
+    overrides: Optional[Dict[str, Any]]
+
+
+class QuoteBillingItemPlanResponse(BaseResponseModel):
+    id: Optional[str]
+    localId: Optional[str]
+    type: Optional[str]
+    payload: Optional[Dict[str, Any]]
+    overrides: Optional[Dict[str, Any]]
+
+
+class QuoteBillingItemCouponResponse(BaseResponseModel):
+    id: Optional[str]
+    localId: Optional[str]
+    type: Optional[str]
+    payload: Optional[Dict[str, Any]]
+    overrides: Optional[Dict[str, Any]]
+
+
+class QuoteBillingItemWalletCreditResponse(BaseResponseModel):
+    localId: Optional[str]
+    type: Optional[str]
+    payload: Optional[Dict[str, Any]]
+
+
+class QuoteBillingItemsResponse(BaseResponseModel):
+    addOns: Optional[List[QuoteBillingItemAddOnResponse]]
+    plans: Optional[List[QuoteBillingItemPlanResponse]]
+    coupons: Optional[List[QuoteBillingItemCouponResponse]]
+    walletCredits: Optional[List[QuoteBillingItemWalletCreditResponse]]
+
+
+class QuoteVersionResponse(BaseResponseModel):
+    lago_id: str
+    lago_quote_id: str
+    lago_organization_id: str
+    version: int
+    status: str
+    currency: Optional[str]
+    billing_entity_code: Optional[str]
+    void_reason: Optional[str]
+    approved_at: Optional[str]
+    voided_at: Optional[str]
+    created_at: str
+    updated_at: str
+    # Only returned when a single version is retrieved.
+    content: Optional[str]
+    billing_items: Optional[QuoteBillingItemsResponse]
+
+
+class QuoteOwnerResponse(BaseResponseModel):
+    lago_id: str
+    email: Optional[str]
+
+
+class QuoteResponse(BaseResponseModel):
+    lago_id: str
+    number: str
+    order_type: str
+    lago_customer_id: str
+    lago_subscription_id: Optional[str]
+    lago_organization_id: str
+    created_at: str
+    updated_at: str
+    current_version: Optional[QuoteVersionResponse]
+    # Only returned when a single quote is retrieved.
+    owners: Optional[List[QuoteOwnerResponse]]

{lago_python_client-1.49.0 → lago_python_client-1.52.0}/lago_python_client/models/subscription.py

@@ -8,6 +8,11 @@ from .payment_method import PaymentMethod
 from .plan import PlanOverrides
 
 
+class ActivationRuleInput(BaseModel):
+    type: Optional[str]
+    timeout_hours: Optional[int]
+
+
 class Subscription(BaseModel):
     plan_code: Optional[str]
     external_customer_id: Optional[str]
@@ -21,6 +26,8 @@ class Subscription(BaseModel):
     invoice_custom_section: Optional[InvoiceCustomSectionInput]
     consolidate_invoice: Optional[bool]
     billing_entity_code: Optional[str]
+    purchase_order_number: Optional[str]
+    activation_rules: Optional[List[ActivationRuleInput]]
 
 
 class Subscriptions(BaseModel):
@@ -29,6 +36,16 @@ class Subscriptions(BaseModel):
     terminated_at: Optional[str]
 
 
+class ActivationRuleResponse(BaseResponseModel):
+    lago_id: Optional[str]
+    type: Optional[str]
+    timeout_hours: Optional[int]
+    status: Optional[str]
+    expires_at: Optional[str]
+    created_at: Optional[str]
+    updated_at: Optional[str]
+
+
 class SubscriptionResponse(BaseResponseModel):
     lago_id: str
     lago_customer_id: Optional[str]
@@ -59,6 +76,10 @@ class SubscriptionResponse(BaseResponseModel):
     applied_invoice_custom_sections: Optional[AppliedInvoiceCustomSections]
     consolidate_invoice: Optional[bool]
     billing_entity_code: Optional[str]
+    purchase_order_number: Optional[str]
+    cancellation_reason: Optional[str]
+    activated_at: Optional[str]
+    activation_rules: Optional[List[ActivationRuleResponse]]
 
 
 class SubscriptionsResponse(BaseResponseModel):

{lago_python_client-1.49.0 → lago_python_client-1.52.0}/lago_python_client/models/wallet.py

@@ -22,6 +22,7 @@ class RecurringTransactionRule(BaseModel):
     transaction_name: Optional[str]
     ignore_paid_top_up_limits: Optional[bool]
     grants_target_top_up: Optional[bool]
+    purchase_order_number: Optional[str]
     payment_method: Optional[PaymentMethod]
     invoice_custom_section: Optional[InvoiceCustomSectionInput]
 
@@ -43,6 +44,7 @@ class RecurringTransactionRuleResponse(BaseModel):
     transaction_name: Optional[str]
     ignore_paid_top_up_limits: Optional[bool]
     grants_target_top_up: Optional[bool]
+    purchase_order_number: Optional[str]
     payment_method: Optional[PaymentMethod]
     applied_invoice_custom_sections: Optional[AppliedInvoiceCustomSections]
 
@@ -82,6 +84,7 @@ class Wallet(BaseModel):
     payment_method: Optional[PaymentMethod]
     invoice_custom_section: Optional[InvoiceCustomSectionInput]
     billing_entity_code: Optional[str]
+    purchase_order_number: Optional[str]
 
 
 class WalletResponse(BaseResponseModel):
@@ -115,3 +118,4 @@ class WalletResponse(BaseResponseModel):
     payment_method: Optional[PaymentMethod]
     applied_invoice_custom_sections: Optional[AppliedInvoiceCustomSections]
     billing_entity_code: Optional[str]
+    purchase_order_number: Optional[str]

{lago_python_client-1.49.0 → lago_python_client-1.52.0}/lago_python_client/models/wallet_transaction.py

@@ -16,6 +16,7 @@ class WalletTransaction(BaseModel):
     metadata: Optional[List[Dict[str, str]]]
     name: Optional[str]
     ignore_paid_top_up_limits: Optional[bool]
+    purchase_order_number: Optional[str]
     payment_method: Optional[PaymentMethod]
     invoice_custom_section: Optional[InvoiceCustomSectionInput]
 
@@ -41,6 +42,7 @@ class WalletTransactionResponse(BaseResponseModel):
     metadata: Optional[List[Dict[str, str]]]
     name: Optional[str]
     invoice_requires_successful_payment: Optional[bool]
+    purchase_order_number: Optional[str]
     payment_method: Optional[PaymentMethod]
     applied_invoice_custom_sections: Optional[AppliedInvoiceCustomSections]
 

{lago_python_client-1.49.0 → lago_python_client-1.52.0}/lago_python_client/models/webhook_endpoint.py

@@ -1,4 +1,4 @@
-from typing import Optional
+from typing import List, Optional
 
 from lago_python_client.base_model import BaseModel
 
@@ -7,6 +7,9 @@ from ..base_model import BaseResponseModel
 
 class WebhookEndpoint(BaseModel):
     webhook_url: Optional[str]
+    signature_algo: Optional[str]
+    name: Optional[str]
+    event_types: Optional[List[str]]
 
 
 class WebhookEndpointResponse(BaseResponseModel):
@@ -14,4 +17,6 @@ class WebhookEndpointResponse(BaseResponseModel):
     lago_organization_id: str
     webhook_url: str
     signature_algo: Optional[str]
+    name: Optional[str]
+    event_types: Optional[List[str]]
     created_at: str

lago_python_client-1.52.0/lago_python_client/order_forms/clients.py

@@ -0,0 +1,74 @@
+from typing import ClassVar, Optional, Type
+
+import httpx
+
+from ..base_client import BaseClient
+from ..mixins import (
+    DEFAULT_TIMEOUT,
+    FindAllCommandMixin,
+    FindCommandMixin,
+)
+from ..models.order_form import OrderFormMarkAsSigned, OrderFormResponse
+from ..services.json import to_json
+from ..services.request import (
+    make_headers,
+    make_url,
+    send_post_request,
+)
+from ..services.response import Response, get_response_data, prepare_object_response
+
+
+class OrderFormClient(
+    FindCommandMixin[OrderFormResponse],
+    FindAllCommandMixin[OrderFormResponse],
+    BaseClient,
+):
+    API_RESOURCE: ClassVar[str] = "order_forms"
+    RESPONSE_MODEL: ClassVar[Type[OrderFormResponse]] = OrderFormResponse
+    ROOT_NAME: ClassVar[str] = "order_form"
+
+    def mark_as_signed(
+        self,
+        resource_id: str,
+        input_object: Optional[OrderFormMarkAsSigned] = None,
+        timeout: Optional[httpx.Timeout] = DEFAULT_TIMEOUT,
+    ) -> OrderFormResponse:
+        """Record the customer's signature and create the order carrying the deal out."""
+        payload = input_object.dict(exclude_none=True) if input_object else {}
+
+        api_response: Response = send_post_request(
+            url=make_url(
+                origin=self.base_url,
+                path_parts=(self.API_RESOURCE, resource_id, "mark_as_signed"),
+            ),
+            content=to_json({self.ROOT_NAME: payload}) if payload else None,
+            headers=make_headers(api_key=self.api_key),
+            timeout=timeout,
+            rate_limit_retry_config=self.rate_limit_retry_config,
+        )
+
+        return prepare_object_response(
+            response_model=self.RESPONSE_MODEL,
+            data=get_response_data(response=api_response, key=self.ROOT_NAME),
+        )
+
+    def void(
+        self,
+        resource_id: str,
+        timeout: Optional[httpx.Timeout] = DEFAULT_TIMEOUT,
+    ) -> OrderFormResponse:
+        """Void a generated order form, cascading to the quote version it came from."""
+        api_response: Response = send_post_request(
+            url=make_url(
+                origin=self.base_url,
+                path_parts=(self.API_RESOURCE, resource_id, "void"),
+            ),
+            headers=make_headers(api_key=self.api_key),
+            timeout=timeout,
+            rate_limit_retry_config=self.rate_limit_retry_config,
+        )
+
+        return prepare_object_response(
+            response_model=self.RESPONSE_MODEL,
+            data=get_response_data(response=api_response, key=self.ROOT_NAME),
+        )

lago_python_client-1.52.0/lago_python_client/orders/clients.py

@@ -0,0 +1,53 @@
+from typing import ClassVar, Optional, Type
+
+import httpx
+
+from ..base_client import BaseClient
+from ..mixins import (
+    DEFAULT_TIMEOUT,
+    FindAllCommandMixin,
+    FindCommandMixin,
+)
+from ..models.order import OrderExecute, OrderResponse
+from ..services.json import to_json
+from ..services.request import (
+    make_headers,
+    make_url,
+    send_post_request,
+)
+from ..services.response import Response, get_response_data, prepare_object_response
+
+
+class OrderClient(
+    FindCommandMixin[OrderResponse],
+    FindAllCommandMixin[OrderResponse],
+    BaseClient,
+):
+    API_RESOURCE: ClassVar[str] = "orders"
+    RESPONSE_MODEL: ClassVar[Type[OrderResponse]] = OrderResponse
+    ROOT_NAME: ClassVar[str] = "order"
+
+    def execute(
+        self,
+        resource_id: str,
+        input_object: Optional[OrderExecute] = None,
+        timeout: Optional[httpx.Timeout] = DEFAULT_TIMEOUT,
+    ) -> OrderResponse:
+        """Carry out an order on demand, without waiting for its schedule."""
+        payload = input_object.dict(exclude_none=True) if input_object else {}
+
+        api_response: Response = send_post_request(
+            url=make_url(
+                origin=self.base_url,
+                path_parts=(self.API_RESOURCE, resource_id, "execute"),
+            ),
+            content=to_json({self.ROOT_NAME: payload}) if payload else None,
+            headers=make_headers(api_key=self.api_key),
+            timeout=timeout,
+            rate_limit_retry_config=self.rate_limit_retry_config,
+        )
+
+        return prepare_object_response(
+            response_model=self.RESPONSE_MODEL,
+            data=get_response_data(response=api_response, key=self.ROOT_NAME),
+        )

lago_python_client-1.52.0/lago_python_client/quote_versions/clients.py

@@ -0,0 +1,90 @@
+from typing import ClassVar, Optional, Type
+
+import httpx
+
+from ..base_client import BaseClient
+from ..mixins import DEFAULT_TIMEOUT, FindCommandMixin
+from ..models.quote import QuoteVersionApprove, QuoteVersionResponse
+from ..services.json import to_json
+from ..services.request import (
+    make_headers,
+    make_url,
+    send_post_request,
+)
+from ..services.response import Response, get_response_data, prepare_object_response
+
+
+class QuoteVersionClient(
+    FindCommandMixin[QuoteVersionResponse],
+    BaseClient,
+):
+    API_RESOURCE: ClassVar[str] = "quote_versions"
+    RESPONSE_MODEL: ClassVar[Type[QuoteVersionResponse]] = QuoteVersionResponse
+    ROOT_NAME: ClassVar[str] = "quote_version"
+
+    def approve(
+        self,
+        resource_id: str,
+        input_object: Optional[QuoteVersionApprove] = None,
+        timeout: Optional[httpx.Timeout] = DEFAULT_TIMEOUT,
+    ) -> QuoteVersionResponse:
+        """Approve a draft version and generate the order form to sign."""
+        payload = input_object.dict(exclude_none=True) if input_object else {}
+
+        api_response: Response = send_post_request(
+            url=make_url(
+                origin=self.base_url,
+                path_parts=(self.API_RESOURCE, resource_id, "approve"),
+            ),
+            content=to_json(payload) if payload else None,
+            headers=make_headers(api_key=self.api_key),
+            timeout=timeout,
+            rate_limit_retry_config=self.rate_limit_retry_config,
+        )
+
+        return prepare_object_response(
+            response_model=self.RESPONSE_MODEL,
+            data=get_response_data(response=api_response, key=self.ROOT_NAME),
+        )
+
+    def void(
+        self,
+        resource_id: str,
+        timeout: Optional[httpx.Timeout] = DEFAULT_TIMEOUT,
+    ) -> QuoteVersionResponse:
+        """Void a draft version, which makes it definitive."""
+        api_response: Response = send_post_request(
+            url=make_url(
+                origin=self.base_url,
+                path_parts=(self.API_RESOURCE, resource_id, "void"),
+            ),
+            headers=make_headers(api_key=self.api_key),
+            timeout=timeout,
+            rate_limit_retry_config=self.rate_limit_retry_config,
+        )
+
+        return prepare_object_response(
+            response_model=self.RESPONSE_MODEL,
+            data=get_response_data(response=api_response, key=self.ROOT_NAME),
+        )
+
+    def clone(
+        self,
+        resource_id: str,
+        timeout: Optional[httpx.Timeout] = DEFAULT_TIMEOUT,
+    ) -> QuoteVersionResponse:
+        """Copy a version into a new draft version of the same quote."""
+        api_response: Response = send_post_request(
+            url=make_url(
+                origin=self.base_url,
+                path_parts=(self.API_RESOURCE, resource_id, "clone"),
+            ),
+            headers=make_headers(api_key=self.api_key),
+            timeout=timeout,
+            rate_limit_retry_config=self.rate_limit_retry_config,
+        )
+
+        return prepare_object_response(
+            response_model=self.RESPONSE_MODEL,
+            data=get_response_data(response=api_response, key=self.ROOT_NAME),
+        )