sars 0.1.3__tar.gz

sars-0.1.3/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.3
+Name: sars
+Version: 0.1.3
+Summary: Collect information from Zoho CRM to populate the SARS TCR01 form
+Author: AMI Trading
+Author-email: support@amitrading.co.za
+Requires-Python: >=3.12.2
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: selenium (>=4.29.0,<5.0.0)
+Requires-Dist: zohocrmsdk7-0 (>=5.0.0,<6.0.0)
+Description-Content-Type: text/markdown
+
+# sars_tcr01
+Python script to collect data from Zoho CRM TCR01 module and automatically update the SARS SOQS TCR01 form along with the operators manual support
+

sars-0.1.3/README.md

@@ -0,0 +1,2 @@
+# sars_tcr01
+Python script to collect data from Zoho CRM TCR01 module and automatically update the SARS SOQS TCR01 form along with the operators manual support

sars-0.1.3/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "sars"
+version = "0.1.3"
+description = "Collect information from Zoho CRM to populate the SARS TCR01 form"
+authors = [
+    { name = "AMI Trading", email = "support@amitrading.co.za" }
+]
+readme = "README.md"
+requires-python = ">=3.12.2"
+dependencies = [
+    "selenium>=4.29.0,<5.0.0",
+    "zohocrmsdk7-0>=5.0.0,<6.0.0"
+]
+package-mode = false
+
+[project.scripts]
+appl = "sars.main:main"
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"

sars-0.1.3/sars/main.py

