pyxecm 1.6__py3-none-any.whl → 2.0.0__py3-none-any.whl

pyxecm/customizer/salesforce.py

@@ -1,71 +1,23 @@
-"""
-Salesforce Module to interact with the Salesforce API
-See: https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_rest.htm
+"""Salesforce Module to interact with the Salesforce API.
 
-Class: Salesforce
-Methods:
-
-__init__ : class initializer
-config : Returns config data set
-credentials: Returns the token data
-
-request_header: Returns the request header for Salesforce API calls
-do_request: Call an Salesforce REST API in a safe way
-parse_request_response: Parse the REST API responses and convert
-                        them to Python dict in a safe way
-exist_result_item: Check if an dict item is in the response
-                   of the Salesforce API call
-get_result_value: Check if a defined value (based on a key) is in the Salesforce API response
-
-authenticate: Authenticates at Salesforce API
-
-get_object_id_by_name: Get the ID of a given Salesforce object with a given type and name
-get_object: Get a Salesforce object based on a defined
-            field value and return selected result fields.
-add_object: Add object to Salesforce. This is a generic wrapper method
-            for the actual add methods.
-
-get_group: Get a Salesforce group based on its ID.
-add_group: Add a new Salesforce group.
-update_group: Update a Salesforce group.
-get_group_members: Get Salesforce group members
-add_group_member: Add a user or group to a Salesforce group
-
-get_all_user_profiles: Get all user profiles
-get_user_profile_id: Get a user profile ID by profile name
-get_user_id: Get a user ID by user name
-get_user: Get a Salesforce user based on its ID.
-add_user: Add a new Salesforce user.
-update_user: Update a Salesforce user.
-update_user_password: Update the password of a Salesforce user.
-update_user_photo: update the Salesforce user photo.
-
-add_account: Add a new Account object to Salesforce.
-add_product: Add a new Product object to Salesforce.
-add_opportunity: Add a new Opportunity object to Salesfoce.
-add_case: Add a new Case object to Salesforce. The case number
-          is automatically created and can not be provided.
-add_asset: Add a new Asset object to Salesforce.
-add_contract: Add a new Contract object to Salesforce.
+See: https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_rest.htm
 """
 
 __author__ = "Dr. Marc Diefenbruch"
-__copyright__ = "Copyright 2024, OpenText"
+__copyright__ = "Copyright (C) 2024-2025, OpenText"
 __credits__ = ["Kai-Philip Gatzweiler"]
 __maintainer__ = "Dr. Marc Diefenbruch"
 __email__ = "mdiefenb@opentext.com"
 
-import os
 import json
 import logging
+import os
 import time
-
-from typing import Optional, Union, Any
-
 from http import HTTPStatus
+
 import requests
 
-logger = logging.getLogger("pyxecm.customizer.salesforce")
+default_logger = logging.getLogger("pyxecm.customizer.salesforce")
 
 REQUEST_LOGIN_HEADERS = {
     "Content-Type": "application/x-www-form-urlencoded",
@@ -78,8 +30,11 @@ REQUEST_MAX_RETRIES = 3
 
 SALESFORCE_API_VERSION = "v60.0"
 
-class Salesforce(object):
-    """Used to retrieve and automate stettings in Salesforce."""
+
+class Salesforce:
+    """Class Salesforce is used to retrieve and automate stettings and objects in Salesforce."""
+
+    logger: logging.Logger = default_logger
 
     _config: dict
     _access_token = None
@@ -94,21 +49,38 @@ class Salesforce(object):
         password: str,
         authorization_url: str = "",
         security_token: str = "",
-    ):
-        """Initialize the Salesforce object
+        logger: logging.Logger = default_logger,
+    ) -> None:
+        """Initialize the Salesforce object.
 
         Args:
-            base_url (str): base URL of the Salesforce tenant
-            authorization_url (str): authorization URL of the Salesforce tenant, typically ending with "/services/oauth2/token"
-            client_id (str): Salesforce Client ID
-            client_secret (str): Salesforce Client Secret
-            username (str): user name in Saleforce
-            password (str): password of the user
-            authorization_url (str, optional): URL for Salesforce login. If not given it will be constructed with default values
-                                               using base_url
-            security_token (str, optional): security token for Salesforce login
+            base_url (str):
+                Base URL of the Salesforce tenant.
+            authorization_url (str):
+                Authorization URL of the Salesforce tenant, typically ending with "/services/oauth2/token".
+            client_id (str):
+                The Salesforce Client ID.
+            client_secret (str):
+                The Salesforce Client Secret.
+            username (str):
+                User name in Saleforce used by the REST API.
+            password (str):
+                Password of the user used by the REST API.
+            authorization_url (str, optional):
+                URL for Salesforce login. If not given it will be constructed with default values
+                using base_url.
+            security_token (str, optional):
+                Security token for Salesforce login.
+            logger (logging.Logger, optional):
+                The logging object to use for all log messages. Defaults to default_logger.
+
         """
 
+        if logger != default_logger:
+            self.logger = logger.getChild("salesforce")
+            for logfilter in logger.filters:
+                self.logger.addFilter(logfilter)
+
         # The instance URL is also returned by the authenticate call
         # but typically it is identical to the base_url.
         self._instance_url = base_url
@@ -124,38 +96,32 @@ class Salesforce(object):
 
         # Set the Salesforce URLs and REST API endpoints:
         salesforce_config["baseUrl"] = base_url
-        salesforce_config["objectUrl"] = salesforce_config[
-            "baseUrl"
-        ] + "/services/data/{}/sobjects/".format(SALESFORCE_API_VERSION)
-        salesforce_config["queryUrl"] = salesforce_config[
-            "baseUrl"
-        ] + "/services/data/{}/query/".format(SALESFORCE_API_VERSION)
-        salesforce_config["compositeUrl"] = salesforce_config[
-            "baseUrl"
-        ] + "/services/data/{}/composite/".format(SALESFORCE_API_VERSION)
-        salesforce_config["connectUrl"] = salesforce_config[
-            "baseUrl"
-        ] + "/services/data/{}/connect/".format(SALESFORCE_API_VERSION)
-        salesforce_config["toolingUrl"] = salesforce_config[
-            "baseUrl"
-        ] + "/services/data/{}/tooling/".format(SALESFORCE_API_VERSION)
+        salesforce_config["objectUrl"] = salesforce_config["baseUrl"] + "/services/data/{}/sobjects/".format(
+            SALESFORCE_API_VERSION,
+        )
+        salesforce_config["queryUrl"] = salesforce_config["baseUrl"] + "/services/data/{}/query/".format(
+            SALESFORCE_API_VERSION,
+        )
+        salesforce_config["compositeUrl"] = salesforce_config["baseUrl"] + "/services/data/{}/composite/".format(
+            SALESFORCE_API_VERSION,
+        )
+        salesforce_config["connectUrl"] = salesforce_config["baseUrl"] + "/services/data/{}/connect/".format(
+            SALESFORCE_API_VERSION,
+        )
+        salesforce_config["toolingUrl"] = salesforce_config["baseUrl"] + "/services/data/{}/tooling/".format(
+            SALESFORCE_API_VERSION,
+        )
         if authorization_url:
             salesforce_config["authenticationUrl"] = authorization_url
         else:
