lago-python-client 1.50.0__tar.gz → 1.53.0__tar.gz

{lago_python_client-1.50.0 → lago_python_client-1.53.0}/PKG-INFO

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

{lago_python_client-1.50.0 → lago_python_client-1.53.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
@@ -76,7 +80,7 @@ class Client:
 
     @property
     def base_api_url(self) -> str:
-        return urljoin(self.api_url if self.api_url else Client.BASE_URL, Client.API_PATH)
+        return urljoin(self.api_url or Client.BASE_URL, Client.API_PATH)
 
     @property
     def base_ingest_api_url(self) -> str:
@@ -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.50.0 → lago_python_client-1.53.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.50.0 → lago_python_client-1.53.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,6 +249,33 @@ 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 .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.50.0 → lago_python_client-1.53.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]
@@ -52,7 +53,7 @@ class CreditNoteResponse(BaseResponseModel):
     balance_amount_cents: int
     refund_amount_cents: int
     offset_amount_cents: int
-    taxes_amount_cents: str
+    taxes_amount_cents: int
     taxes_rate: float
     sub_total_excluding_taxes_amount_cents: int
     coupons_adjustment_amount_cents: int
@@ -75,7 +76,12 @@ class Items(BaseModel):
 
 
 class CreditNote(BaseModel):
+    invoice_id: Optional[str]
     reason: Optional[str]
+    description: Optional[str]
+    credit_amount_cents: Optional[int]
+    refund_amount_cents: Optional[int]
+    offset_amount_cents: Optional[int]
     items: Optional[Items]
     metadata: Optional[Dict[str, Optional[str]]]
 
@@ -116,7 +122,7 @@ class CreditNoteEstimatedResponse(BaseResponseModel):
     max_creditable_amount_cents: int
     max_refundable_amount_cents: int
     max_offsettable_amount_cents: int
-    taxes_amount_cents: str
+    taxes_amount_cents: int
     taxes_rate: float
     sub_total_excluding_taxes_amount_cents: int
     coupons_adjustment_amount_cents: int

{lago_python_client-1.50.0 → lago_python_client-1.53.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.50.0 → lago_python_client-1.53.0}/lago_python_client/models/fee.py

@@ -7,7 +7,6 @@ from .invoice_item import InvoiceItemResponse
 
 class Fee(BaseModel):
     payment_status: Optional[str]
-    invoice_display_name: Optional[str]
 
 
 class FeeAppliedTax(BaseResponseModel):
@@ -46,18 +45,21 @@ class FeeResponse(BaseResponseModel):
     lago_invoice_id: Optional[str]
     lago_true_up_fee_id: Optional[str]
     lago_true_up_parent_fee_id: Optional[str]
+    lago_original_fee_id: Optional[str]
     external_subscription_id: Optional[str]
+    lago_customer_id: Optional[str]
+    external_customer_id: Optional[str]
     amount_cents: Optional[int]
     amount_currency: Optional[str]
     taxes_amount_cents: Optional[int]
     taxes_rate: Optional[float]
     total_amount_cents: Optional[int]
-    unit_amount_cents: Optional[int]  # deprecated
     precise_unit_amount: Optional[str]
     sub_total_excluding_taxes_amount_cents: Optional[int]
     sub_total_excluding_taxes_precise_amount_cents: Optional[str]
     precise_amount: Optional[str]
     precise_total_amount: Optional[str]
+    precise_coupons_amount_cents: Optional[str]
     taxes_precise_amount: Optional[str]
     total_amount_currency: Optional[str]
     units: Optional[str]
@@ -68,7 +70,8 @@ class FeeResponse(BaseResponseModel):
     description: Optional[str]
     pay_in_advance: Optional[bool]
     invoiceable: Optional[bool]
-    invoice_display_name: Optional[str]
+    self_billed: Optional[bool]
+    event_transaction_id: Optional[str]
     succeeded_at: Optional[str]
     failed_at: Optional[str]
     refunded_at: Optional[str]
@@ -77,7 +80,6 @@ class FeeResponse(BaseResponseModel):
     amount_details: Optional[Dict[str, Any]]
     pricing_unit_details: Optional[PricingUnitDetails]
     presentation_breakdowns: Optional[PresentationBreakdowns]
-    billing_entity_code: Optional[str]
 
     item: Optional[InvoiceItemResponse]
     applied_taxes: Optional[FeeAppliedTaxes]

{lago_python_client-1.50.0 → lago_python_client-1.53.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]
@@ -134,11 +136,17 @@ class InvoiceResponse(BaseResponseModel):
     sub_total_including_taxes_amount_cents: int
     total_amount_cents: int
     total_due_amount_cents: int
+    total_paid_amount_cents: Optional[int]
+    total_offsetted_credit_note_amount_cents: Optional[int]
     prepaid_credit_amount_cents: int
     prepaid_granted_credit_amount_cents: Optional[int]
     prepaid_purchased_credit_amount_cents: Optional[int]
+    self_billed: Optional[bool]
+    voided_at: Optional[str]
 
     file_url: Optional[str]
+    xml_url: Optional[str]
+    web_url: Optional[str]
     customer: Optional[CustomerResponse]
     billing_periods: Optional[BillingPeriodsResponse]
     subscriptions: Optional[SubscriptionsResponse]

lago_python_client-1.53.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.53.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.50.0 → lago_python_client-1.53.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.53.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.50.0 → lago_python_client-1.53.0}/lago_python_client/models/subscription.py

@@ -26,6 +26,7 @@ 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]]
 
 
@@ -75,6 +76,7 @@ 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]]

{lago_python_client-1.50.0 → lago_python_client-1.53.0}/lago_python_client/models/tax.py

@@ -24,6 +24,7 @@ class TaxResponse(BaseResponseModel):
     rate: float
     description: Optional[str]
     applied_to_organization: Optional[bool]
+    applied_to_billing_entities_codes: Optional[List[str]]
     created_at: str
 
 

{lago_python_client-1.50.0 → lago_python_client-1.53.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.50.0 → lago_python_client-1.53.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.50.0 → lago_python_client-1.53.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.53.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.53.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),
+        )