cloudbeds-fiscal-document 1.12.0__py3-none-any.whl → 1.14.0__py3-none-any.whl

cloudbeds_fiscal_document/models/create_simple_receipt_request.py

@@ -20,6 +20,7 @@ import json
 from pydantic import BaseModel, ConfigDict, Field, StrictInt
 from typing import Any, ClassVar, Dict, List, Optional
 from typing_extensions import Annotated
+from cloudbeds_fiscal_document.models.manual_recipient_request import ManualRecipientRequest
 from cloudbeds_fiscal_document.models.recipient_request import RecipientRequest
 from cloudbeds_fiscal_document.models.source_kind import SourceKind
 from typing import Optional, Set
@@ -35,7 +36,8 @@ class CreateSimpleReceiptRequest(BaseModel):
     source_id: Annotated[int, Field(strict=True, ge=1)] = Field(alias="sourceId")
     source_kind: SourceKind = Field(alias="sourceKind")
     recipient: RecipientRequest
-    __properties: ClassVar[List[str]] = ["transactionIds", "sequenceId", "userId", "sourceId", "sourceKind", "recipient"]
+    manual_recipient: Optional[ManualRecipientRequest] = Field(default=None, alias="manualRecipient")
+    __properties: ClassVar[List[str]] = ["transactionIds", "sequenceId", "userId", "sourceId", "sourceKind", "recipient", "manualRecipient"]
 
     model_config = ConfigDict(
         populate_by_name=True,
@@ -79,6 +81,9 @@ class CreateSimpleReceiptRequest(BaseModel):
         # override the default output from pydantic by calling `to_dict()` of recipient
         if self.recipient:
             _dict['recipient'] = self.recipient.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of manual_recipient
+        if self.manual_recipient:
+            _dict['manualRecipient'] = self.manual_recipient.to_dict()
         # set to None if sequence_id (nullable) is None
         # and model_fields_set contains the field
         if self.sequence_id is None and "sequence_id" in self.model_fields_set:
@@ -101,7 +106,8 @@ class CreateSimpleReceiptRequest(BaseModel):
             "userId": obj.get("userId"),
             "sourceId": obj.get("sourceId"),
             "sourceKind": obj.get("sourceKind"),
-            "recipient": RecipientRequest.from_dict(obj["recipient"]) if obj.get("recipient") is not None else None
+            "recipient": RecipientRequest.from_dict(obj["recipient"]) if obj.get("recipient") is not None else None,
+            "manualRecipient": ManualRecipientRequest.from_dict(obj["manualRecipient"]) if obj.get("manualRecipient") is not None else None
         })
         return _obj
 

cloudbeds_fiscal_document/models/get_folio_export_request.py

