mss-python 0.1.0__tar.gz

mss_python-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Booking Südtirol
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mss_python-0.1.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.1
+Name: mss-python
+Version: 0.1.0
+Summary: MSS API wrapper for Python projects
+Home-page: https://github.com/bookingsuedtirol/mss-python
+Requires-Python: >=3.7, <4
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# mss-python
+
+MSS API client for Python projects
+
+<!-- ## Dependencies
+
+This library requires an IANA Time Zone database to be present on the operating system (because it uses https://pkg.go.dev/time#LoadLocation). This database comes pre-installed with many Linux distros. If it’s unavailable (such as on Windows), https://pkg.go.dev/time/tzdata can be imported in the main program (which uses mss-go) instead. -->
+
+## Available methods
+
+- [x] getHotelList 
+- [x] getHotelListByFilter
+- [x] getSpecialList 
+- [x] getRoomList
+- [x] getWidgetConfig 
+- [x] getBooking
+- [x] cancelBooking 
+- [x] prepareBooking 
+- [x] getAvailability 
+- [x] getRoomAvailability
+- [x] getDayAvailability
+- [x] getPriceList 
+- [x] createInquiry
+- [x] getLocationList 
+- [x] getThemeList
+- [x] getMasterpackagesList
+- [x] notifyMasterpackages
+- [x] getLastMinuteQuotation
+- [x] validateCoupon
+- [x] getHotelPictures
+- [x] getHotelPictureGroups
+- [x] getOptionalServices
+
+
+## Example Execution
+
+`cd ./examples/simple`
+
+`python3 main.py`
+
+or
+
+`python3 -m main`
+
+<!-- - 
+
+TODO
+
+- [x] getInquiry - how to find booking IDs?
+
+
+- [x] getUserSources 
+
+  -->
+
+<!-- Warning: Only the methods with a ✓ next to them have been tested so far.
+
+## Before running examples/tests
+
+Set the environment variables with:
+
+```Bash
+export $(make env)
+```
+
+## Examples
+
+Run `make simple` or `make advanced`
+
+## Tests
+
+Run `make test` -->

mss_python-0.1.0/README.md

@@ -0,0 +1,72 @@
+# mss-python
+
+MSS API client for Python projects
+
+<!-- ## Dependencies
+
+This library requires an IANA Time Zone database to be present on the operating system (because it uses https://pkg.go.dev/time#LoadLocation). This database comes pre-installed with many Linux distros. If it’s unavailable (such as on Windows), https://pkg.go.dev/time/tzdata can be imported in the main program (which uses mss-go) instead. -->
+
+## Available methods
+
+- [x] getHotelList 
+- [x] getHotelListByFilter
+- [x] getSpecialList 
+- [x] getRoomList
+- [x] getWidgetConfig 
+- [x] getBooking
+- [x] cancelBooking 
+- [x] prepareBooking 
+- [x] getAvailability 
+- [x] getRoomAvailability
+- [x] getDayAvailability
+- [x] getPriceList 
+- [x] createInquiry
+- [x] getLocationList 
+- [x] getThemeList
+- [x] getMasterpackagesList
+- [x] notifyMasterpackages
+- [x] getLastMinuteQuotation
+- [x] validateCoupon
+- [x] getHotelPictures
+- [x] getHotelPictureGroups
+- [x] getOptionalServices
+
+
+## Example Execution
+
+`cd ./examples/simple`
+
+`python3 main.py`
+
+or
+
+`python3 -m main`
+
+<!-- - 
+
+TODO
+
+- [x] getInquiry - how to find booking IDs?
+
+
+- [x] getUserSources 
+
+  -->
+
+<!-- Warning: Only the methods with a ✓ next to them have been tested so far.
+
+## Before running examples/tests
+
+Set the environment variables with:
+
+```Bash
+export $(make env)
+```
+
+## Examples
+
+Run `make simple` or `make advanced`
+
+## Tests
+
+Run `make test` -->

mss_python-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mss_python-0.1.0/setup.py

@@ -0,0 +1,170 @@
+"""A setuptools based setup module.
+
+See:
+https://packaging.python.org/guides/distributing-packages-using-setuptools/
+https://github.com/pypa/sampleproject
+"""
+
+# Always prefer setuptools over distutils
+from setuptools import setup, find_packages
+import pathlib
+
+here = pathlib.Path(__file__).parent.resolve()
+
+# Get the long description from the README file
+long_description = (here / "README.md").read_text(encoding="utf-8")
+
+# Arguments marked as "Required" below must be included for upload to PyPI.
+# Fields marked as "Optional" may be commented out.
+
+setup(
+    # This is the name of your project. The first time you publish this
+    # package, this name will be registered for you. It will determine how
+    # users can install this project, e.g.:
+    #
+    # $ pip install sampleproject
+    #
+    # And where it will live on PyPI: https://pypi.org/project/sampleproject/
+    #
+    # There are some restrictions on what makes a valid project name
+    # specification here:
+    # https://packaging.python.org/specifications/core-metadata/#name
+    name="mss-python",  # Required
+    # Versions should comply with PEP 440:
+    # https://www.python.org/dev/peps/pep-0440/
+    #
+    # For a discussion on single-sourcing the version across setup.py and the
+    # project code, see
+    # https://packaging.python.org/guides/single-sourcing-package-version/
+    version="0.1.0",  # Required
+    # This is a one-line description or tagline of what your project does. This
+    # corresponds to the "Summary" metadata field:
+    # https://packaging.python.org/specifications/core-metadata/#summary
+    description="MSS API wrapper for Python projects",  # Optional
+    # This is an optional longer description of your project that represents
+    # the body of text which users will see when they visit PyPI.
+    #
+    # Often, this is the same as your README, so you can just read it in from
+    # that file directly (as we have already done above)
+    #
+    # This field corresponds to the "Description" metadata field:
+    # https://packaging.python.org/specifications/core-metadata/#description-optional
+    long_description=long_description,  # Optional
+    # Denotes that our long_description is in Markdown; valid values are
+    # text/plain, text/x-rst, and text/markdown
+    #
+    # Optional if long_description is written in reStructuredText (rst) but
+    # required for plain-text or Markdown; if unspecified, "applications should
+    # attempt to render [the long_description] as text/x-rst; charset=UTF-8 and
+    # fall back to text/plain if it is not valid rst" (see link below)
+    #
+    # This field corresponds to the "Description-Content-Type" metadata field:
+    # https://packaging.python.org/specifications/core-metadata/#description-content-type-optional
+    long_description_content_type="text/markdown",  # Optional (see note above)
+    # This should be a valid link to your project's main homepage.
+    #
+    # This field corresponds to the "Home-Page" metadata field:
+    # https://packaging.python.org/specifications/core-metadata/#home-page-optional
+    url="https://github.com/bookingsuedtirol/mss-python",  # Optional
+    # This should be your name or the name of the organization which owns the
+    # project.
+    # author="Rubin",  # Optional
+    # This should be a valid email address corresponding to the author listed
+    # above.
+    # author_email="author@example.com",  # Optional
+    # Classifiers help users find your project by categorizing it.
+    #
+    # For a list of valid classifiers, see https://pypi.org/classifiers/
+    # classifiers=[  # Optional
+    #     # How mature is this project? Common values are
+    #     #   3 - Alpha
+    #     #   4 - Beta
+    #     #   5 - Production/Stable
+    #     "Development Status :: 3 - Alpha",
+    #     # Indicate who your project is intended for
+    #     "Intended Audience :: Developers",
+    #     "Topic :: Software Development :: Build Tools",
+    #     # Pick your license as you wish
+    #     "License :: OSI Approved :: MIT License",
+    #     # Specify the Python versions you support here. In particular, ensure
+    #     # that you indicate you support Python 3. These classifiers are *not*
+    #     # checked by 'pip install'. See instead 'python_requires' below.
+    #     "Programming Language :: Python :: 3",
+    #     "Programming Language :: Python :: 3.7",
+    #     "Programming Language :: Python :: 3.8",
+    #     "Programming Language :: Python :: 3.9",
+    #     "Programming Language :: Python :: 3.10",
+    #     "Programming Language :: Python :: 3 :: Only",
+    # ],
+    # This field adds keywords for your project which will appear on the
+    # project page. What does your project relate to?
+    #
+    # Note that this is a list of additional keywords, separated
+    # by commas, to be used to assist searching for the distribution in a
+    # larger catalog.
+    # keywords="sample, setuptools, development",  # Optional
+    # When your source code is in a subdirectory under the project root, e.g.
+    # `src/`, it is necessary to specify the `package_dir` argument.
+    package_dir={"": "src"},  # Optional
+    # You can just specify package directories manually here if your project is
+    # simple. Or you can use find_packages().
+    #
+    # Alternatively, if you just want to distribute a single Python file, use
+    # the `py_modules` argument instead as follows, which will expect a file
+    # called `my_module.py` to exist:
+    #
+    #   py_modules=["my_module"],
+    #
+    packages=find_packages(where="src"),  # Required
+    # Specify which Python versions you support. In contrast to the
+    # 'Programming Language' classifiers above, 'pip install' will check this
+    # and refuse to install the project if the version does not match. See
+    # https://packaging.python.org/guides/distributing-packages-using-setuptools/#python-requires
+    python_requires=">=3.7, <4",
+    # This field lists other packages that your project depends on to run.
+    # Any package you put here will be installed by pip when your project is
+    # installed, so they must be valid existing projects.
+    #
+    # For an analysis of "install_requires" vs pip's requirements files see:
+    # https://packaging.python.org/discussions/install-requires-vs-requirements/
+    # install_requires=["peppercorn"],  # Optional
+    # List additional groups of dependencies here (e.g. development
+    # dependencies). Users will be able to install these using the "extras"
+    # syntax, for example:
+    #
+    #   $ pip install sampleproject[dev]
+    #
+    # Similar to `install_requires` above, these must be valid existing
+    # projects.
+    # extras_require={  # Optional
+    #     "dev": ["check-manifest"],
+    #     "test": ["coverage"],
+    # },
+    # If there are data files included in your packages that need to be
+    # installed, specify them here.
+    # package_data={  # Optional
+    #     "sample": ["package_data.dat"],
+    # },
+    # Entry points. The following would provide a command called `sample` which
+    # executes the function `main` from this package when invoked:
+    # entry_points={  # Optional
+    #     "console_scripts": [
+    #         "sample=sample:main",
+    #     ],
+    # },
+    # List additional URLs that are relevant to your project as a dict.
+    #
+    # This field corresponds to the "Project-URL" metadata fields:
+    # https://packaging.python.org/specifications/core-metadata/#project-url-multiple-use
+    #
+    # Examples listed include a pattern for specifying where the package tracks
+    # issues, where the source is hosted, where to say thanks to the package
+    # maintainers, and where to support the project financially. The key is
+    # what's used to render the link text on PyPI.
+    # project_urls={  # Optional
+    #     "Bug Reports": "https://github.com/pypa/sampleproject/issues",
+    #     "Funding": "https://donate.pypi.org",
+    #     "Say Thanks!": "http://saythanks.io/to/example",
+    #     "Source": "https://github.com/pypa/sampleproject/",
+    # },
+)

mss_python-0.1.0/src/mss_python.egg-info/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.1
+Name: mss-python
+Version: 0.1.0
+Summary: MSS API wrapper for Python projects
+Home-page: https://github.com/bookingsuedtirol/mss-python
+Requires-Python: >=3.7, <4
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# mss-python
+
+MSS API client for Python projects
+
+<!-- ## Dependencies
+
+This library requires an IANA Time Zone database to be present on the operating system (because it uses https://pkg.go.dev/time#LoadLocation). This database comes pre-installed with many Linux distros. If it’s unavailable (such as on Windows), https://pkg.go.dev/time/tzdata can be imported in the main program (which uses mss-go) instead. -->
+
+## Available methods
+
+- [x] getHotelList 
+- [x] getHotelListByFilter
+- [x] getSpecialList 
+- [x] getRoomList
+- [x] getWidgetConfig 
+- [x] getBooking
+- [x] cancelBooking 
+- [x] prepareBooking 
+- [x] getAvailability 
+- [x] getRoomAvailability
+- [x] getDayAvailability
+- [x] getPriceList 
+- [x] createInquiry
+- [x] getLocationList 
+- [x] getThemeList
+- [x] getMasterpackagesList
+- [x] notifyMasterpackages
+- [x] getLastMinuteQuotation
+- [x] validateCoupon
+- [x] getHotelPictures
+- [x] getHotelPictureGroups
+- [x] getOptionalServices
+
+
+## Example Execution
+
+`cd ./examples/simple`
+
+`python3 main.py`
+
+or
+
+`python3 -m main`
+
+<!-- - 
+
+TODO
+
+- [x] getInquiry - how to find booking IDs?
+
+
+- [x] getUserSources 
+
+  -->
+
+<!-- Warning: Only the methods with a ✓ next to them have been tested so far.
+
+## Before running examples/tests
+
+Set the environment variables with:
+
+```Bash
+export $(make env)
+```
+
+## Examples
+
+Run `make simple` or `make advanced`
+
+## Tests
+
+Run `make test` -->

mss_python-0.1.0/src/mss_python.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+setup.py
+src/mss_python.egg-info/PKG-INFO
+src/mss_python.egg-info/SOURCES.txt
+src/mss_python.egg-info/dependency_links.txt
+src/mss_python.egg-info/top_level.txt
+src/request/__init__.py
+src/request/methods.py
+src/request/types_mss.py

mss_python-0.1.0/src/mss_python.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mss_python-0.1.0/src/mss_python.egg-info/top_level.txt

@@ -0,0 +1 @@
+request

mss_python-0.1.0/src/request/methods.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+import xml.etree.ElementTree as ET
+from request.types_mss import *  # might need change
+
+
+class MethodName(Enum):
+    GetHotelList = "getHotelList"
+    GetHotelListByFilter = "getHotelListByFilter"
+    GetSpecialList = "getSpecialList"
+    GetRoomList = "getRoomList"
+    GetWidgetConfig = "getWidgetConfig"
+    GetPriceList = "getPriceList"
+    GetAvailability = "getAvailability"
+    GetRoomAvailability = "getRoomAvailability"
+    GetDayAvailability = "getDayAvailability"
+    PrepareBooking = "prepareBooking"
+    GetBooking = "getBooking"
+    CancelBooking = "cancelBooking"
+    CreateInquiry = "createInquiry"
+    GetInquiry = "getInquiry"
+    GetUserSources = "getUserSources"
+    GetLocationList = "getLocationList"
+    GetMasterpackagesList = "getMasterpackagesList"
+    NotifyMasterpackages = "notifyMasterpackages"
+    GetThemeList = "getThemeList"
+    GetLastminuteQuotations = "getLastminuteQuotations"
+    GetHotelPictures = "getHotelPictures"
+    GetHotelPictureGroups = "getHotelPictureGroups"
+    GetOptionalServices = "getOptionalServices"
+    ValidateCoupon = "validateCoupon"
+
+
+class Method:
+    def __init__(self, name: MethodName):
+        self.name = name
+
+    def get_base_xml(self, cred: Credentials, lang: Search) -> Root:
+        """
+        Returns an XML (ElementTree) with the mandatory elements needed for the request.
+
+        cred: XML Credentials Element (username, password, source)
+
+        lang: XML Search Element with the language element defined
+        """
+
+        header = Header(cred, self.name)
+        req = Request(lang)
+        root = Root(header, req)
+        return root

mss_python-0.1.0/src/request/types_mss.py

@@ -0,0 +1,834 @@
+from __future__ import annotations
+from dataclasses import dataclass, field
+from enum import Enum, IntFlag
+from typing import Literal
+import xml.etree.ElementTree as ET
+from abc import ABC
+from methods import MethodName
+
+
+def get_child_xml(value, field, root):
+    field = field.replace("___", "-")
+    match value:
+        case None:
+            return
+        case int() | float():
+            ET.SubElement(root, field).text = str(value)
+        case str():
+            if field == "tag":
+                return
+            ET.SubElement(root, field).text = value
+        case list():
+            for x in value:
+                get_child_xml(x, field, root)
+        case Enum():
+            ET.SubElement(root, field).text = str(value.value)
+        case _:
+            root.append(value.to_xml())
+
+
+class BaseType(ABC):
+    def __init__(self, tag):
+        self.tag = tag
+
+    def to_xml(self) -> ET.Element:
+        root = ET.Element(self.tag)
+        # root.append(self.search.to_xml())
+
+        for field, value in vars(self).items():
+            get_child_xml(value, field, root)
+
+        return root
+
+
+@dataclass()
+class Root(BaseType):
+    header: Header
+    request: Request
+    version: str = "2.0"
+
+    def __post_init__(self):
+        super().__init__("root")
+
+
+@dataclass()
+class Header(BaseType):
+    credentials: Credentials
+    method: MethodName
+    # method: str
+    paging: Paging | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("header")
+
+
+@dataclass()
+class Credentials(BaseType):
+    user: str
+    password: str
+    source: str
+
+    def __post_init__(self):
+        super().__init__("credentials")
+
+
+@dataclass()
+class Paging:
+    start: int
+    limit: int
+
+
+@dataclass
+class Request(BaseType):
+    search: Search
+    options: Options | None = field(default=None)
+
+    order: Order | None = field(default=None)
+
+    data: Data | None = field(default=None)
+
+    logging: Logging | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("request")
+
+
+@dataclass
+class Search(BaseType):
+    lang: list  # Literal["de", "it", "en", "es", "fr", "ru", "da"]
+    result_id: str | None = field(default=None)
+
+    agent: str | None = field(default=None)
+
+    id: list | None = field(default=None)  # number[]
+
+    search_hotel: SearchHotel | None = field(default=None)
+
+    search_location: SearchLocation | None = field(default=None)
+
+    search_distance: SearchDistance | None = field(default=None)
+
+    search_offer: SearchOffer | None = field(default=None)
+
+    search_lts: SearchLts | None = field(default=None)
+
+    search_special: SearchSpecial | None = field(default=None)
+
+    search_availability: SearchAvailability | None = field(default=None)
+
+    search_pricelist: SearchPriceList | None = field(default=None)
+
+    in_: int | None = field(default=None)  # number[]
+
+    id_ofchannel: Literal["hgv", "lts", "esy"] | None = field(default=None)
+
+    transaction_id: str | None = field(default=None)
+
+    booking_id: str | None = field(default=None)
+
+    guest_email: str | None = field(default=None)
+
+    pic_group_id: int | None = field(default=None)
+
+    id_apt: int | None = field(default=None)
+
+    root_id: list | None = field(default=None)  # list of ints
+
+    pic_type: PictureType | None = field(default=None)
+
+    select___avail: HotelFilters | None = field(default=None)
+    select___rooms: HotelFilters | None = field(default=None)
+    select___price: HotelFilters | None = field(default=None)
+    avail_alert: Literal[0, 1] | None = field(default=None)
+    rooms_alert: Literal[0, 1] | None = field(default=None)
+    price_alert: Literal[0, 1] | None = field(default=None)
+
+    coupon_code: str | None = field(default=None)
+    total_price: int | None = field(default=None)
+    arrival: str | None = field(default=None)
+    departure: str | None = field(default=None)
+    coupon_type: Literal["promotion", "voucher"] | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("search")
+
+
+class HotelFilters(Enum):
+    OTA = "ota"
+    EASI_CHANNEL = "easiChannel"
+    ROTER_HAHN = "10ec953a9d700b9598580a52d3dcef6c"
+    HOTEL_PARTNER = "2d9038f6a34c23280669f73ff531683c"
+    FIVE_STELLE = "30fb54af1d0d231b01b778647cfd967c"
+    ASA_LIGHT = "51c761e7b7b87dbeafe25a9b"
+    ASA_HOTEL = "51c761e7b7b87dc3afe15afa"
+    ROOM_CLOUD = "65ee9db4c37baedc1032cbd72c8caaaf"
+    GS_DATAPROVIDER = "66461e9d7c481e44e632051c3d040a2b"
+    HGV_TEST_CLIENT = "95f6a058-45ca-49df-874f-86f41e0bb29f"
+    HGV_CLIENT_FOR_TRENTINO = "a47a9dd543e55f8b3ee7ce4cc88b6d57"
+    HOTEL_NET_SOLUTIONS = "a57f0615b226609ae409c421ff118a8a"
+    BEDDY = "a8513684c7683fd457f82818f5f15bbf"
+    PCS_PHOENIX_XENUS = "AE1D2D8776B3FC1C;XENUS"
+    AIDA = "AIbD6vqHlYHA17DA"
+    AE_SMO = "ba098f2c86b942e58b6e7a89448f4063"
+    MTS_ONLINE = "bdcec66dfe4e8ef9f5c7e71e4835204c"
+    LTS_BOZEN = "be6bc64c94bbc062bcebfb40b4f93304"
+    BOOKING_EXPERT = "BookingE47acfb09170e8"
+    CASABLANCA = "CasaifeDZQQDaqvlblanca"
+    APARTMENT4HOLIDAY = "ceaeed03a0711eec46582b689d16dc0b"
+    CIAOBNB = "CiaoK2VAvAkFlCTcbnb"
+    EASI_SUITE = "Easy68e9nMxChannel"
+    EASI_SUITE_2 = "Easy68e9nMxChannel2"
+    SCIDOO = "f0bdfb926c2a8d066a9d2ea3e632471c"
+    ERICSOFT = "fcfb97bb1a8e608e5971928ac2032a68"
+    HOTEL_SPIDER = "HoteltihPrvo8kMpbSpider"
+    IPER_BOOKING = "iperbooking"
+    KROSS_BOOKING = "Kross2XklTsfhbBooking"
+    MM_ONE = "MMwRNWBeSQiABuONE"
+    PASSEPARTOUT = "passPGkPyHnw3IbApartout"
+    SEEKDA = "SEEK8XLyALKEzmpyp2DA"
+    SIMPLE_BOOKING = "Simple89sKiOdS9PUcbooking"
+    ANEXIS = "SiPaCbW2I921EpMedia"
+    SMART_PRICING = "SmartqpukLfH5Kl1price"
+    TEST_YANOVIS = "travelsuite"
+    VERTICAL_BOOKING = "VertiexDH0x8XV7Booking"
+    ALPINE_BITS_CERTIFICATION = "VwnIjABCertification78czDK6"
+    WUBOOK = "Wub0Na0CxWovxdVook"
+
+
+class PictureType(Enum):
+    Hotel = "hotel"
+    Gallery = "gallery"
+    Profile = "profile"
+    Roomgroup = "roomgroup"
+    Pricelist = "pricelist"
+    Special = "special"
+
+
+@dataclass
+class Options(BaseType):
+    hotel_details: HotelDetails | None = field(default=None)
+    offer_details: OfferDetails | None = field(default=None)
+
+    picture_date: str | None = field(default=None)  # Date
+    lts_bookable: Literal[0, 1, 2] | None = field(default=None)  # number, 0|1|2
+
+    base_price: int | None = field(default=None)  # number, 0|1
+
+    # field is in easychannel but not in nodejs
+    only_available: Literal[0, 1] | None = field(default=None)  # 0 | 1
+
+    # below fields are in nodejs but not in easychannel.it?
+    room_details: RoomDetails | None = field(default=None)
+    special_details: SpecialDetails | None = field(default=None)
+    # pricelist_details: PriceListDetails | None = field(default=None)
+
+    get_availability: Literal[0, 1] | None = field(default=None)  # 0 | 1
+    get_restrictions: Literal[0, 1] | None = field(default=None)  # 0 | 1
+    get_roomdetails: int | None = field(default=None)  # 0 | 1
+    get_masterpackages: Literal[0, 1] | None = field(default=None)
+
+    location_details: Literal[0, 1] | None = field(default=None)
+    theme_details: Literal[0, 1] | None = field(default=None)
+
+    service_details: ServiceDetails | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("options")
+
+
+class ServiceDetails(IntFlag):
+    Headlines = 8
+    Pictures = 32
+    Descriptions = 256
+
+
+class HotelDetails(IntFlag):
+    BasicInfo = 1
+    Themes = 2
+    HotelFacilities = 4
+    ShortDescription = 8
+    FullDescription = 16
+    GeographicInformation = 32
+    Coordinates = 64
+    Address = 128
+    Contacts = 256
+    PaymentOptionsForOnlineBooking = 512
+    PaymentOptionsAtHotel = 1024  #
+    Logo = 2048
+    HeaderImages = 4096
+    Gallery = 8192
+    HotelMatching = 16384
+    GeographicalInformationAsText = 32768
+    HotelReviews = 65536  # different name in GO
+    DetailedHotelFacilities = 131072
+    SalesPoint = 524288
+    LtsSpecificParameters = 262144
+    CouponServiceData = 16777216
+    CheckInOut = 1048576
+    SourceData = 2097152
+    AccountData = 67108864
+    RoomTypes = 134217728
+    # Payment provider missing?
+
+
+class OfferDetails(IntFlag):
+    BasicInfo = 1
+    RoomCode = 4
+    RoomTitle = 8
+    PriceDetails = 16
+    RoomImages = 32
+    RoomFacilitiesFilter = 64
+    RoomDescription = 256
+    IncludedServices = 1024
+    AdditionalServices = 2048
+    RoomFacilitiesDetails = 4096
+    PriceImages = 8192
+    Themes = 16384
+    RoomFeatures = 32768
+    CancelPolicies = 262144
+    PaymentTerms = 1048576
+
+
+class RoomDetails(IntFlag):
+    BasicInfo = 4
+    Title = 8
+    RoomImages = 32
+    RoomFacilitiesFilter = 64
+    RoomDescription = 256
+    RoomFacilitiesDetails = 4096
+    RoomFeatures = 32768
+    RoomNumbers = 65536
+
+
+class SpecialDetails(IntFlag):
+    BasicInfo = 1
+    Title = 2
+    Descriptions = 4
+    Seasons = 8
+    Images = 16
+    Themes = 32
+    IncludedServices = 64
+
+
+@dataclass
+class Order(BaseType):
+    dir: Direction | None = field(default=None)
+    field: Field | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("order")
+
+
+class Field(Enum):
+    ValidityStart = "valid_start"
+    ValidityEnd = "valid_end"
+    Random = "rand"
+    Stars = "stars"
+    Name = "name"
+
+
+class Direction(Enum):
+    Ascending = "asc"
+    Descending = "desc"
+
+
+@dataclass
+class Data(BaseType):
+    guest: Guest | None = field(default=None)
+    company: Company | None = field(default=None)
+    payment: Payment | None = field(default=None)
+    note: str | None = field(default=None)
+    details: Details | None = field(default=None)
+    form: Form | None = field(default=None)
+    tracking: Tracking | None = field(default=None)
+    # insurance: Ins
+    storno_reason: StornoReason | None = field(default=None)
+    storno_reason_text: str | None = field(default=None)
+
+    special: list | None = field(default=None)  # list of specials
+
+    def __post_init__(self):
+        super().__init__("data")
+
+
+@dataclass
+class Special(BaseType):
+    offer_id: int
+    action: Literal["update", "delete"]
+    time_modified: str  # ISO 8601 Date
+    reset_participants: Literal[0, 1] | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("special")
+
+
+class StornoReason(Enum):
+    Unknown = 0
+    GuestNotAvailable = 1
+    AccomodationRequestedToCancel = 2
+    GuestAnotherDestination = 3
+    GuestAnotherAccomodation = 4
+    Other = 99
+
+
+@dataclass
+class Logging(BaseType):
+    step: str | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("logging")
+
+
+class Step(Enum):
+    Search = "search"
+    SearchOffer = "search_offer"
+    SearchDetails = "search_details"
+    View = "view"
+    ViewOffer = "view_offer"
+    Step1 = "step_1"
+    Step2 = "step_2"
+    Step3 = "step_3"
+    Step4 = "step_4"
+
+
+@dataclass
+class SearchHotel(BaseType):
+    name: str | None = field(default=None)
+    type: HotelType | None = field(default=None)
+    stars: Stars | None = field(default=None)
+    feature: HotelFeature | None = field(default=None)
+    theme: HotelTheme | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("search_hotel")
+
+
+class HotelType(Enum):
+    Hotel = "1"
+    SkiSchool = "2"
+    Residence = "4"
+    Appartment = "16"
+    FarmVacation = "32"
+    MountainInn = "64"
+    CampingSite = "128"
+    HolidayHome = "256"
+    YouthHostel = "512"
+    Guesthouse = "1024"
+    Refuge = "2048"
+    Garni = "4096"
+    Inn = "8192"
+
+
+class HotelFeature(Enum):
+    Garage = "1"
+    Elevator = "2"
+    Restaurant = "4"
+    Gym = "8"
+    Wellness = "16"
+    Spa = "32"
+    Breakfast = "64"
+    Buffet = "128"
+    OutdoorPool = "256"
+    IndoorPool = "512"
+    Bar = "1024"
+    BarrierFree = "2048"
+    Wlan = "4096"
+    ShuttleService = "8192"
+    Childcare = "16384"
+    SmallPetsAllowed = "32768"
+    BeautyFarm = "65536"
+    CentralLocation = "262144"
+    CoveredParking = "524288"
+    OpenParking = "1048576"
+    Massages = "2097152"
+    Sauna = "4194304"
+    SteamBath = "8388608"
+    PublicBar = "16777216"
+    DogsAllowed = "33554432"
+
+
+class HotelTheme(Enum):
+    Family = "1"
+    Wellness = "2"
+    Hiking = "4"
+    Motorcycle = "8"
+    Bike = "16"
+    Golf = "32"
+    Riding = "64"
+    Romantic = "128"
+    Ski = "256"
+    Meeting = "512"
+    CrossCountrySkiing = "1024"
+    Culture = "2048"
+    Snowshoeing = "4096"
+
+
+@dataclass
+class SearchLocation(BaseType):
+    location: list | None = field(default=None)  # number[], Location ID
+    location_lts: list | None = field(default=None)  # string[], LTS Location RID
+
+    def __post_init__(self):
+        super().__init__("search_location")
+
+
+@dataclass
+class SearchDistance:
+    latitude: float  # number
+    longitude: float  # number
+    radius: int  # number
+
+
+@dataclass
+class SearchOffer(BaseType):
+    arrival: str | None = field(default=None)  # Date YYYY-MM-DD
+    departure: str | None = field(default=None)  # Date YYYY-MM-DD
+    service: Board | None = field(default=None)
+    room: list | None = field(default=None)  # Room[]
+    feature: RoomFeature | None = field(default=None)
+    channel_id: list | None = field(default=None)  # string[]
+    typ: SearchOfferType | None = field(default=None)
+    rateplan: Rateplan | None = field(default=None)
+
+    # features from easychange missing?
+
+    def __post_init__(self):
+        super().__init__("search_offer")
+
+
+class SearchOfferType(Enum):
+    DefaultPricelist = "10"
+    PeopleAge = "20"
+    PeopleNumber = "21"
+    Staying = "22"
+    BookingDate = "23"
+    Weekday = "24"
+    NoReference = "25"
+    SpecialPeopleAge = "50"
+    SpecialPeopleNumber = "51"
+    SpecialStaying = "52"
+    SpecialBookingDate = "53"
+    SpecialWeekday = "54"
+    SpecialNoReference = "55"
+
+
+class Board(Enum):
+    Without = 1
+    Breakfast = 2
+    HalfBoard = 3
+    FullBoard = 4
+    AllInclusive = 5
+
+
+class RoomFeature(IntFlag):
+    Balcony = 1
+    Terrace = 2
+    MiniBar = 4
+    Safe = 8
+    TV = 16
+    Satellite = 32
+    Wlan = 64
+    Internet = 128
+    BarrierFree = 512
+
+
+@dataclass
+class SearchLts(BaseType):
+    A0Ene: int | None = field(default=None)  # number
+    A0MTV: int | None = field(default=None)  # number
+    A0Rep: int | None = field(default=None)  # number
+
+    def __post_init__(self):
+        super().__init__("search_lts")
+
+
+@dataclass
+class SearchSpecial(BaseType):
+    offer_id: list | None = field(default=None)  # number[]
+    date_from: str | None = field(default=None)  # Date YYYY-MM-DD
+    date_to: str | None = field(default=None)  # Date YYYY-MM-DD
+    theme: list | None = field(default=None)  # array of SpecialTheme
+    validity: Validity | None = field(default=None)
+    typ: SearchSpecialType | None = field(default=None)
+    premium: SearchSpecialPremium | None = field(default=None)
+
+    poi_id: list | None = field(default=None)
+    poi_cat: list | None = field(default=None)
+    status: Literal[0, 1] | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("search_special")
+
+
+class SearchSpecialType(Enum):
+    PriceLists = 0
+    Packages = 1
+    Specials = 2
+    ShortLongStays = 4
+
+
+class SearchSpecialPremium(IntFlag):
+    FamilyHotelsPremium = 2
+    VinumHotelsPremium = 4
+    SüdtirolBalancePremium = 8
+    VitalpinaDurchatmen = 16
+    VitalpinaWohlfühlen = 32
+    VitalpinaErnährung = 64
+    VitalpinaAktiv = 128
+    VitalpinaPremium = 256
+    BikehotelsMountainbike = 512
+    BikehotelsBikeTouringEBike = 1024
+    BikehotelsRoadbike = 2048
+    BikehotelsPremium = 4096
+    ArchitectureDays = 8192
+    VinumHotels = 16384
+    FamilyHotels = 32768
+    FamilyHotelsNatureDetective = 65536
+    FamilyHotelsNatureDetectiveWinter = 131072
+
+
+class SpecialTheme(Enum):
+    ThemeIDHiking = 1
+    ThemeIDCyclingMountainbike = 2
+    ThemeIDFamily = 3
+    ThemeIDWellnessHealth = 4
+    ThemeIDFoodAndDrink = 5
+    ThemeIDGolf = 6
+    ThemeIDCulture = 7
+    ThemeIDMotorsport = 8
+    ThemeIDCarFreeHolidays = 9
+    ThemeIDSkiSnowboard = 10
+    ThemeIDSummerActivities = 11
+    ThemeIDEvents = 12
+    ThemeIDChristmasMarkets = 13
+    ThemeIDActiveWinter = 14
+    ThemeIDVitalpina = 15
+    ThemeIDVitalpinaBreathe = 16
+    ThemeIDBikeHotelsEBike = 17
+    ThemeIDBikeHotelsFreeride = 18
+    ThemeIDBikeHotelsMountainbike = 20
+    ThemeIDBikeHotelsBikeTours = 21
+    ThemeIDBikeHotelsRacingBike = 22
+    ThemeIDFamilyHotels = 23
+    ThemeIDFamilyHotelsNatureDetective = 24
+    ThemeIDFamilyHotel = 26
+    ThemeIDNatureDetectivSummer = 27
+    ThemeIDNatureDetectivWinter = 28
+    ThemeIDEcologicHoliday = 79
+    ThemeIDHorseBackRiding = 80
+    ThemeIDLuxuryHoliday = 81
+    ThemeIDPetsFriendlyHoliday = 82
+    ThemeIDRoadBike = 83
+    ThemeIDRomanticHoliday = 84
+    ThemeIDWine = 85
+    ThemeIDBicycleTouring = 86
+    ThemeIDEBike = 87
+
+    ##These values were theme_bit
+    # Hiking = 1
+    # Cycling = 2
+    # Family = 4
+    # Wellness = 8
+    # Food = 16
+    # Golf = 32
+    # Culture = 64
+    # Motorsport = 128
+    # CarFree = 256
+    # SkiSnowboard = 512
+    # SummerActivities = 1024
+    # Events = 2048
+    # ChristmasMarkets = 4096
+    # ActiveWinter = 8192
+    # Vitalpina = 16384
+    # VitalpinaBreathe = 32768
+    # BikeHotelsEBike = 65536
+    # BikeHotelsFreeride = 131072
+    # BikeHotelsMountainbike = 524288
+    # BikeHotelsBikeTours = 1048576
+    # BikeHotelsRacingBike = 2097152
+    # FamilyHotels = 4194304
+    # FamilyHotelsNatureDetective = 8388608
+    # FamilyHotel = 33554432
+    # FamilyHotelsNatureDetectiveSummer = 67108864
+    # FamilyHotelsNatureDetectiveWinter = 134217728
+
+
+@dataclass
+class SearchAvailability(BaseType):
+    date_from: str  # Date YYYY-MM-DD
+    date_to: str  # Date YYYY-MM-DD
+    offer_id: list | None = field(default=None)  # number[]
+    room_id: list | None = field(default=None)  # number[]
+    duration: int | None = field(default=None)
+    room: Room | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("search_availability")
+
+
+@dataclass
+class SearchPriceList(BaseType):
+    date_from: str | None = field(default=None)  # Date YYYY-MM-DD
+    date_to: str | None = field(default=None)  # Date YYYY-MM-DD
+    service: Board | None = field(default=None)
+    room_id: list | None = field(default=None)  # number[]
+    typ: SearchSpecialType | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("search_pricelist")
+
+
+@dataclass
+class Guest(BaseType):
+    firstname: str
+    lastname: str
+    email: str
+    gender: str | None = field(default=None)
+    prefix: str | None = field(default=None)
+    phone: str | None = field(default=None)
+    address: Address | None = field(default=None)
+    newsletter: Literal[0, 1] | None = field(default=None)  # 0 | 1
+
+    def __post_init__(self):
+        super().__init__("guest")
+
+
+@dataclass
+class Company(BaseType):
+    name: str | None = field(default=None)
+    taxnumber: str | None = field(default=None)
+    recipient_code: str | None = field(default=None)
+    address: Address | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("company")
+
+
+@dataclass
+class Payment(BaseType):
+    method: PaymentMethod | None = field(default=None)
+    invoice: Literal[0, 1] | None = field(default=None)  # 0 | 1
+
+    def __post_init__(self):
+        super().__init__("payment")
+
+
+class PaymentMethod(IntFlag):
+    CreditCardDeposit = 1
+    CreditCardAsSecurity = 2
+    CreditCardPayment = 8
+    BankTransferDeposit = 4
+    BankTransferPayment = 16
+    AccommodationPayment = 32
+
+
+@dataclass
+class Details(BaseType):
+    extr_price: list | None = field(default=None)  # ExtraPrice[]
+
+    def __post_init__(self):
+        super().__init__("Details")
+
+
+@dataclass
+class ExtraPrice(BaseType):
+    price_id: int | None = field(default=None)  # number
+    price_amount: int | None = field(default=None)  # number
+
+    def __post_init__(self):
+        super().__init__("extra_price")
+
+
+@dataclass
+class Form(BaseType):
+    url_success: str | None = field(default=None)
+    url_failure: str | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("form")
+
+
+@dataclass
+class Tracking(BaseType):
+    partner: str | None = field(default=None)
+    media: str | None = field(default=None)
+    campaign: str | None = field(default=None)
+    companyinfo: str | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("tracking")
+
+
+@dataclass
+class Stars(BaseType):
+    min: Literal[1, 2, 3, 3.5, 4, 4.5, 5] | None = field(
+        default=None
+    )  # number, min can be 1, values are 1, 2, 3, 3.5, 4, 4.5, 5
+    max: Literal[1, 2, 3, 3.5, 4, 4.5, 5] | None = field(
+        default=None
+    )  # number, max can be 5
+
+    def __post_init__(self):
+        super().__init__("stars")
+
+
+@dataclass
+class Address(BaseType):
+    street: str | None = field(default=None)
+    zipcode: str | None = field(default=None)
+    city: str | None = field(default=None)
+    country: str | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("address")
+
+
+@dataclass
+class Room(BaseType):
+    room_seq: int | None = field(default=None)  # number
+    person: list | None = field(
+        default=None
+    )  # number[], 1..n Persons and their age (store only age inside tags)
+    offer_id: int | None = field(default=None)  # number
+    room_id: int | None = field(default=None)  # number
+    service: Board | None = field(default=None)
+    room_type: RoomType | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("room")
+
+
+class RoomType(Enum):
+    All = 0
+    Room = 1
+    Apartment = 2
+    Campsite = 4
+
+
+@dataclass
+class Rateplan(BaseType):
+    code: str  # | None = field(default=None)
+    source: str  # | None = field(default=None)
+
+    def __post_init__(self):
+        super().__init__("rateplan")
+
+
+@dataclass
+class Validity(BaseType):
+    valid: Literal[0, 1]  # 0 | 1
+    offers: Literal[0, 1] | None = field(default=None)  # 0 | 1
+    arrival: str | None = field(default=None)  # Date YYYY-MM-DD
+    departure: str | None = field(default=None)  # Date YYYY-MM-DD
+    service: Board | None = field(default=None)
+    room: list | None = field(default=None)  # Room[]
+
+    def __post_init__(self):
+        super().__init__("validity")
+
+
+def getHotelList_base_xml(root: Root, header: Header):
+    xml = '<?xml version="1.0" encoding="utf-8"?>'
+    xml += root.version
+    xml += header.credentials
+    return xml