# coding: utf-8
"""
LUSID API
FINBOURNE Technology # noqa: E501
Contact: info@finbourne.com
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.
"""
from __future__ import annotations
import pprint
import re # noqa: F401
import json
from typing import List, Dict, Optional, Any, Union, TYPE_CHECKING
from typing_extensions import Annotated
from pydantic.v1 import BaseModel, StrictStr, StrictInt, StrictBool, StrictFloat, StrictBytes, Field, validator, ValidationError, conlist, constr
from datetime import datetime
from lusid.models.currency_and_amount import CurrencyAndAmount
from lusid.models.custodian_account import CustodianAccount
from lusid.models.data_model_membership import DataModelMembership
from lusid.models.otc_confirmation import OtcConfirmation
from lusid.models.perpetual_property import PerpetualProperty
from lusid.models.resource_id import ResourceId
from lusid.models.staged_modifications_info import StagedModificationsInfo
from lusid.models.strategy import Strategy
from lusid.models.transaction_price import TransactionPrice
from lusid.models.transaction_type_details import TransactionTypeDetails
from lusid.models.version import Version
[docs]
class Transaction(BaseModel):
"""
A list of transactions. # noqa: E501
"""
transaction_id: StrictStr = Field(...,alias="transactionId", description="The unique identifier for the transaction.")
type: StrictStr = Field(...,alias="type", description="The type of the transaction e.g. 'Buy', 'Sell'. The transaction type should have been pre-configured via the System Configuration API endpoint.")
instrument_identifiers: Optional[Dict[str, Optional[StrictStr]]] = Field(default=None, description="A set of instrument identifiers that can resolve the transaction to a unique instrument.", alias="instrumentIdentifiers")
instrument_scope: Optional[StrictStr] = Field(None,alias="instrumentScope", description="The scope in which the transaction's instrument lies.")
instrument_uid: StrictStr = Field(...,alias="instrumentUid", description="The unique Lusid Instrument Id (LUID) of the instrument that the transaction is in.")
transaction_date: datetime = Field(description="The date of the transaction.", alias="transactionDate")
settlement_date: datetime = Field(description="The settlement date of the transaction.", alias="settlementDate")
units: Union[StrictFloat, StrictInt] = Field(description="The number of units transacted in the associated instrument.")
transaction_price: Optional[TransactionPrice] = Field(default=None, alias="transactionPrice")
total_consideration: CurrencyAndAmount = Field(alias="totalConsideration")
exchange_rate: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, description="The exchange rate between the transaction and settlement currency (settlement currency being represented by the TotalConsideration.Currency). For example if the transaction currency is in USD and the settlement currency is in GBP this this the USD/GBP rate.", alias="exchangeRate")
transaction_currency: Optional[StrictStr] = Field(None,alias="transactionCurrency", description="The transaction currency.")
properties: Optional[Dict[str, PerpetualProperty]] = Field(default=None, description="Set of unique transaction properties and associated values to stored with the transaction. Each property will be from the 'Transaction' domain.")
counterparty_id: Optional[StrictStr] = Field(None,alias="counterpartyId", description="The identifier for the counterparty of the transaction.")
source: Optional[StrictStr] = Field(None,alias="source", description="The source of the transaction. This is used to look up the appropriate transaction group set in the transaction type configuration.")
entry_date_time: Optional[datetime] = Field(default=None, description="The asAt datetime that the transaction was added to LUSID.", alias="entryDateTime")
otc_confirmation: Optional[OtcConfirmation] = Field(default=None, alias="otcConfirmation")
transaction_status: Optional[StrictStr] = Field(None,alias="transactionStatus", description="The status of the transaction. Available values: Active, Amended, Cancelled, ActiveReversal, ActiveTrueUp, CancelledTrueUp.")
cancel_date_time: Optional[datetime] = Field(default=None, description="If the transaction has been cancelled, the asAt datetime that the transaction was cancelled.", alias="cancelDateTime")
order_id: Optional[ResourceId] = Field(default=None, alias="orderId")
allocation_id: Optional[ResourceId] = Field(default=None, alias="allocationId")
custodian_account: Optional[CustodianAccount] = Field(default=None, alias="custodianAccount")
transaction_group_id: Optional[StrictStr] = Field(None,alias="transactionGroupId", description="The identifier for grouping economic events across multiple transactions")
strategy_tag: Optional[List[Strategy]] = Field(default=None, description="A list of strategies representing the allocation of units across multiple sub-holding keys", alias="strategyTag")
resolved_transaction_type_details: Optional[TransactionTypeDetails] = Field(default=None, alias="resolvedTransactionTypeDetails")
data_model_membership: Optional[DataModelMembership] = Field(default=None, alias="dataModelMembership")
version: Optional[Version] = None
staged_modifications: Optional[StagedModificationsInfo] = Field(default=None, alias="stagedModifications")
__properties = ["transactionId", "type", "instrumentIdentifiers", "instrumentScope", "instrumentUid", "transactionDate", "settlementDate", "units", "transactionPrice", "totalConsideration", "exchangeRate", "transactionCurrency", "properties", "counterpartyId", "source", "entryDateTime", "otcConfirmation", "transactionStatus", "cancelDateTime", "orderId", "allocationId", "custodianAccount", "transactionGroupId", "strategyTag", "resolvedTransactionTypeDetails", "dataModelMembership", "version", "stagedModifications"]
[docs]
@validator('transaction_status')
def transaction_status_validate_enum(cls, value):
"""Validates the enum"""
# Finbourne have removed enum validation on all models, except for this use case:
# Workflow and notification application SDK use the property name 'type' as the discriminator on a number of classes.
# During instantiation, the value of 'type' is checked against the enum values,
# check it's a class that uses the 'type' property as a discriminator
# list of classes can be found by searching for 'actual_instance: Union[' in the generated code
if 'Transaction' not in [
# For notification application classes
'AmazonSqsNotificationType',
'AmazonSqsNotificationTypeResponse',
'AmazonSqsPrincipalAuthNotificationType',
'AmazonSqsPrincipalAuthNotificationTypeResponse',
'AzureServiceBusTypeResponse',
'AzureServiceBusNotificationType',
'EmailNotificationType',
'EmailNotificationTypeResponse',
'SmsNotificationType',
'SmsNotificationTypeResponse',
'WebhookNotificationType',
'WebhookNotificationTypeResponse',
# For workflow application classes
'CreateChildTasksAction',
'RunWorkerAction',
'TriggerParentTaskAction',
'CreateChildTasksActionResponse',
'RunWorkerActionResponse',
'TriggerChildTasksAction',
'TriggerChildTasksActionResponse',
'TriggerParentTaskActionResponse',
'CreateNewTaskActivity',
'UpdateMatchingTasksActivity',
'CreateNewTaskActivityResponse',
'UpdateMatchingTasksActivityResponse',
'Fail',
'GroupReconciliation',
'HealthCheck',
'LuminesceView',
'SchedulerJob',
'Sleep',
'FailResponse',
'GroupReconciliationResponse',
'HealthCheckResponse',
'LuminesceViewResponse',
'SchedulerJobResponse',
'SleepResponse',
'Library',
'LibraryResponse',
'DayRegularity',
'RelativeMonthRegularity',
'SpecificMonthRegularity',
'WeekRegularity',
'YearRegularity',
'LusidEntityDataQualityCheck',
'LusidEntityDataQualityCheckResponse',
'TriggerChildTasksActionResponse']:
return value
# Only validate the 'type' property of the class
if "transaction_status" != "type":
return value
if value is None:
return value
if value not in ['Active', 'Amended', 'Cancelled', 'ActiveReversal', 'ActiveTrueUp', 'CancelledTrueUp']:
raise ValueError("must be one of enum values ('Active', 'Amended', 'Cancelled', 'ActiveReversal', 'ActiveTrueUp', 'CancelledTrueUp')")
return value
[docs]
class Config:
"""Pydantic configuration"""
allow_population_by_field_name = True
validate_assignment = True
def __str__(self):
"""For `print` and `pprint`"""
return pprint.pformat(self.dict(by_alias=False))
def __repr__(self):
"""For `print` and `pprint`"""
return self.to_str()
[docs]
def to_str(self) -> str:
"""Returns the string representation of the model using alias"""
return pprint.pformat(self.dict(by_alias=True))
[docs]
def to_json(self) -> str:
"""Returns the JSON representation of the model using alias"""
return json.dumps(self.to_dict())
[docs]
@classmethod
def from_json(cls, json_str: str) -> Transaction:
"""Create an instance of Transaction from a JSON string"""
return cls.from_dict(json.loads(json_str))
[docs]
def to_dict(self):
"""Returns the dictionary representation of the model using alias"""
_dict = self.dict(by_alias=True,
exclude={
},
exclude_none=True)
# override the default output from pydantic by calling `to_dict()` of transaction_price
if self.transaction_price:
_dict['transactionPrice'] = self.transaction_price.to_dict()
# override the default output from pydantic by calling `to_dict()` of total_consideration
if self.total_consideration:
_dict['totalConsideration'] = self.total_consideration.to_dict()
# override the default output from pydantic by calling `to_dict()` of each value in properties (dict)
_field_dict = {}
if self.properties:
for _key in self.properties:
if self.properties[_key]:
_field_dict[_key] = self.properties[_key].to_dict()
_dict['properties'] = _field_dict
# override the default output from pydantic by calling `to_dict()` of otc_confirmation
if self.otc_confirmation:
_dict['otcConfirmation'] = self.otc_confirmation.to_dict()
# override the default output from pydantic by calling `to_dict()` of order_id
if self.order_id:
_dict['orderId'] = self.order_id.to_dict()
# override the default output from pydantic by calling `to_dict()` of allocation_id
if self.allocation_id:
_dict['allocationId'] = self.allocation_id.to_dict()
# override the default output from pydantic by calling `to_dict()` of custodian_account
if self.custodian_account:
_dict['custodianAccount'] = self.custodian_account.to_dict()
# override the default output from pydantic by calling `to_dict()` of each item in strategy_tag (list)
_items = []
if self.strategy_tag:
for _item in self.strategy_tag:
if _item:
_items.append(_item.to_dict())
_dict['strategyTag'] = _items
# override the default output from pydantic by calling `to_dict()` of resolved_transaction_type_details
if self.resolved_transaction_type_details:
_dict['resolvedTransactionTypeDetails'] = self.resolved_transaction_type_details.to_dict()
# override the default output from pydantic by calling `to_dict()` of data_model_membership
if self.data_model_membership:
_dict['dataModelMembership'] = self.data_model_membership.to_dict()
# override the default output from pydantic by calling `to_dict()` of version
if self.version:
_dict['version'] = self.version.to_dict()
# override the default output from pydantic by calling `to_dict()` of staged_modifications
if self.staged_modifications:
_dict['stagedModifications'] = self.staged_modifications.to_dict()
# set to None if instrument_identifiers (nullable) is None
# and __fields_set__ contains the field
if self.instrument_identifiers is None and "instrument_identifiers" in self.__fields_set__:
_dict['instrumentIdentifiers'] = None
# set to None if instrument_scope (nullable) is None
# and __fields_set__ contains the field
if self.instrument_scope is None and "instrument_scope" in self.__fields_set__:
_dict['instrumentScope'] = None
# set to None if exchange_rate (nullable) is None
# and __fields_set__ contains the field
if self.exchange_rate is None and "exchange_rate" in self.__fields_set__:
_dict['exchangeRate'] = None
# set to None if transaction_currency (nullable) is None
# and __fields_set__ contains the field
if self.transaction_currency is None and "transaction_currency" in self.__fields_set__:
_dict['transactionCurrency'] = None
# set to None if properties (nullable) is None
# and __fields_set__ contains the field
if self.properties is None and "properties" in self.__fields_set__:
_dict['properties'] = None
# set to None if counterparty_id (nullable) is None
# and __fields_set__ contains the field
if self.counterparty_id is None and "counterparty_id" in self.__fields_set__:
_dict['counterpartyId'] = None
# set to None if source (nullable) is None
# and __fields_set__ contains the field
if self.source is None and "source" in self.__fields_set__:
_dict['source'] = None
# set to None if cancel_date_time (nullable) is None
# and __fields_set__ contains the field
if self.cancel_date_time is None and "cancel_date_time" in self.__fields_set__:
_dict['cancelDateTime'] = None
# set to None if transaction_group_id (nullable) is None
# and __fields_set__ contains the field
if self.transaction_group_id is None and "transaction_group_id" in self.__fields_set__:
_dict['transactionGroupId'] = None
# set to None if strategy_tag (nullable) is None
# and __fields_set__ contains the field
if self.strategy_tag is None and "strategy_tag" in self.__fields_set__:
_dict['strategyTag'] = None
return _dict
[docs]
@classmethod
def from_dict(cls, obj: dict) -> Transaction:
"""Create an instance of Transaction from a dict"""
if obj is None:
return None
if not isinstance(obj, dict):
return Transaction.parse_obj(obj)
_obj = Transaction.parse_obj({
"transaction_id": obj.get("transactionId"),
"type": obj.get("type"),
"instrument_identifiers": obj.get("instrumentIdentifiers"),
"instrument_scope": obj.get("instrumentScope"),
"instrument_uid": obj.get("instrumentUid"),
"transaction_date": obj.get("transactionDate"),
"settlement_date": obj.get("settlementDate"),
"units": obj.get("units"),
"transaction_price": TransactionPrice.from_dict(obj.get("transactionPrice")) if obj.get("transactionPrice") is not None else None,
"total_consideration": CurrencyAndAmount.from_dict(obj.get("totalConsideration")) if obj.get("totalConsideration") is not None else None,
"exchange_rate": obj.get("exchangeRate"),
"transaction_currency": obj.get("transactionCurrency"),
"properties": dict(
(_k, PerpetualProperty.from_dict(_v))
for _k, _v in obj.get("properties").items()
)
if obj.get("properties") is not None
else None,
"counterparty_id": obj.get("counterpartyId"),
"source": obj.get("source"),
"entry_date_time": obj.get("entryDateTime"),
"otc_confirmation": OtcConfirmation.from_dict(obj.get("otcConfirmation")) if obj.get("otcConfirmation") is not None else None,
"transaction_status": obj.get("transactionStatus"),
"cancel_date_time": obj.get("cancelDateTime"),
"order_id": ResourceId.from_dict(obj.get("orderId")) if obj.get("orderId") is not None else None,
"allocation_id": ResourceId.from_dict(obj.get("allocationId")) if obj.get("allocationId") is not None else None,
"custodian_account": CustodianAccount.from_dict(obj.get("custodianAccount")) if obj.get("custodianAccount") is not None else None,
"transaction_group_id": obj.get("transactionGroupId"),
"strategy_tag": [Strategy.from_dict(_item) for _item in obj.get("strategyTag")] if obj.get("strategyTag") is not None else None,
"resolved_transaction_type_details": TransactionTypeDetails.from_dict(obj.get("resolvedTransactionTypeDetails")) if obj.get("resolvedTransactionTypeDetails") is not None else None,
"data_model_membership": DataModelMembership.from_dict(obj.get("dataModelMembership")) if obj.get("dataModelMembership") is not None else None,
"version": Version.from_dict(obj.get("version")) if obj.get("version") is not None else None,
"staged_modifications": StagedModificationsInfo.from_dict(obj.get("stagedModifications")) if obj.get("stagedModifications") is not None else None
})
return _obj
Transaction.update_forward_refs()