@@ -0,0 +1,111 @@
+# coding: utf-8
+
+"""
+    Fiscal document service API
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from datetime import date
+from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictInt
+from typing import Any, ClassVar, Dict, List, Optional
+from cloudbeds_fiscal_document.models.source_kind import SourceKind
+from typing import Optional, Set
+from typing_extensions import Self
+
+class GetFolioExportRequest(BaseModel):
+    """
+    GetFolioExportRequest
+    """ # noqa: E501
+    folio_ids: List[StrictInt] = Field(description="Include transactions from the specified folio IDs", alias="folioIds")
+    source_kind: SourceKind = Field(alias="sourceKind")
+    source_id: StrictInt = Field(description="source ID of folio", alias="sourceId")
+    credit_debit_view: Optional[StrictBool] = Field(default=None, description="Should transactions be separated into debit/credits", alias="creditDebitView")
+    revenue_compact: Optional[StrictBool] = Field(default=None, description="Compact revenue transactions, valid only for sourceKind = RESERVATION", alias="revenueCompact")
+    date_from: Optional[date] = Field(default=None, description="Minimum date, only for sourceKind = HOUSE_ACCOUNT", alias="dateFrom")
+    date_to: Optional[date] = Field(default=None, description="Maximum date, only for sourceKind = HOUSE_ACCOUNT, optional", alias="dateTo")
+    __properties: ClassVar[List[str]] = ["folioIds", "sourceKind", "sourceId", "creditDebitView", "revenueCompact", "dateFrom", "dateTo"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of GetFolioExportRequest from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # set to None if date_from (nullable) is None
+        # and model_fields_set contains the field
+        if self.date_from is None and "date_from" in self.model_fields_set:
+            _dict['dateFrom'] = None
+
+        # set to None if date_to (nullable) is None
+        # and model_fields_set contains the field
+        if self.date_to is None and "date_to" in self.model_fields_set:
+            _dict['dateTo'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of GetFolioExportRequest from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "folioIds": obj.get("folioIds"),
+            "sourceKind": obj.get("sourceKind"),
+            "sourceId": obj.get("sourceId"),
+            "creditDebitView": obj.get("creditDebitView"),
+            "revenueCompact": obj.get("revenueCompact"),
+            "dateFrom": obj.get("dateFrom"),
+            "dateTo": obj.get("dateTo")
+        })
+        return _obj
+
+

cloudbeds_fiscal_document/models/get_invoice_preview_request.py

@@ -17,9 +17,11 @@ import pprint
 import re  # noqa: F401
 import json
 
+from datetime import date
 from pydantic import BaseModel, ConfigDict, Field, StrictBool
 from typing import Any, ClassVar, Dict, List, Optional
 from typing_extensions import Annotated
+from cloudbeds_fiscal_document.models.manual_recipient_request import ManualRecipientRequest
 from cloudbeds_fiscal_document.models.recipient_request import RecipientRequest
 from cloudbeds_fiscal_document.models.source_kind import SourceKind
 from typing import Optional, Set
@@ -34,12 +36,14 @@ class GetInvoicePreviewRequest(BaseModel):
     sequence_id: Optional[Annotated[int, Field(strict=True, ge=1)]] = Field(default=None, alias="sequenceId")
     source_kind: SourceKind = Field(alias="sourceKind")
     user_id: Optional[Annotated[int, Field(strict=True, ge=0)]] = Field(default=None, alias="userId")
-    recipient: RecipientRequest
+    recipient: Optional[RecipientRequest] = None
+    manual_recipient: Optional[ManualRecipientRequest] = Field(default=None, alias="manualRecipient")
     folio_ids: Optional[List[Annotated[int, Field(strict=True, ge=1)]]] = Field(default=None, description="Include all transactions from the specified folio IDs", alias="folioIds")
     exclude_transaction_ids: Optional[List[Annotated[int, Field(strict=True, ge=1)]]] = Field(default=None, description="Exclude transactions with the specified IDs", alias="excludeTransactionIds")
     include_transaction_ids: Optional[List[Annotated[int, Field(strict=True, ge=1)]]] = Field(default=None, description="Include transactions with the specified IDs", alias="includeTransactionIds")
     simplified: Optional[StrictBool] = False
-    __properties: ClassVar[List[str]] = ["transactionIds", "sourceId", "sequenceId", "sourceKind", "userId", "recipient", "folioIds", "excludeTransactionIds", "includeTransactionIds", "simplified"]
+    due_date_property_timezone: Optional[date] = Field(default=None, alias="dueDatePropertyTimezone")
+    __properties: ClassVar[List[str]] = ["transactionIds", "sourceId", "sequenceId", "sourceKind", "userId", "recipient", "manualRecipient", "folioIds", "excludeTransactionIds", "includeTransactionIds", "simplified", "dueDatePropertyTimezone"]
 
     model_config = ConfigDict(
         populate_by_name=True,
@@ -83,6 +87,9 @@ class GetInvoicePreviewRequest(BaseModel):
         # override the default output from pydantic by calling `to_dict()` of recipient
         if self.recipient:
             _dict['recipient'] = self.recipient.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of manual_recipient
+        if self.manual_recipient:
+            _dict['manualRecipient'] = self.manual_recipient.to_dict()
         # set to None if sequence_id (nullable) is None
         # and model_fields_set contains the field
         if self.sequence_id is None and "sequence_id" in self.model_fields_set:
@@ -111,10 +118,12 @@ class GetInvoicePreviewRequest(BaseModel):
             "sourceKind": obj.get("sourceKind"),
             "userId": obj.get("userId"),
             "recipient": RecipientRequest.from_dict(obj["recipient"]) if obj.get("recipient") is not None else None,
+            "manualRecipient": ManualRecipientRequest.from_dict(obj["manualRecipient"]) if obj.get("manualRecipient") is not None else None,
             "folioIds": obj.get("folioIds"),
             "excludeTransactionIds": obj.get("excludeTransactionIds"),
             "includeTransactionIds": obj.get("includeTransactionIds"),
-            "simplified": obj.get("simplified") if obj.get("simplified") is not None else False
+            "simplified": obj.get("simplified") if obj.get("simplified") is not None else False,
+            "dueDatePropertyTimezone": obj.get("dueDatePropertyTimezone")
         })
         return _obj
 

cloudbeds_fiscal_document/models/government_integration.py

@@ -17,8 +17,8 @@ import pprint
 import re  # noqa: F401
 import json
 
-from pydantic import BaseModel, ConfigDict, Field, StrictStr
-from typing import Any, ClassVar, Dict, List, Optional
+from pydantic import BaseModel, ConfigDict, Field, StrictBool, StrictBytes, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional, Union
 from cloudbeds_fiscal_document.models.fiscal_document_status import FiscalDocumentStatus
 from cloudbeds_fiscal_document.models.government_integration_qr import GovernmentIntegrationQr
 from typing import Optional, Set
@@ -37,7 +37,9 @@ class GovernmentIntegration(BaseModel):
     external_id: Optional[StrictStr] = Field(default=None, alias="externalId")
     rectifying_invoice_type: Optional[StrictStr] = Field(default=None, alias="rectifyingInvoiceType")
     cancellation_failed_fallback_status: Optional[FiscalDocumentStatus] = Field(default=None, alias="cancellationFailedFallbackStatus")
-    __properties: ClassVar[List[str]] = ["number", "series", "status", "qr", "url", "officialId", "externalId", "rectifyingInvoiceType", "cancellationFailedFallbackStatus"]
+    pdf_file_base64: Optional[Union[StrictBytes, StrictStr]] = Field(default=None, description="Base64-encoded PDF file content. Only allowed when status is COMPLETED_INTEGRATION.", alias="pdfFileBase64")
+    handwritten: Optional[StrictBool] = Field(default=None, description="Indicates this is a handwritten receipt created during POS unavailability.")
+    __properties: ClassVar[List[str]] = ["number", "series", "status", "qr", "url", "officialId", "externalId", "rectifyingInvoiceType", "cancellationFailedFallbackStatus", "pdfFileBase64", "handwritten"]
 
     model_config = ConfigDict(
         populate_by_name=True,
@@ -101,7 +103,9 @@ class GovernmentIntegration(BaseModel):
             "officialId": obj.get("officialId"),
             "externalId": obj.get("externalId"),
             "rectifyingInvoiceType": obj.get("rectifyingInvoiceType"),
-            "cancellationFailedFallbackStatus": obj.get("cancellationFailedFallbackStatus")
+            "cancellationFailedFallbackStatus": obj.get("cancellationFailedFallbackStatus"),
+            "pdfFileBase64": obj.get("pdfFileBase64"),
+            "handwritten": obj.get("handwritten")
         })
         return _obj
 

cloudbeds_fiscal_document/models/guest_document_type.py

@@ -0,0 +1,41 @@
+# coding: utf-8
+
+"""
+    Fiscal document service API
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class GuestDocumentType(str, Enum):
+    """
+    Type of guest identification document
+    """
+
+    """
+    allowed enum values
+    """
+    NA = 'na'
+    DRIVER_LICENCE = 'driver_licence'
+    STUDENT_ID = 'student_id'
+    PASSPORT = 'passport'
+    DNI = 'dni'
+    NIE = 'nie'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of GuestDocumentType from a JSON string"""
+        return cls(json.loads(json_str))
+
+

cloudbeds_fiscal_document/models/guest_gender.py

@@ -0,0 +1,38 @@
+# coding: utf-8
+
+"""
+    Fiscal document service API
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import json
+from enum import Enum
+from typing_extensions import Self
+
+
+class GuestGender(str, Enum):
+    """
+    Gender of the guest
+    """
+
+    """
+    allowed enum values
+    """
+    M = 'M'
+    F = 'F'
+    N_SLASH_A = 'N/A'
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Self:
+        """Create an instance of GuestGender from a JSON string"""
+        return cls(json.loads(json_str))
+
+