-            salesforce_config["authenticationUrl"] = (
-                salesforce_config["baseUrl"] + "/services/oauth2/token"
-            )
+            salesforce_config["authenticationUrl"] = salesforce_config["baseUrl"] + "/services/oauth2/token"
         # URLs that are based on the objectURL (sobjects/):
         salesforce_config["userUrl"] = salesforce_config["objectUrl"] + "User/"
         salesforce_config["groupUrl"] = salesforce_config["objectUrl"] + "Group/"
-        salesforce_config["groupMemberUrl"] = (
-            salesforce_config["objectUrl"] + "GroupMember/"
-        )
+        salesforce_config["groupMemberUrl"] = salesforce_config["objectUrl"] + "GroupMember/"
         salesforce_config["accountUrl"] = salesforce_config["objectUrl"] + "Account/"
         salesforce_config["productUrl"] = salesforce_config["objectUrl"] + "Product2/"
-        salesforce_config["opportunityUrl"] = (
-            salesforce_config["objectUrl"] + "Opportunity/"
-        )
+        salesforce_config["opportunityUrl"] = salesforce_config["objectUrl"] + "Opportunity/"
         salesforce_config["caseUrl"] = salesforce_config["objectUrl"] + "Case/"
         salesforce_config["assetUrl"] = salesforce_config["objectUrl"] + "Asset/"
         salesforce_config["contractUrl"] = salesforce_config["objectUrl"] + "Contract/"
@@ -174,33 +140,44 @@ class Salesforce(object):
     # end method definition
 
     def config(self) -> dict:
-        """Returns the configuration dictionary
+        """Return the configuration dictionary.
 
         Returns:
-            dict: Configuration dictionary
+            dict:
+                The configuration dictionary.
+
         """
+
         return self._config
 
     # end method definition
 
     def credentials(self) -> dict:
-        """Return the login credentials
+        """Return the login credentials.
 
         Returns:
-            dict: dictionary with login credentials for Salesforce
+            dict:
+                The dictionary with login credentials for Salesforce.
+
         """
+
         return self.config()["authenticationData"]
 
     # end method definition
 
     def request_header(self, content_type: str = "application/json") -> dict:
-        """Returns the request header used for Application calls.
-           Consists of Bearer access token and Content Type
+        """Return the request header used for Application calls.
+
+        Consists of Bearer access token and Content Type
 
         Args:
-            content_type (str, optional): content type for the request
-        Return:
-            dict: request header values
+            content_type (str, optional):
+                Content type for the request. Default is "pplication/json".
+
+        Returns:
+            dict:
+                The equest header values
+
         """
 
         request_header = {
@@ -234,36 +211,64 @@ class Salesforce(object):
         stream: bool = False,
         verify: bool = True,
     ) -> dict | None:
-        """Call an Salesforce REST API in a safe way
+        """Call an Salesforce REST API in a safe way.
 
         Args:
-            url (str): URL to send the request to.
-            method (str, optional): HTTP method (GET, POST, etc.). Defaults to "GET".
-            headers (dict | None, optional): Request Headers. Defaults to None.
-            data (dict | None, optional): Request payload. Defaults to None
-            files (dict | None, optional): Dictionary of {"name": file-tuple} for multipart encoding upload.
-                                           file-tuple can be a 2-tuple ("filename", fileobj) or a 3-tuple ("filename", fileobj, "content_type")
-            params (dict | None, optional): Add key-value pairs to the query string of the URL.
-                                            When you use the params parameter, requests automatically appends
-                                            the key-value pairs to the URL as part of the query string
-            timeout (int | None, optional): Timeout for the request in seconds. Defaults to REQUEST_TIMEOUT.
-            show_error (bool, optional): Whether or not an error should be logged in case of a failed REST call.
-                                         If False, then only a warning is logged. Defaults to True.
-            warning_message (str, optional): Specific warning message. Defaults to "". If not given the error_message will be used.
-            failure_message (str, optional): Specific error message. Defaults to "".
-            success_message (str, optional): Specific success message. Defaults to "".
-            max_retries (int, optional): How many retries on Connection errors? Default is REQUEST_MAX_RETRIES.
-            retry_forever (bool, optional): Eventually wait forever - without timeout. Defaults to False.
-            parse_request_response (bool, optional): should the response.text be interpreted as json and loaded into a dictionary. True is the default.
-            stream (bool, optional): parameter is used to control whether the response content should be immediately downloaded or streamed incrementally
-            verify (bool, optional): specify whether or not SSL certificates should be verified when making an HTTPS request. Default = True
+            url (str):
+                The URL to send the request to.
+            method (str, optional):
+                HTTP method (GET, POST, etc.). Defaults to "GET".
+            headers (dict | None, optional):
+                Request Headers. Defaults to None.
+            data (dict | None, optional):
+                Request payload. Defaults to None
+            json_data (dict | None, optional):
+                Request payload. Defaults to None.
+            files (dict | None, optional):
+                Dictionary of {"name": file-tuple} for multipart encoding upload.
+                The file-tuple can be a 2-tuple ("filename", fileobj) or a 3-tuple ("filename", fileobj, "content_type")
+            params (dict | None, optional):
+                Add key-value pairs to the query string of the URL.
+                When you use the params parameter, requests automatically appends
+                the key-value pairs to the URL as part of the query string
+            timeout (int | None, optional):
+                Timeout for the request in seconds. Defaults to REQUEST_TIMEOUT.
+            show_error (bool, optional):
+                Whether or not an error should be logged in case of a failed REST call.
+                If False, then only a warning is logged. Defaults to True.
+            show_warning (bool, optional):
+                Whether or not an warning should be logged in case of a failed REST call.
+                If False, then only a warning is logged. Defaults to True.
+            warning_message (str, optional):
+                Specific warning message. Defaults to "".
+                If not given the error_message will be used.
+            failure_message (str, optional):
+                Specific error message. Defaults to "".
+            success_message (str, optional):
+                Specific success message. Defaults to "".
+            max_retries (int, optional):
+                How many retries on Connection errors? Default is REQUEST_MAX_RETRIES.
+            retry_forever (bool, optional):
+                Eventually wait forever - without timeout. Defaults to False.
+            parse_request_response (bool, optional):
+                Should the response.text be interpreted as json and loaded into a dictionary.
+                True is the default.
+            stream (bool, optional):
+                Control whether the response content should be immediately downloaded or streamed incrementally.
+            verify (bool, optional):
+                Specify whether or not SSL certificates should be verified when making an HTTPS request.
+                Default = True
 
         Returns:
-            dict | None: Response of OTDS REST API or None in case of an error.
+            dict | None:
+                Response of OTDS REST API or None in case of an error.
+
         """
 
         if headers is None:
-            logger.error("Missing request header. Cannot send request to Core Share!")
+            self.logger.error(
+                "Missing request header. Cannot send request to Core Share!",
+            )
             return None
 
         # In case of an expired session we reauthenticate and
@@ -288,19 +293,19 @@ class Salesforce(object):
 
                 if response.ok:
                     if success_message:
-                        logger.info(success_message)
+                        self.logger.info(success_message)
                     if parse_request_response:
                         return self.parse_request_response(response)
                     else:
                         return response
                 # Check if Session has expired - then re-authenticate and try once more
                 elif response.status_code == 401 and retries == 0:
-                    logger.debug("Session has expired - try to re-authenticate...")
+                    self.logger.debug("Session has expired - try to re-authenticate...")
                     self.authenticate(revalidate=True)
                     # Make sure to not change an existing content type
                     # the do_request() method is called with:
                     headers = self.request_header(
-                        content_type=headers.get("Content-Type", None)
+                        content_type=headers.get("Content-Type", None),
                     )
                     retries += 1
                 else:
@@ -312,7 +317,7 @@ class Salesforce(object):
                         response_text = response.text
 
                     if show_error:
-                        logger.error(
+                        self.logger.error(
                             "%s; status -> %s/%s; error -> %s",
                             failure_message,
                             response.status_code,
@@ -320,7 +325,7 @@ class Salesforce(object):
                             response_text,
                         )
                     elif show_warning:
-                        logger.warning(
+                        self.logger.warning(
                             "%s; status -> %s/%s; warning -> %s",
                             warning_message if warning_message else failure_message,
                             response.status_code,
@@ -328,7 +333,7 @@ class Salesforce(object):
                             response_text,
                         )
                     if content_type == "text/html":
-                        logger.debug(
+                        self.logger.debug(
                             "%s; status -> %s/%s; warning -> %s",
                             failure_message,
                             response.status_code,
@@ -338,45 +343,45 @@ class Salesforce(object):
                     return None
             except requests.exceptions.Timeout:
                 if retries <= max_retries:
-                    logger.warning(
+                    self.logger.warning(
                         "Request timed out. Retrying in %s seconds...",
                         str(REQUEST_RETRY_DELAY),
                     )
                     retries += 1
                     time.sleep(REQUEST_RETRY_DELAY)  # Add a delay before retrying
                 else:
-                    logger.error(
-                        "%s; timeout error",
+                    self.logger.error(
+                        "%s; timeout error.",
                         failure_message,
                     )
                     if retry_forever:
                         # If it fails after REQUEST_MAX_RETRIES retries we let it wait forever
-                        logger.warning("Turn timeouts off and wait forever...")
+                        self.logger.warning("Turn timeouts off and wait forever...")
                         timeout = None
                     else:
                         return None
             except requests.exceptions.ConnectionError:
                 if retries <= max_retries:
-                    logger.warning(
+                    self.logger.warning(
                         "Connection error. Retrying in %s seconds...",
                         str(REQUEST_RETRY_DELAY),
                     )
                     retries += 1
                     time.sleep(REQUEST_RETRY_DELAY)  # Add a delay before retrying
                 else:
-                    logger.error(
-                        "%s; connection error",
+                    self.logger.error(
+                        "%s; connection error.",
                         failure_message,
                     )
                     if retry_forever:
                         # If it fails after REQUEST_MAX_RETRIES retries we let it wait forever
-                        logger.warning("Turn timeouts off and wait forever...")
+                        self.logger.warning("Turn timeouts off and wait forever...")
                         timeout = None
                         time.sleep(REQUEST_RETRY_DELAY)  # Add a delay before retrying
                     else:
                         return None
             # end try
-            logger.debug(
+            self.logger.debug(
                 "Retrying REST API %s call -> %s... (retry = %s)",
                 method,
                 url,
@@ -392,43 +397,47 @@ class Salesforce(object):
         additional_error_message: str = "",
         show_error: bool = True,
     ) -> dict | None:
-        """Converts the request response (JSon) to a Python dict in a safe way
-           that also handles exceptions. It first tries to load the response.text
-           via json.loads() that produces a dict output. Only if response.text is
-           not set or is empty it just converts the response_object to a dict using
-           the vars() built-in method.
+        """Convert the request response (JSon) to a Python dict in a safe way.
+
+        This includes handling exceptions.
+
+        It first tries to load the response.text via json.loads() that produces
+        a dict output. Only if response.text is not set or is empty it just converts
+        the response_object to a dict using the vars() built-in method.
 
         Args:
-            response_object (object): this is reponse object delivered by the request call
-            additional_error_message (str, optional): use a more specific error message
-                                                      in case of an error
-            show_error (bool): True: write an error to the log file
-                               False: write a warning to the log file
+            response_object (object):
+                This is reponse object delivered by the request call.
+            additional_error_message (str, optional):
+                Provide a a more specific error message that is logged in case of an error.
+            show_error (bool):
+                If True, write an error to the log file.
+                If False, write a warning to the log file.
+
         Returns:
-            dict: response information or None in case of an error
+            dict | None: Parsed response information or None in case of an error.
+
         """
 
         if not response_object:
             return None
 
         try:
-            if response_object.text:
-                dict_object = json.loads(response_object.text)
-            else:
-                dict_object = vars(response_object)
+            dict_object = json.loads(response_object.text) if response_object.text else vars(response_object)
         except json.JSONDecodeError as exception:
             if additional_error_message:
                 message = "Cannot decode response as JSon. {}; error -> {}".format(
-                    additional_error_message, exception
+                    additional_error_message,
+                    exception,
                 )
             else:
                 message = "Cannot decode response as JSon; error -> {}".format(
-                    exception
+                    exception,
                 )
             if show_error:
-                logger.error(message)
+                self.logger.error(message)
             else:
-                logger.warning(message)
+                self.logger.warning(message)
             return None
         else:
             return dict_object
@@ -436,14 +445,20 @@ class Salesforce(object):
     # end method definition
 
     def exist_result_item(self, response: dict, key: str, value: str) -> bool:
-        """Check existence of key / value pair in the response properties of an Salesforce API call.
+        """Check existence of key / value pair in the response properties of a Salesforce API call.
 
         Args:
-            response (dict): REST response from an Salesforce API call
-            key (str): property name (key)
-            value (str): value to find in the item with the matching key
+            response (dict):
+                REST response from an Salesforce API call
+            key (str):
+                The property name (key) of the item to lookup.
+            value (str):
+                The value to find in the item with the matching key.
+
         Returns:
-            bool: True if the value was found, False otherwise
+            bool:
+                True if the value was found, False otherwise.
+
         """
 
         if not response:
@@ -455,10 +470,10 @@ class Salesforce(object):
                 return False
 
             for record in records:
-                if value == record[key]:
+                if key in record and value == record[key]:
                     return True
         else:
-            if not key in response:
+            if key not in response:
                 return False
             if value == response[key]:
                 return True
@@ -473,15 +488,22 @@ class Salesforce(object):
         key: str,
         index: int = 0,
     ) -> str | None:
-        """Get value of a result property with a given key of an Salesforce API call.
+        """Get the value of a result property with a given key of an Salesforce API call.
 
         Args:
-            response (dict): REST response from an Salesforce REST Call
-            key (str): property name (key)
-            index (int, optional): Index to use (1st element has index 0).
-                                   Defaults to 0.
+            response (dict):
+                REST response from an Salesforce REST Call.
+            key (str):
+                The property name (key) of the item to lookup.
+            index (int, optional):
+                Index to use (1st element has index 0).
+                Defaults to 0.
+
         Returns:
-            str: value for the key, None otherwise
+            str | None:
+                The value for the key or None in case of an error or if the
+                key is not found.
+
         """
 
         if not response:
@@ -495,7 +517,7 @@ class Salesforce(object):
                 return None
             value = values[index][key]
         else:  # simple response - try to find key in response directly:
-            if not key in response:
+            if key not in response:
                 return None
             value = response[key]
 
@@ -507,15 +529,20 @@ class Salesforce(object):
         """Authenticate at Salesforce with client ID and client secret.
 
         Args:
-            revalidate (bool, optional): determinse if a re-athentication is enforced
-                                         (e.g. if session has timed out with 401 error)
+            revalidate (bool, optional):
+                Determins if a re-athentication is enforced
+                (e.g. if session has timed out with 401 error).
+
         Returns:
-            str: Access token. Also stores access token in self._access_token. None in case of error
+            str | None:
+                The Access token. Also stores access token in self._access_token.
+                None in case of error
+
         """
 
         # Already authenticated and session still valid?
         if self._access_token and not revalidate:
-            logger.debug(
+            self.logger.debug(
                 "Session still valid - return existing access token -> %s",
                 str(self._access_token),
             )
@@ -524,7 +551,7 @@ class Salesforce(object):
         request_url = self.config()["authenticationUrl"]
         request_header = REQUEST_LOGIN_HEADERS
 
-        logger.debug("Requesting Salesforce Access Token from -> %s", request_url)
+        self.logger.debug("Requesting Salesforce Access Token from -> %s", request_url)
 
         authenticate_post_body = self.credentials()
 
@@ -540,7 +567,7 @@ class Salesforce(object):
                 timeout=REQUEST_TIMEOUT,
             )
         except requests.exceptions.ConnectionError as exception:
-            logger.warning(
+            self.logger.warning(
                 "Unable to connect to -> %s : %s",
                 self.config()["authenticationUrl"],
                 exception,
@@ -554,11 +581,11 @@ class Salesforce(object):
             else:
                 # Store authentication access_token:
                 self._access_token = authenticate_dict["access_token"]
-                logger.debug("Access Token -> %s", self._access_token)
+                self.logger.debug("Access Token -> %s", self._access_token)
                 self._instance_url = authenticate_dict["instance_url"]
-                logger.debug("Instance URL -> %s", self._instance_url)
+                self.logger.debug("Instance URL -> %s", self._instance_url)
         else:
-            logger.error(
+            self.logger.error(
                 "Failed to request an Salesforce Access Token; error -> %s",
                 response.text,
             )
@@ -569,8 +596,11 @@ class Salesforce(object):
     # end method definition
 
     def get_object_id_by_name(
-        self, object_type: str, name: str, name_field: str = "Name"
-    ) -> Optional[str]:
+        self,
+        object_type: str,
+        name: str,
+        name_field: str = "Name",
+    ) -> str | None:
         """Get the ID of a given Salesforce object with a given type and name.
 
         Args:
@@ -580,6 +610,7 @@ class Salesforce(object):
 
         Returns:
             Optional[str]: Object ID or None if the request fails.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -597,7 +628,8 @@ class Salesforce(object):
             params={"q": query},
             timeout=REQUEST_TIMEOUT,
             failure_message="Failed to get Salesforce object ID for object type -> '{}' and object name -> '{}'".format(
-                object_type, name
+                object_type,
+                name,
             ),
         )
         if not response:
@@ -619,16 +651,18 @@ class Salesforce(object):
 
         Args:
             object_type (str): Salesforce Business Object type. Such as "Account" or "Case".
-            search_field (str): object field to search in
-            search_value (str): value to search for
-            result_fields (list | None): list of fields to return. If None, then all standard fields
-                                         of the object will be returned.
-            limit (int, optional): maximum number of fields to return. Salesforce enforces 200 as upper limit.
+            search_field (str): The object field to search in.
+            search_value (str): The value to search for.
+            result_fields (list | None):
+                List of fields to return. If None, then all standard fields
+                of the object will be returned.
+            limit (int, optional):
+                The maximum number of fields to return. Salesforce enforces 200 as upper limit.
 
         Returns:
             dict | None: Dictionary with the Salesforce object data.
 
-            Example response:
+        Example:
             {
                 'totalSize': 2,
                 'done': True,
@@ -649,20 +683,21 @@ class Salesforce(object):
                     }
                 ]
             }
+
         """
 
         if not self._access_token or not self._instance_url:
             self.authenticate()
 
         if search_field and not search_value:
-            logger.error(
+            self.logger.error(
                 "No search value has been provided for search field -> %s!",
                 search_field,
             )
             return None
         if not result_fields:
-            logger.debug(
-                "No result fields defined. Using 'FIELDS(STANDARD)' to deliver all standard fields of the object."
+            self.logger.debug(
+                "No result fields defined. Using 'FIELDS(STANDARD)' to deliver all standard fields of the object.",
             )
             result_fields = ["FIELDS(STANDARD)"]
 
@@ -674,8 +709,10 @@ class Salesforce(object):
         request_header = self.request_header()
         request_url = self.config()["queryUrl"] + "?q={}".format(query)
 
-        logger.debug(
-            "Sending query -> %s to Salesforce; calling -> %s", query, request_url
+        self.logger.debug(
+            "Sending query -> %s to Salesforce; calling -> %s",
+            query,
+            request_url,
         )
 
         return self.do_request(
@@ -684,22 +721,29 @@ class Salesforce(object):
             headers=request_header,
             timeout=REQUEST_TIMEOUT,
             failure_message="Failed to retrieve Salesforce object type -> '{}' with {} = {}".format(
-                object_type, search_field, search_value
+                object_type,
+                search_field,
+                search_value,
             ),
         )
 
     # end method definition
 
-    def add_object(self, object_type: str, **kwargs: Any) -> dict | None:
-        """Add object to Salesforce. This is a generic wrapper method
-           for the actual add methods.
+    def add_object(self, object_type: str, **kwargs: dict[str, str]) -> dict | None:
+        """Add object to Salesforce.
+
+        This is a generic wrapper method for the actual add methods.
 
         Args:
-            object_type (str): Type of the Salesforce business object, like "Account" or "Case".
-            **kwargs (dict): keyword / value ictionary with additional parameters
+            object_type (str):
+                Type of the Salesforce business object, like "Account" or "Case".
+            **kwargs (dict):
+                This is a keyword / value dictionary with additional parameters that depend
+                on the object type.
 
         Returns:
             dict | None: Dictionary with the Salesforce object data or None if the request fails.
+
         """
 
         match object_type:
@@ -767,25 +811,30 @@ class Salesforce(object):
                     **kwargs,
                 )
             case _:
-                logger.error(
+                self.logger.error(
                     "Unsupported Salesforce business object -> %s!",
                     object_type,
                 )
 
+        return None
+
     # end method definition
 
-    def get_group_id(self, groupname: str) -> Optional[str]:
+    def get_group_id(self, group_name: str) -> str | None:
         """Get a group ID by group name.
 
         Args:
-            groupname (str): Name of the Group.
+            group_name (str): Name of the Group.
 
         Returns:
             Optional[str]: Technical ID of the group
+
         """
 
         return self.get_object_id_by_name(
-            object_type="Group", name=groupname, name_field="Name"
+            object_type="Group",
+            name=group_name,
+            name_field="Name",
         )
 
     # end method definition
@@ -794,10 +843,13 @@ class Salesforce(object):
         """Get a Salesforce group based on its ID.
 
         Args:
-            group_id (str): ID of the Salesforce group
+            group_id (str):
+                ID of the Salesforce group to retrieve.
 
         Returns:
-            dict | None: Dictionary with the Salesforce group data or None if the request fails.
+            dict | None:
+                Dictionary with the Salesforce group data or None if the request fails.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -806,8 +858,10 @@ class Salesforce(object):
         request_header = self.request_header()
         request_url = self.config()["groupUrl"] + group_id
 
-        logger.debug(
-            "Get Salesforce group with ID -> %s; calling -> %s", group_id, request_url
+        self.logger.debug(
+            "Get Salesforce group with ID -> %s; calling -> %s",
+            group_id,
+            request_url,
         )
 
         return self.do_request(
@@ -816,7 +870,7 @@ class Salesforce(object):
             headers=request_header,
             timeout=REQUEST_TIMEOUT,
             failure_message="Failed to get Salesforce group with ID -> {}".format(
-                group_id
+                group_id,
             ),
         )
 
@@ -831,16 +885,18 @@ class Salesforce(object):
 
         Args:
             group_name (str): Name of the new Salesforce group
+            group_type (str, optional): Type of the group. Default is "Regular".
 
         Returns:
             dict | None: Dictionary with the Salesforce Group data or None if the request fails.
 
-            Example response:
+        Example:
             {
                 'id': '00GDn000000KWE0MAO',
                 'success': True,
                 'errors': []
             }
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -851,8 +907,10 @@ class Salesforce(object):
 
         payload = {"Name": group_name, "Type": group_type}
 
-        logger.debug(
-            "Adding Salesforce group -> %s; calling -> %s", group_name, request_url
+        self.logger.debug(
+            "Adding Salesforce group -> %s; calling -> %s",
+            group_name,
+            request_url,
         )
 
         return self.do_request(
@@ -878,7 +936,8 @@ class Salesforce(object):
             update_data (dict): Dictionary containing the fields to update.
 
         Returns:
-            dict: Response from the Salesforce API.
+            dict | None: Response from the Salesforce API. None in case of an error.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -888,7 +947,7 @@ class Salesforce(object):
 
         request_url = self.config()["groupUrl"] + group_id
 
-        logger.debug(
+        self.logger.debug(
             "Update Salesforce group with ID -> %s; calling -> %s",
             group_id,
             request_url,
@@ -901,22 +960,24 @@ class Salesforce(object):
             json_data=update_data,
             timeout=REQUEST_TIMEOUT,
             failure_message="Failed to update Salesforce group with ID -> {}".format(
-                group_id
+                group_id,
             ),
         )
 
     # end method definition
 
     def get_group_members(self, group_id: str) -> list | None:
-        """Get Salesforce group members
+        """Get Salesforce group members.
 
         Args:
-            group_id (str): Id of the group to retrieve the members
+            group_id (str):
+                The ID of the group to retrieve the members.
 
         Returns:
-            list | None: result
+            list | None:
+                The group members.
 
-            Example response:
+        Example:
             {
                 'totalSize': 1,
                 'done': True,
@@ -930,6 +991,7 @@ class Salesforce(object):
                     }
                 ]
             }
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -942,7 +1004,7 @@ class Salesforce(object):
         query = f"SELECT UserOrGroupId FROM GroupMember WHERE GroupId = '{group_id}'"
         params = {"q": query}
 
-        logger.debug(
+        self.logger.debug(
             "Get members of Salesforce group with ID -> %s; calling -> %s",
             group_id,
             request_url,
@@ -955,28 +1017,32 @@ class Salesforce(object):
             params=params,
             timeout=REQUEST_TIMEOUT,
             failure_message="Failed to get members of Salesforce group with ID -> {}".format(
-                group_id
+                group_id,
             ),
         )
 
     # end method definition
 
     def add_group_member(self, group_id: str, member_id: str) -> dict | None:
-        """Add a user or group to a Salesforce group
+        """Add a user or group to a Salesforce group.
 
         Args:
-            group_id (str): ID of the Salesforce Group to add member to.
-            member_id (str): ID of the user or group.
+            group_id (str):
+                The ID of the Salesforce Group to add member to.
+            member_id (str):
+                The ID of the user or group.
 
         Returns:
-            dict | None: Dictionary with the Salesforce membership data or None if the request fails.
+            dict | None:
+                Dictionary with the Salesforce membership data or None if the request fails.
 
-            Example response (id is the membership ID):
+        Example response (id is the membership ID):
             {
                 'id': '011Dn000000ELhwIAG',
                 'success': True,
                 'errors': []
             }
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -988,7 +1054,7 @@ class Salesforce(object):
 
         payload = {"GroupId": group_id, "UserOrGroupId": member_id}
 
-        logger.debug(
+        self.logger.debug(
             "Add member with ID -> %s to Salesforce group with ID -> %s; calling -> %s",
             member_id,
             group_id,
@@ -1002,19 +1068,21 @@ class Salesforce(object):
             json_data=payload,
             timeout=REQUEST_TIMEOUT,
             failure_message="Failed to add member with ID -> {} to Salesforce group with ID -> {}".format(
-                member_id, group_id
+                member_id,
+                group_id,
             ),
         )
 
     # end method definition
 
     def get_all_user_profiles(self) -> dict | None:
-        """Get all user profiles
+        """Get all user profiles.
 
         Returns:
-            dict | None: Dictionary with salesforce user profiles.
+            dict | None:
+                Dictionary with Salesforce user profiles.
 
-            Example response:
+        Example response:
             {
                 'totalSize': 15,
                 'done': True,
@@ -1038,6 +1106,7 @@ class Salesforce(object):
                     }, ...
                 ]
             }
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -1059,7 +1128,7 @@ class Salesforce(object):
 
     # end method definition
 
-    def get_user_profile_id(self, profile_name: str) -> Optional[str]:
+    def get_user_profile_id(self, profile_name: str) -> str | None:
         """Get a user profile ID by profile name.
 
         Args:
@@ -1067,13 +1136,14 @@ class Salesforce(object):
 
         Returns:
             Optional[str]: Technical ID of the user profile.
+
         """
 
         return self.get_object_id_by_name(object_type="Profile", name=profile_name)
 
     # end method definition
 
-    def get_user_id(self, username: str) -> Optional[str]:
+    def get_user_id(self, username: str) -> str | None:
         """Get a user ID by user name.
 
         Args:
@@ -1081,10 +1151,13 @@ class Salesforce(object):
 
         Returns:
             Optional[str]: Technical ID of the user
+
         """
 
         return self.get_object_id_by_name(
-            object_type="User", name=username, name_field="Username"
+            object_type="User",
+            name=username,
+            name_field="Username",
         )
 
     # end method definition
@@ -1097,6 +1170,7 @@ class Salesforce(object):
 
         Returns:
             dict | None: Dictionary with the Salesforce user data or None if the request fails.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -1105,8 +1179,10 @@ class Salesforce(object):
         request_header = self.request_header()
         request_url = self.config()["userUrl"] + user_id
 
-        logger.debug(
-            "Get Salesforce user with ID -> %s; calling -> %s", user_id, request_url
+        self.logger.debug(
+            "Get Salesforce user with ID -> %s; calling -> %s",
+            user_id,
+            request_url,
         )
 
         return self.do_request(
@@ -1115,7 +1191,7 @@ class Salesforce(object):
             headers=request_header,
             timeout=REQUEST_TIMEOUT,
             failure_message="Failed to get Salesforce user with ID -> {}".format(
-                user_id
+                user_id,
             ),
         )
 
@@ -1130,34 +1206,48 @@ class Salesforce(object):
         title: str | None = None,
         department: str | None = None,
         company_name: str = "Innovate",
-        profile_name: Optional[str] = "Standard User",
-        profile_id: Optional[str] = None,
-        time_zone_key: Optional[str] = "America/Los_Angeles",
-        email_encoding_key: Optional[str] = "ISO-8859-1",
-        locale_key: Optional[str] = "en_US",
-        alias: Optional[str] = None,
+        profile_name: str | None = "Standard User",
+        profile_id: str | None = None,
+        time_zone_key: str | None = "America/Los_Angeles",
+        email_encoding_key: str | None = "ISO-8859-1",
+        locale_key: str | None = "en_US",
+        alias: str | None = None,
     ) -> dict | None:
         """Add a new Salesforce user. The password has to be set separately.
 
         Args:
-            username (str): Login name of the new user
-            email (str): Email of the new user
-            firstname (str): First name of the new user.
-            lastname (str): Last name of the new user.
-            title (str): Title of the user.
-            department (str): Department of the user.
-            company_name (str): Name of the Company of the user.
-            profile_name (str): Profile name like "Standard User"
-            profile_id (str, optional): Profile ID of the new user. Defaults to None.
-                                        Use method get_all_user_profiles() to determine
-                                        the desired Profile for the user. Or pass the profile_name.
-            time_zone_key (str, optional) in format country/city like "America/Los_Angeles",
-            email_encoding_key (str, optional). Default is "ISO-8859-1".
-            locale_key (str, optional). Default is "en_US".
-            alias (str, optional): Alias of the new user. Defaults to None.
+            username (str):
+                Login name of the new user
+            email (str):
+                Email of the new user
+            firstname (str):
+                First name of the new user.
+            lastname (str):
+                Last name of the new user.
+            title (str):
+                Title of the user.
+            department (str):
+                Department of the user.
+            company_name (str):
+                Name of the Company of the user.
+            profile_name (str):
+                Profile name like "Standard User"
+            profile_id (str, optional):
+                Profile ID of the new user. Defaults to None.
+                Use method get_all_user_profiles() to determine
+                the desired Profile for the user. Or pass the profile_name.
+            time_zone_key (str, optional):
+                Timezone provided in format country/city like "America/Los_Angeles",
+            email_encoding_key (str, optional):
+                Default is "ISO-8859-1".
+            locale_key (str, optional):
+                Default is "en_US".
+            alias (str, optional):
+                Alias of the new user. Defaults to None.
 
         Returns:
             dict | None: Dictionary with the Salesforce User data or None if the request fails.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -1186,8 +1276,10 @@ class Salesforce(object):
             "LanguageLocaleKey": locale_key,  # Set default LanguageLocaleKey
         }
 
-        logger.debug(
-            "Adding Salesforce user -> %s; calling -> %s", username, request_url
+        self.logger.debug(
+            "Adding Salesforce user -> %s; calling -> %s",
+            username,
+            request_url,
         )
 
         return self.do_request(
@@ -1214,6 +1306,7 @@ class Salesforce(object):
 
         Returns:
             dict: Response from the Salesforce API.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -1223,8 +1316,10 @@ class Salesforce(object):
 
         request_url = self.config()["userUrl"] + user_id
 
-        logger.debug(
-            "Update Salesforce user with ID -> %s; calling -> %s", user_id, request_url
+        self.logger.debug(
+            "Update Salesforce user with ID -> %s; calling -> %s",
+            user_id,
+            request_url,
         )
 
         return self.do_request(
@@ -1234,7 +1329,7 @@ class Salesforce(object):
             json_data=update_data,
             timeout=REQUEST_TIMEOUT,
             failure_message="Failed to update Salesforce user with ID -> {}".format(
-                user_id
+                user_id,
             ),
         )
 
@@ -1244,7 +1339,7 @@ class Salesforce(object):
         self,
         user_id: str,
         password: str,
-    ) -> dict:
+    ) -> dict | None:
         """Update the password of a Salesforce user.
 
         Args:
@@ -1253,6 +1348,7 @@ class Salesforce(object):
 
         Returns:
             dict: Response from the Salesforce API.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -1262,7 +1358,7 @@ class Salesforce(object):
 
         request_url = self.config()["userUrl"] + "{}/password".format(user_id)
 
-        logger.debug(
+        self.logger.debug(
             "Update password of Salesforce user with ID -> %s; calling -> %s",
             user_id,
             request_url,
@@ -1277,7 +1373,7 @@ class Salesforce(object):
             json_data=update_data,
             timeout=REQUEST_TIMEOUT,
             failure_message="Failed to update password of Salesforce user with ID -> {}".format(
-                user_id
+                user_id,
             ),
         )
 
@@ -1293,8 +1389,10 @@ class Salesforce(object):
         Args:
             user_id (str): Salesforce ID of the user
             photo_path (str): file system path with the location of the photo
+
         Returns:
             dict | None: Dictionary with the Salesforce User data or None if the request fails.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -1302,17 +1400,18 @@ class Salesforce(object):
 
         # Check if the photo file exists
         if not os.path.isfile(photo_path):
-            logger.error("Photo file -> %s not found!", photo_path)
+            self.logger.error("Photo file -> %s not found!", photo_path)
             return None
 
         try:
             # Read the photo file as binary data
             with open(photo_path, "rb") as image_file:
                 photo_data = image_file.read()
-        except OSError as exception:
+        except OSError:
             # Handle any errors that occurred while reading the photo file
-            logger.error(
-                "Error reading photo file -> %s; error -> %s", photo_path, exception
+            self.logger.error(
+                "Error reading photo file -> %s",
+                photo_path,
             )
             return None
 
@@ -1327,10 +1426,10 @@ class Salesforce(object):
                 photo_path,
                 photo_data,
                 "application/octet-stream",
-            )
+            ),
         }
 
-        logger.debug(
+        self.logger.debug(
             "Update profile photo of Salesforce user with ID -> %s; calling -> %s",
             user_id,
             request_url,
@@ -1344,7 +1443,7 @@ class Salesforce(object):
             data=data,
             timeout=REQUEST_TIMEOUT,
             failure_message="Failed to update profile photo of Salesforce user with ID -> {}".format(
-                user_id
+                user_id,
             ),
             verify=False,
         )
@@ -1356,11 +1455,11 @@ class Salesforce(object):
         account_name: str,
         account_number: str,
         account_type: str = "Customer",
-        description: Optional[str] = None,
-        industry: Optional[str] = None,
-        website: Optional[str] = None,
-        phone: Optional[str] = None,
-        **kwargs: Any,
+        description: str | None = None,
+        industry: str | None = None,
+        website: str | None = None,
+        phone: str | None = None,
+        **kwargs: dict[str, str],
     ) -> dict | None:
         """Add a new Account object to Salesforce.
 
@@ -1372,10 +1471,11 @@ class Salesforce(object):
             industry (str, optional): Industry of the new Salesforce account. Defaults to None.
             website (str, optional): Website of the new Salesforce account. Defaults to None.
             phone (str, optional): Phone number of the new Salesforce account. Defaults to None.
-            kwargs (Any): Additional values (e.g. custom fields)
+            kwargs (dict): Additional values (e.g. custom fields)
 
         Returns:
             dict | None: Dictionary with the Salesforce Account data or None if the request fails.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -1395,7 +1495,7 @@ class Salesforce(object):
         }
         payload.update(kwargs)  # Add additional fields from kwargs
 
-        logger.debug(
+        self.logger.debug(
             "Adding Salesforce account -> '%s' (%s); calling -> %s",
             account_name,
             account_number,
@@ -1409,7 +1509,8 @@ class Salesforce(object):
             data=json.dumps(payload),
             timeout=REQUEST_TIMEOUT,
             failure_message="Failed to add Salesforce account -> '{}' ({})".format(
-                account_name, account_number
+                account_name,
+                account_number,
             ),
         )
 
@@ -1421,18 +1522,25 @@ class Salesforce(object):
         product_code: str,
         description: str,
         price: float,
-        **kwargs: Any,
+        **kwargs: dict[str, str],
     ) -> dict | None:
         """Add a new Product object to Salesforce.
 
         Args:
-            product_name (str): Name of the Salesforce Product.
-            product_code (str): Code of the Salesforce Product.
-            description (str): Description of the Salesforce Product.
-            price (float): Price of the Salesforce Product.
+            product_name (str):
+                Name of the Salesforce Product.
+            product_code (str):
+                Code of the Salesforce Product.
+            description (str):
+                Description of the Salesforce Product.
+            price (float):
+                Price of the Salesforce Product.
+            kwargs:
+                Additional keyword arguments.
 
         Returns:
             dict | None: Dictionary with the Salesforce Product data or None if the request fails.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -1449,7 +1557,7 @@ class Salesforce(object):
         }
         payload.update(kwargs)  # Add additional fields from kwargs
 
-        logger.debug(
+        self.logger.debug(
             "Add Salesforce product -> '%s' (%s); calling -> %s",
             product_name,
             product_code,
@@ -1463,7 +1571,8 @@ class Salesforce(object):
             data=json.dumps(payload),
             timeout=REQUEST_TIMEOUT,
             failure_message="Failed to add Salesforce product -> '{}' ({})".format(
-                product_name, product_code
+                product_name,
+                product_code,
             ),
         )
 
@@ -1474,25 +1583,38 @@ class Salesforce(object):
         name: str,
         stage: str,
         close_date: str,
-        amount: Union[int, float],
+        amount: float,
         account_id: str,
-        description: str = None,
-        **kwargs: Any,
+        description: str | None = None,
+        **kwargs: dict[str, str],
     ) -> dict | None:
         """Add a new Opportunity object to Salesfoce.
 
         Args:
             name (str): Name of the Opportunity.
-            stage (str): Stage of the Opportunity. Typical Value:
-                         "Prospecting", "Qualification", "Value Proposition", "Negotiation/Review",
-                         "Closed Won", "Closed Lost"
-            close_date (str): Close date of the Opportunity. Should be in format YYYY-MM-DD.
-            amount (Union[int, float]): Amount (expected revenue) of the opportunity.
-                                        Can either be an integer or a float value.
-            account_id (str): Technical ID of the related Salesforce Account.
+            stage (str):
+                Stage of the Opportunity. Typical Value:
+                - "Prospecting"
+                - "Qualification"
+                - "Value Proposition"
+                - "Negotiation/Review",
+                - "Closed Won"
+                - "Closed Lost"
+            close_date (str):
+                Close date of the Opportunity. Should be in format YYYY-MM-DD.
+            amount (Union[int, float]):
+                Amount (expected revenue) of the opportunity.
+                Can either be an integer or a float value.
+            account_id (str):
+                The technical ID of the related Salesforce Account.
+            description (str | None, optional):
+                A description of the opportunity.
+            kwargs (dict):
+                Additional keyword arguments.
 
         Returns:
             dict | None: Dictionary with the Salesforce Opportunity data or None if the request fails.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -1512,8 +1634,10 @@ class Salesforce(object):
             payload["Description"] = description
         payload.update(kwargs)  # Add additional fields from kwargs
 
-        logger.debug(
-            "Add Salesforce opportunity -> '%s'; calling -> %s", name, request_url
+        self.logger.debug(
+            "Add Salesforce opportunity -> '%s'; calling -> %s",
+            name,
+            request_url,
         )
 
         return self.do_request(
@@ -1536,27 +1660,40 @@ class Salesforce(object):
         origin: str,
         account_id: str,
         owner_id: str,
-        asset_id: Optional[str] = None,
-        product_id: Optional[str] = None,
-        **kwargs: Any,
+        asset_id: str | None = None,
+        product_id: str | None = None,
+        **kwargs: dict[str, str],
     ) -> dict | None:
-        """Add a new Case object to Salesforce. The case number is automatically created and can not be
-           provided.
+        """Add a new Case object to Salesforce.
+
+        The case number is automatically created and can not be provided.
 
         Args:
-            subject (str): Subject (title) of the case. It's like the name.
-            description (str): Description of the case
-            status (str): Status of the case. Typecal values: "New", "On Hold", "Escalated"
-            priority (str): Priority of the case. Typical values: "High", "Medium", "Low".
-            origin (str): origin (source) of the case. Typical values: "Email", "Phone", "Web"
-            account_id (str): technical ID of the related Account
-            owner_id (str): owner of the case
-            asset_id (str): technical ID of the related Asset
-            product_id (str): technical ID of the related Product
-            kwargs (Any): additional values (e.g. custom fields)
+            subject (str):
+                Subject (title) of the case. It's like the name.
+            description (str):
+                Description of the case
+            status (str):
+                Status of the case. Typecal values: "New", "On Hold", "Escalated"
+            priority (str):
+                Priority of the case. Typical values: "High", "Medium", "Low".
+            origin (str):
+                Origin (source) of the case. Typical values: "Email", "Phone", "Web"
+            account_id (str):
+                Technical ID of the related Account
+            owner_id (str):
+                Owner of the case
+            asset_id (str):
+                Technical ID of the related Asset.
+            product_id (str):
+                Technical ID of the related Product.
+            kwargs (dict):
+                Additional values (e.g. custom fields)
 
         Returns:
-            dict | None: Dictionary with the Salesforce Case data or None if the request fails.
+            dict | None:
+                Dictionary with the Salesforce Case data or None if the request fails.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -1581,7 +1718,11 @@ class Salesforce(object):
             payload["ProductId"] = product_id
         payload.update(kwargs)  # Add additional fields from kwargs
 
-        logger.debug("Add Salesforce case -> '%s'; calling -> %s", subject, request_url)
+        self.logger.debug(
+            "Add Salesforce case -> '%s'; calling -> %s",
+            subject,
+            request_url,
+        )
 
         return self.do_request(
             method="POST",
@@ -1603,22 +1744,33 @@ class Salesforce(object):
         purchase_date: str,
         install_date: str,
         description: str | None = None,
-        **kwargs: Any,
+        **kwargs: dict[str, str],
     ) -> dict | None:
         """Add a new Asset object to Salesforce.
 
         Args:
-            asset_name (str): Name of the Asset.
-            product_id (str): Related Product ID.
-            serial_number (str): Serial Number of the Asset.
-            status (str): Status of the Asset. Typical values are "Purchased", "Shipped", "Installed", "Registered", "Obsolete"
-            purchase_date (str): Purchase date of the Asset.
-            install_date (str): Install date of the Asset.
-            description (str): Description of the Asset.
-            kwargs (Any): Additional values (e.g. custom fields)
+            asset_name (str):
+                The name of the Asset.
+            product_id (str):
+                Related Product ID.
+            serial_number (str):
+                Serial Number of the Asset.
+            status (str):
+                The status of the Asset.
+                Typical values are "Purchased", "Shipped", "Installed", "Registered", "Obsolete"
+            purchase_date (str):
+                Purchase date of the Asset.
+            install_date (str):
+                Install date of the Asset.
+            description (str):
+                Description of the Asset.
+            kwargs (dict):
+                Additional values (e.g. custom fields)
 
         Returns:
-            dict | None: Dictionary with the Salesforce Asset data or None if the request fails.
+            dict | None:
+                Dictionary with the Salesforce Asset data or None if the request fails.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -1639,8 +1791,10 @@ class Salesforce(object):
             payload["Description"] = description
         payload.update(kwargs)  # Add additional fields from kwargs
 
-        logger.debug(
-            "Add Salesforce asset -> '%s'; calling -> %s", asset_name, request_url
+        self.logger.debug(
+            "Add Salesforce asset -> '%s'; calling -> %s",
+            asset_name,
+            request_url,
         )
 
         return self.do_request(
@@ -1660,23 +1814,43 @@ class Salesforce(object):
         start_date: str,
         contract_term: int,
         status: str = "Draft",
-        description: Optional[str] = None,
-        contract_type: Optional[str] = None,
-        **kwargs: Any,
+        description: str | None = None,
+        contract_type: str | None = None,
+        **kwargs: dict[str, str],
     ) -> dict | None:
         """Add a new Contract object to Salesforce.
 
         Args:
-            account_id (str): Technical ID of the related Salesforce Account object.
-            start_date (str): Start date of the Contract. Use YYYY-MM-DD notation.
-            contract_term (int): Term of the Contract in number of months, e.g. 48 for 4 years term.
-                                 The end date of the contract will be calculated from start date + term.
-            contract_type (str): Type of the Contract. Typical values are "Subscription",
-                                 "Maintenance", "Support", "Lease", or "Service".
-            status (str): Status of the Contract. Typical values are "Draft", "Activated", or "In Approval Process"
+            account_id (str):
+                The technical ID of the related Salesforce Account object.
+            start_date (str):
+                Start date of the contract. Use YYYY-MM-DD notation.
+            contract_term (int):
+                Term of the contract in number of months, e.g. 48 for 4 years term.
+                The end date of the contract will be calculated from start date + term.
+            contract_type (str):
+                Type of the Contract. Typical values are:
+                - "Subscription"
+                - "Maintenance"
+                - "Support"
+                - "Lease"
+                - "Service"
+            status (str):
+                Status of the Contract. Typical values are:
+                - "Draft"
+                - "Activated"
+                - "In Approval Process"
+            description (str, optional):
+                Description of the contract.
+            contract_type:
+                Type name of the contract.
+            kwargs:
+                Additional keyword arguments.
 
         Returns:
-            dict | None: Dictionary with the Salesforce user data or None if the request fails.
+            dict | None:
+                Dictionary with the Salesforce contract data or None if the request fails.
+
         """
 
         if not self._access_token or not self._instance_url:
@@ -1697,7 +1871,7 @@ class Salesforce(object):
             payload["ContractType"] = contract_type
         payload.update(kwargs)  # Add additional fields from kwargs
 
-        logger.debug(
+        self.logger.debug(
             "Adding Salesforce contract for account with ID -> %s; calling -> %s",
             account_id,
             request_url,
@@ -1710,7 +1884,7 @@ class Salesforce(object):
             data=json.dumps(payload),
             timeout=REQUEST_TIMEOUT,
             failure_message="Failed to add Salesforce contract for account with ID -> {}".format(
-                account_id
+                account_id,
             ),
         )