@@ -0,0 +1,366 @@
+import os
+from pathlib import Path
+from selenium import webdriver
+from selenium.webdriver.common.by import By
+from selenium.webdriver.support.ui import Select
+from selenium.webdriver.common.action_chains import ActionChains
+from selenium.webdriver.common.keys import Keys
+from selenium.webdriver.chrome.service import Service
+from selenium.webdriver.chrome.options import Options
+from selenium.webdriver.support.ui import WebDriverWait
+from selenium.webdriver.support import expected_conditions as EC
+import time
+from zohocrmsdk.src.com.zoho.api.authenticator import OAuthToken
+from zohocrmsdk.src.com.zoho.api.authenticator.store import FileStore
+from zohocrmsdk.src.com.zoho.crm.api.sdk_config import SDKConfig
+
+
+from zohocrmsdk.src.com.zoho.crm.api import Initializer, ParameterMap, HeaderMap
+from zohocrmsdk.src.com.zoho.crm.api.attachments import Attachment
+from zohocrmsdk.src.com.zoho.crm.api.dc import USDataCenter
+from zohocrmsdk.src.com.zoho.crm.api.layouts import MinifiedLayout
+from zohocrmsdk.src.com.zoho.crm.api.record import (
+    RecordOperations,
+    ResponseWrapper,
+    FileDetails,
+    Reminder,
+    Participants,
+    ImageUpload,
+    PricingDetails,
+    Record,
+    LineTax,
+    Comment,
+    RemindAt,
+    RecurringActivity,
+    Consent,
+    FileBodyWrapper,
+    APIException,
+    GetRecordParam,
+    GetRecordHeader,
+)
+from zohocrmsdk.src.com.zoho.crm.api.tags import Tag
+from zohocrmsdk.src.com.zoho.crm.api.taxes import Tax
+from zohocrmsdk.src.com.zoho.crm.api.users import MinifiedUser
+from zohocrmsdk.src.com.zoho.crm.api.util import Choice
+
+#Temp
+record_id = int(input("Enter your templates record ID: "))
+
+
+class GetRecord:
+    @staticmethod
+    def initialize(zoho_init_details):
+        init = {
+            "environment": USDataCenter.PRODUCTION(),
+            "client_id": zoho_init_details["client_id"],
+            "client_secret": zoho_init_details["client_secret"],
+            "refresh_token": zoho_init_details["refresh_token"],
+            "find_user": False,
+            "file_path": zoho_init_details["file_path"],
+            "resource_path": zoho_init_details["resource_path"],
+        }
+        token = OAuthToken(
+            client_id=init["client_id"],
+            client_secret=init["client_secret"],
+            refresh_token=zoho_init_details["refresh_token"],
+            find_user=False,
+        )
+        config = SDKConfig(
+            auto_refresh_fields=True,
+            pick_list_validation=False,
+            connect_timeout=None,
+            read_timeout=None,
+        )
+        Initializer.initialize(
+            init["environment"],
+            token,
+            store=FileStore(file_path=init.get("file_path")),
+            resource_path=zoho_init.get("resource_path"),
+        )
+
+    @staticmethod
+    def get_record(module_api_name, record_id):
+
+        record_operations = RecordOperations(module_api_name)
+        param_instance = ParameterMap()
+        header_instance = HeaderMap()
+        response = record_operations.get_record(
+            record_id, param_instance, header_instance
+        )
+        if response is not None:
+            print("Status Code: " + str(response.get_status_code()))
+            if response.get_status_code() in [204, 304]:
+                print(
+                    "No Content"
+                    if response.get_status_code() == 204
+                    else "Not Modified"
+                )
+                return
+            response_object = response.get_object()
+            if response_object is not None:
+                if isinstance(response_object, ResponseWrapper):
+                    record_list = response_object.get_data()
+                    for record in record_list:
+                        print("Record ID: " + str(record.get_id()))
+                        return record
+
+
+                elif isinstance(response_object, APIException):
+                    print("Status: " + response_object.get_status().get_value())
+                    print("Code: " + response_object.get_code().get_value())
+                    print("Details")
+                    details = response_object.get_details()
+                    for key, value in details.items():
+                        print(key + " : " + str(value))
+                    print("Message: " + response_object.get_message().get_value())
+
+            
+
+
+home_dir = os.path.expanduser("~")
+zoho_environment = os.environ.get("ZOHO_ENV")
+if zoho_environment is None:
+    zoho_environment = os.environ.get("ZOHO_CRM_ENV")
+zoho_cvid = {}
+
+if zoho_environment is not None and zoho_environment.lower() == "dev":
+    zoho_cvid["ZOHO_DEALS"] = "6097624000000507808"
+    zoho_cvid["ZOHO_CONTACTS"] = "6097624000000507807"
+    zoho_refresh_token = os.environ["ZOHO_REFRESH_TOKEN_DEV"]
+else:
+    zoho_cvid["ZOHO_DEALS"] = "4610371000065442049"
+    zoho_cvid["ZOHO_CONTACTS"] = "4610371000000319203"
+    zoho_refresh_token = os.environ["ZOHO_REFRESH_TOKEN"]
+
+
+zoho_file_path = Path.home() / ".ssh" / "zoho_tcr_access_token.txt"
+zoho_file_path.parent.mkdir(parents=True, exist_ok=True)
+if not zoho_file_path.exists():
+    zoho_file_path.touch()
+
+zoho_resource = Path.home() / ".zoho"
+zoho_resource.parent.mkdir(parents=True, exist_ok=True)
+zoho_resource.mkdir(parents=True, exist_ok=True)
+
+print(zoho_file_path, zoho_resource )
+
+zoho_init = {
+    "client_id": os.environ["ZOHO_CLIENT_ID"],
+    "client_secret": os.environ["ZOHO_CLIENT_SECRET"],
+    "refresh_token": zoho_refresh_token,
+    "file_path": str(zoho_file_path) ,
+    "resource_path": str(zoho_resource) + '/',
+    "cvid": zoho_cvid,
+}
+
+module_api_name = "TCRs"
+# record_id = 4610371000081837252
+GetRecord.initialize(zoho_init_details=zoho_init)
+record = GetRecord.get_record(module_api_name, record_id)
+
+# exit()
+# Initialize WebDriver
+driver = webdriver.Chrome()
+timeout = 5
+driver.implicitly_wait(timeout)
+source_type = ""
+
+
+
+def fill_input_field(field_id, value, fill = False):
+    field = driver.find_element(By.ID, field_id)
+    if fill == True and value == None:
+        field.send_keys("0")
+    elif value == None:
+        pass
+    else:
+        field.send_keys(value)
+    time.sleep(0.25)
+
+
+def fill_dropdown_field(field_name, value):
+    tcs_type_dropdown = Select(driver.find_element(By.NAME, field_name))
+    tcs_type_dropdown.select_by_visible_text("Value")
+    time.sleep(1)
+
+
+def click_radio_button(radio_id):
+    # radio_input = driver.find_element(By.CSS_SELECTOR, f"input#mat-radio-{radio_id}-input")
+    # driver.execute_script("arguments[0].click();", radio_input)
+    # time.sleep(1)  # Pause after clicking the radio button
+    pass
+
+try:
+    # Open the SARS TCR01 form
+    driver.get("https://tools.sars.gov.za/sarsonlinequery/tcr01")
+
+    # Select "Approval International Transfer" from the "TCS Type" dropdown
+    tcs_type_dropdown = Select(driver.find_element(By.ID, "tcrType"))
+    tcs_type_dropdown.select_by_visible_text("Approval International Transfer")
+    time.sleep(1)
+
+    # Fill out required fields
+    fill_input_field("generate_tcrIdNo", record.get_key_value("ID_Number"))
+    fill_input_field("generate_tcrTaxRefNo", record.get_key_value("Tax_Number"))
+
+    # Click Submit
+    driver.find_element(By.ID, "GenerateForm").click()
+    time.sleep(3)
+
+    print("Form submitted successfully!")
+
+    input("Complete the CAPTCHA and press Enter to continue...")
+
+    # Select Authorised Representative
+
+    authorised_representative_label = driver.find_element(By.XPATH, "//label[@for='mat-radio-10002-input']")
+    authorised_representative_label.click()
+
+    driver.execute_script("document.getElementById('mat-radio-10025-input').click();")
+    time.sleep(1)   
+
+    # Fill in Other Fields
+    fill_input_field("mat-input-73", "FSP 53682")  # Other Reason
+    fill_input_field("mat-input-74", "Delport")  # Surname
+    fill_input_field("mat-input-75", "Anton David")  # First Names
+    fill_input_field("mat-input-76", "AD")  # Initials
+    fill_input_field("mat-input-77", "7703105155081")  # ID Number
+    fill_input_field("mat-input-82", "0795074441")  # Cell Number
+    fill_input_field("mat-input-84", "support@amitrading.co.za")  # Email
+    
+    # Additional Fields
+    # fill_input_field("mat-input-10", "2006")  # Date Year
+    # fill_input_field("mat-input-11", "06")  # Date Month
+    # fill_input_field("mat-input-12", "20")  # Date Day
+    # fill_input_field("mat-input-8", "0")  # Home Tel No
+    # fill_input_field("mat-input-9", "1")  # Business Tel No
+
+    # Open nect oage
+    element = WebDriverWait(driver, timeout).until(
+        EC.element_to_be_clickable((By.CSS_SELECTOR, "sars-international-transfer-details gov-panel-description"))
+    )
+    element.click()
+    
+    # SA Tax Resident
+    click_radio_button("mat-radio-10008")
+    # fill_input_field("mat-input-14", "ZAF")  # Where will you be a tax resident
+    
+    # International Transfer Details
+    fill_input_field("mat-input-18", record.get_key_value("Pin_Value"))  # Total value
+    
+    # Family Unit Question
+    click_radio_button("mat-radio-10011")  # Yes
+    # click_radio_button("mat-radio-10012")  # No
+    
+    # Needs logic to work properly hidden for now
+    # Source Type
+    # fill_dropdown_field("mat-input-19", source_type.upper())  # Source Type
+    # fill_input_field("mat-input-20", "50000")  # Proportional Value
+    # source_type = source_type.lower()
+
+
+    if source_type == "Cash/Savings":
+        pass
+    elif source_type == "Distribution from Trust as a beneficiary":
+        pass
+    elif source_type == "Donation":
+        pass
+    elif source_type == "Dividents distribution from a Company":
+        pass
+    elif source_type == "Inheritance":
+        pass
+    elif source_type == "Loan":
+        pass
+    elif source_type == "Sale of Property":
+        pass
+    elif source_type == "Sale of shares and other secutities":
+        pass
+    elif source_type == "Sale of Crypto Assets":
+        pass
+    elif source_type == "Transfer of Listed Securities":
+        pass
+    elif source_type == "Other":
+        pass
+    else:
+        pass
+
+    
+    # # Trust Details
+    # fill_input_field("mat-input-120", "Example Trust")  # Registered Name of Trust
+    # fill_input_field("mat-input-121", "123456")  # Trust No
+    # fill_input_field("mat-input-122", "789101")  # Income Tax Ref No
+    # fill_input_field("mat-input-123", "200000")  # Value for Trust
+    # click_radio_button("mat-radio-10043")  # Foreign Trust
+
+    assets_liabilities = WebDriverWait(driver, timeout).until(
+        EC.element_to_be_clickable((By.XPATH, '//*[@id="mat-expansion-panel-header-5"]/span[1]/gov-panel-description'))
+    )
+    assets_liabilities.click()
+    time.sleep(1)
+
+    south_african_assets = WebDriverWait(driver, timeout).until(
+        EC.element_to_be_clickable((By.XPATH, '//*[@id="mat-expansion-panel-header-6"]/span[1]/gov-panel-title'))
+    )
+    south_african_assets.click()
+    time.sleep(1)
+    
+
+
+    # South African Assets
+    fill_input_field("mat-input-22", record.get_key_value("Fixed_Properties"), True)  # Fixed Property
+    fill_input_field("mat-input-23", record.get_key_value("Shares_in_Private_Company"), True)  # Private Company Shares
+    fill_input_field("mat-input-24", record.get_key_value("Loan_Account"), True)  # Loan Accounts
+    fill_input_field("mat-input-25", record.get_key_value("Financial_Instruments_no_crypto"), True)  # Listed Financial Instruments
+    fill_input_field("mat-input-26", record.get_key_value("Financial_Instruments_Crypto"), True)  # Crypto Assets
+    fill_input_field("mat-input-27", record.get_key_value("Capital_of_Business"), True)  # Business Capital
+    fill_input_field("mat-input-28", record.get_key_value("Equipment"), True)   # Equipment, Machinery, Implements
+    fill_input_field("mat-input-29", record.get_key_value("Motor_Vehicles"), True)   # Motor Vehicles, Caravans, Boats
+    fill_input_field("mat-input-30", record.get_key_value("Debtors"), True)   # Debtors
+    fill_input_field("mat-input-31", record.get_key_value("Stock"), True)   # Stock
+    fill_input_field("mat-input-32", record.get_key_value("Livestock"), True)   # Livestock - elected value(s)
+    fill_input_field("mat-input-33", record.get_key_value("Cash_on_Hand"), True)   # Cash on Hand, in Bank and Other Similar Institutions
+    fill_input_field("mat-input-34", record.get_key_value("Personal_Effects"), True)   # Personal Effects (jewelry, paintings, furniture, etc.)
+    fill_input_field("mat-input-35", record.get_key_value("Other_Assets"), True)   # Other Assets
+
+    # South African Liabilities
+    fill_input_field("mat-input-37", record.get_key_value("Mortgage_Bonds"), True)   # Mortgage Bonds
+    fill_input_field("mat-input-38", record.get_key_value("Loan_Accounts"), True)  # Loan Accounts
+    fill_input_field("mat-input-39", record.get_key_value("Creditors"), True)  # Creditors
+    fill_input_field("mat-input-40", record.get_key_value("Bank_Overdraft"), True)  # Bank Overdraft
+    fill_input_field("mat-input-41", record.get_key_value("Other_liabilities"), True)  # Other Liabilities)
+
+    foreign_assets = WebDriverWait(driver, timeout).until(
+        EC.element_to_be_clickable((By.XPATH, '//*[@id="mat-expansion-panel-header-9"]/span[1]/gov-panel-title'))
+    )
+    foreign_assets.click()
+
+    #foreign assets
+    fill_input_field("mat-input-43", record.get_key_value("Fixed_Properties_Forgeign"), True)  # Foreign Fixed Properties
+    fill_input_field("mat-input-44", record.get_key_value("Shares_in_Private_Company_Forgeign"), True)  # Shares in Private Company or Member’s Interest
+    fill_input_field("mat-input-45", record.get_key_value("Loan_Account_Forgeign"), True)  # Foreign Loan Accounts
+    fill_input_field("mat-input-46", record.get_key_value("FInancial_Instruments_no_crypto_Forgeign"), True)  # Financial Instruments Listed (excluding crypto)
+    fill_input_field("mat-input-47", record.get_key_value("Financial_Instruments_Crypto_Forgeign"), True)  # Crypto Assets
+    fill_input_field("mat-input-48", record.get_key_value("Capital_of_Buisness_Forgeign"), True)  # Net Capital of Business, Trade, Profession or Farming
+    fill_input_field("mat-input-49", record.get_key_value("Equipment_Forgeign"), True)  # Foreign Equipment, Machinery, Implements
+    fill_input_field("mat-input-50", record.get_key_value("Motor_Vehicles_Forgeign"), True)  # Foreign Motor Vehicles, Caravans, Boats
+    fill_input_field("mat-input-51", record.get_key_value("Debtors_Forgeign"), True)  # Foreign Debtors
+    fill_input_field("mat-input-52", record.get_key_value("Stock_Forgeign"), True)  # Foreign Stock
+    fill_input_field("mat-input-53", record.get_key_value("Livestock_Forgeign"), True)  # Foreign Livestock - elected value(s)
+    fill_input_field("mat-input-54", record.get_key_value("Cash_on_Hand_Forgeign"), True)  # Foreign Cash on Hand, in Bank
+    fill_input_field("mat-input-55", record.get_key_value("Personal_Effects_Forgeign"), True)  # Foreign Personal Effects
+    fill_input_field("mat-input-56", record.get_key_value("Other_Assets_Forgeign"), True)  # Foreign Other Assets
+
+    
+    # Foreign Liabilities
+    fill_input_field("mat-input-58", record.get_key_value("Mortgage_Bonds_Forgeign"), True)  # Foreign Mortgage Bonds
+    fill_input_field("mat-input-59", record.get_key_value("Loan_Accounts_Forgeign"), True)  # Foreign Loan Accounts
+    fill_input_field("mat-input-60", record.get_key_value("Creditors_Forgeign"), True)  # Foreign Creditors
+    fill_input_field("mat-input-61", record.get_key_value("Bank_Overdaft_Forgeign"), True)  # Foreign Bank Overdraft
+    fill_input_field("mat-input-62", record.get_key_value("Other_Liabilities_Forgeign"), True)  # Foreign Other Liabilities
+    
+    input("Complete rest manually and press Enter to finish...")
+finally:
+    driver.quit()
+
+def main():
+    pass