cloudbeds_fiscal_document/models/manual_recipient_request.py

@@ -0,0 +1,162 @@
+# coding: utf-8
+
+"""
+    Fiscal document service API
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from datetime import date
+from pydantic import BaseModel, ConfigDict, Field, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Optional
+from cloudbeds_fiscal_document.models.guest_gender import GuestGender
+from cloudbeds_fiscal_document.models.manual_recipient_request_address import ManualRecipientRequestAddress
+from cloudbeds_fiscal_document.models.manual_recipient_request_document import ManualRecipientRequestDocument
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ManualRecipientRequest(BaseModel):
+    """
+    ManualRecipientRequest
+    """ # noqa: E501
+    type: StrictStr = Field(description="Type of recipient (person or company)")
+    name: Optional[StrictStr] = Field(description="Name of the recipient")
+    gender: Optional[GuestGender] = None
+    email: Optional[StrictStr] = Field(default=None, description="Email address of the recipient")
+    birthday: Optional[date] = Field(default=None, description="Birthday of the recipient")
+    phone: Optional[StrictStr] = Field(default=None, description="Phone number")
+    cell_phone: Optional[StrictStr] = Field(default=None, description="Cell phone number", alias="cellPhone")
+    tax_id: Optional[StrictStr] = Field(description="Tax ID / VAT number", alias="taxId")
+    address: Optional[ManualRecipientRequestAddress] = None
+    document: Optional[ManualRecipientRequestDocument] = None
+    __properties: ClassVar[List[str]] = ["type", "name", "gender", "email", "birthday", "phone", "cellPhone", "taxId", "address", "document"]
+
+    @field_validator('type')
+    def type_validate_enum(cls, value):
+        """Validates the enum"""
+        if value not in set(['PERSON', 'COMPANY']):
+            raise ValueError("must be one of enum values ('PERSON', 'COMPANY')")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ManualRecipientRequest from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of address
+        if self.address:
+            _dict['address'] = self.address.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of document
+        if self.document:
+            _dict['document'] = self.document.to_dict()
+        # set to None if name (nullable) is None
+        # and model_fields_set contains the field
+        if self.name is None and "name" in self.model_fields_set:
+            _dict['name'] = None
+
+        # set to None if email (nullable) is None
+        # and model_fields_set contains the field
+        if self.email is None and "email" in self.model_fields_set:
+            _dict['email'] = None
+
+        # set to None if birthday (nullable) is None
+        # and model_fields_set contains the field
+        if self.birthday is None and "birthday" in self.model_fields_set:
+            _dict['birthday'] = None
+
+        # set to None if phone (nullable) is None
+        # and model_fields_set contains the field
+        if self.phone is None and "phone" in self.model_fields_set:
+            _dict['phone'] = None
+
+        # set to None if cell_phone (nullable) is None
+        # and model_fields_set contains the field
+        if self.cell_phone is None and "cell_phone" in self.model_fields_set:
+            _dict['cellPhone'] = None
+
+        # set to None if tax_id (nullable) is None
+        # and model_fields_set contains the field
+        if self.tax_id is None and "tax_id" in self.model_fields_set:
+            _dict['taxId'] = None
+
+        # set to None if address (nullable) is None
+        # and model_fields_set contains the field
+        if self.address is None and "address" in self.model_fields_set:
+            _dict['address'] = None
+
+        # set to None if document (nullable) is None
+        # and model_fields_set contains the field
+        if self.document is None and "document" in self.model_fields_set:
+            _dict['document'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ManualRecipientRequest from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "type": obj.get("type"),
+            "name": obj.get("name"),
+            "gender": obj.get("gender"),
+            "email": obj.get("email"),
+            "birthday": obj.get("birthday"),
+            "phone": obj.get("phone"),
+            "cellPhone": obj.get("cellPhone"),
+            "taxId": obj.get("taxId"),
+            "address": ManualRecipientRequestAddress.from_dict(obj["address"]) if obj.get("address") is not None else None,
+            "document": ManualRecipientRequestDocument.from_dict(obj["document"]) if obj.get("document") is not None else None
+        })
+        return _obj
+
+

cloudbeds_fiscal_document/models/manual_recipient_request_address.py

@@ -0,0 +1,127 @@
+# coding: utf-8
+
+"""
+    Fiscal document service API
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
+from typing import Any, ClassVar, Dict, List, Optional
+from typing import Optional, Set
+from typing_extensions import Self
+
+class ManualRecipientRequestAddress(BaseModel):
+    """
+    ManualRecipientRequestAddress
+    """ # noqa: E501
+    country: Optional[StrictStr] = Field(default=None, description="Country code")
+    state: Optional[StrictStr] = Field(default=None, description="State or province")
+    city: Optional[StrictStr] = Field(default=None, description="City")
+    address1: Optional[StrictStr] = Field(default=None, description="Primary street address")
+    address2: Optional[StrictStr] = Field(default=None, description="Secondary street address")
+    zip: Optional[StrictStr] = Field(default=None, description="Zip/postal code")
+    __properties: ClassVar[List[str]] = ["country", "state", "city", "address1", "address2", "zip"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of ManualRecipientRequestAddress from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # set to None if country (nullable) is None
+        # and model_fields_set contains the field
+        if self.country is None and "country" in self.model_fields_set:
+            _dict['country'] = None
+
+        # set to None if state (nullable) is None
+        # and model_fields_set contains the field
+        if self.state is None and "state" in self.model_fields_set:
+            _dict['state'] = None
+
+        # set to None if city (nullable) is None
+        # and model_fields_set contains the field
+        if self.city is None and "city" in self.model_fields_set:
+            _dict['city'] = None
+
+        # set to None if address1 (nullable) is None
+        # and model_fields_set contains the field
+        if self.address1 is None and "address1" in self.model_fields_set:
+            _dict['address1'] = None
+
+        # set to None if address2 (nullable) is None
+        # and model_fields_set contains the field
+        if self.address2 is None and "address2" in self.model_fields_set:
+            _dict['address2'] = None
+
+        # set to None if zip (nullable) is None
+        # and model_fields_set contains the field
+        if self.zip is None and "zip" in self.model_fields_set:
+            _dict['zip'] = None
+
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of ManualRecipientRequestAddress from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "country": obj.get("country"),
+            "state": obj.get("state"),
+            "city": obj.get("city"),
+            "address1": obj.get("address1"),
+            "address2": obj.get("address2"),
+            "zip": obj.get("zip")
+        })
+        return _obj
+
+