medicafe 0.250812.5__py3-none-any.whl → 0.250813.0__py3-none-any.whl

MediBot/MediBot.bat

@@ -405,8 +405,6 @@ echo 6. Run MediBot
 echo.
 echo 7. Troubleshooting
 echo.
-echo 9. Toggle Performance Logging (session)
-echo.
 echo 8. Exit
 echo.
 set /p choice=Enter your choice:  
@@ -420,7 +418,6 @@ if "!choice!"=="4" goto united_claims_status
 if "!choice!"=="3" goto medilink_flow
 if "!choice!"=="2" goto download_emails
 if "!choice!"=="1" goto check_updates
-if "!choice!"=="9" goto toggle_perf_logging
 if "!choice!"=="0" goto end_script
 
 echo Invalid choice. Please try again.
@@ -572,7 +569,7 @@ if not exist "%_UPD_RUNNER%" (
 echo.
 echo Launching updater and closing this window...
 start "MediCafe Update" "%_UPD_RUNNER%"
-exit /b 0
+exit 0
 
 :: Download Carol's Emails
 :download_emails
@@ -636,7 +633,7 @@ if /I "%MEDICAFE_PERFORMANCE_LOGGING%"=="1" (
 echo.
 echo Note: This affects current session only. To persist, set in config.json.
 pause
-goto main_menu
+goto troubleshooting_menu
 
 :: United Claims Status
 :united_claims_status
@@ -715,14 +712,16 @@ echo Troubleshooting Options:
 echo.
 echo 1. Open Latest Log File
 echo 2. Clear Python Cache
-echo 3. Forced MediCafe version rollback - no dependencies
-echo 4. Back to Main Menu
+echo 3. Toggle Performance Logging ^(session^)
+echo 4. Forced MediCafe version rollback
+echo 5. Back to Main Menu
 echo.
 set /p tchoice=Enter your choice: 
 if "%tchoice%"=="1" goto open_latest_log
 if "%tchoice%"=="2" goto clear_cache_menu
-if "%tchoice%"=="3" goto forced_version_rollback
-if "%tchoice%"=="4" goto main_menu
+if "%tchoice%"=="3" goto toggle_perf_logging
+if "%tchoice%"=="4" goto forced_version_rollback
+if "%tchoice%"=="5" goto main_menu
 echo Invalid choice. Please try again.
 pause
 goto troubleshooting_menu
@@ -743,7 +742,7 @@ goto troubleshooting_menu
 :: End Script
 :end_script
 echo Exiting MediBot
-exit /b 0
+exit 0
 
 :: Full Debug Mode moved to external script full_debug_suite.bat
 

MediBot/MediBot_Crosswalk_Library.py

@@ -376,6 +376,8 @@ def crosswalk_update(client, config, crosswalk): # Upstream of this is only Medi
                     'medisoft_medicare_id': []  # PERFORMANCE FIX: Use list instead of set to avoid conversions
                 }
                 MediLink_ConfigLoader.log("Initialized payer ID {} in crosswalk with endpoint '{}'.".format(payer_id, selected_endpoint), config, level="DEBUG")
+                # TODO (MEDICARE ENDPOINTS): If payer_id is Medicare (e.g., in config['MediLink_Config']['cob_settings']['medicare_payer_ids']),
+                # set endpoint to 'MEDICARE_PRIMARY' and optionally store 'crossover_endpoint' for later automation.
 
             # Add the insurance ID to the payer ID entry (PERFORMANCE FIX: Use list operations)
             insurance_id_str = str(insurance_id)  # Ensure ID is string

MediBot/MediBot_Crosswalk_Utils.py

@@ -370,10 +370,12 @@ def save_crosswalk(client, config, crosswalk, skip_api_operations=False, api_cac
                     crosswalk['payer_id'][payer_id]['endpoint'] = select_endpoint(config)  # Use the helper function to set the endpoint
                     MediLink_ConfigLoader.log("Initialized 'endpoint' for payer ID {}.".format(payer_id), config, level="DEBUG")
 
-            # Initialize medisoft_id and medisoft_medicare_id as empty lists if they do not exist
-            crosswalk['payer_id'][payer_id].setdefault('medisoft_id', [])
-            crosswalk['payer_id'][payer_id].setdefault('medisoft_medicare_id', []) # does this work in 3.4.4?
-            MediLink_ConfigLoader.log("Ensured 'medisoft_id' and 'medisoft_medicare_id' for payer ID {} are initialized.".format(payer_id), config, level="DEBUG")
+        # Initialize medisoft_id and medisoft_medicare_id as empty lists if they do not exist
+        crosswalk['payer_id'][payer_id].setdefault('medisoft_id', [])
+        crosswalk['payer_id'][payer_id].setdefault('medisoft_medicare_id', []) # does this work in 3.4.4?
+        MediLink_ConfigLoader.log("Ensured 'medisoft_id' and 'medisoft_medicare_id' for payer ID {} are initialized.".format(payer_id), config, level="DEBUG")
+        # TODO (CROSSWALK VALIDATION): Enforce distinctness between 'medisoft_id' and 'medisoft_medicare_id' and support optional
+        # 'crossover_endpoint' per payer. Use config['MediLink_Config']['cob_settings']['medicare_payer_ids'] to detect Medicare payers.
         
         # Convert sets to sorted lists for JSON serialization
         for payer_id, details in crosswalk.get('payer_id', {}).items():

MediBot/MediBot_Preprocessor_lib.py

@@ -816,6 +816,11 @@ def update_insurance_ids(csv_data, config, crosswalk):
         
         # Assign the resolved insurance ID to the row
         row['Ins1 Insurance ID'] = insurance_id
+        # TODO (SECONDARY QUEUE): When building a secondary-claims queue after Medicare crossover,
+        # set claim_type='secondary' and attach prior payer fields here from the Medicare primary outcome:
+        # - row['prior_payer_name'] = 'MEDICARE'
+        # - row['prior_payer_id'] = best Medicare ID from config/crosswalk
+        # - optionally row['primary_paid_amount'], row['cas_adjustments'] extracted from 835
         processed_count += 1
         # LOGGING STRATEGY: Remove success logging - DEBUG is typically silent anyway
         # if processed_count <= 10 or processed_count % 100 == 0:  # Log first 10 and every 100th

MediBot/update_medicafe.py

@@ -1,5 +1,5 @@
 #update_medicafe.py
-import subprocess, sys, time, platform, os, shutil
+import subprocess, sys, time, platform, os, shutil, random
 
 # Safe import for pkg_resources with fallback
 try:
@@ -162,6 +162,8 @@ def get_latest_version(package, retries=3, delay=1):
                 time.sleep(delay)
     return None
 
+ 
+
 def check_internet_connection():
     try:
         requests.get("http://www.google.com", timeout=5)
@@ -288,7 +290,7 @@ def compare_versions(version1, version2):
     v2_parts = list(map(int, version2.split(".")))
     return (v1_parts > v2_parts) - (v1_parts < v2_parts)
 
-def upgrade_package(package, retries=3, delay=2):  # Updated retries to 3
+def upgrade_package(package, retries=4, delay=2, target_version=None):  # Updated retries to 4
     """
     Attempts to upgrade the package multiple times with delays in between.
     """
@@ -296,23 +298,33 @@ def upgrade_package(package, retries=3, delay=2):  # Updated retries to 3
         print_status("No internet connection detected. Please check your internet connection and try again.", "ERROR")
         print_final_result(False, "No internet connection available")
     
+    # Light verbosity: show pinned target once
+    if target_version:
+        print("Pinned target version: {}".format(target_version))
+
     for attempt in range(1, retries + 1):
-        print("Attempt {} to upgrade {}...".format(attempt, package))
+        print("Attempt {}/{} to upgrade {}...".format(attempt, retries, package))
         
         # Use a more compatible approach for Python 3.4
         # Try with --no-deps first to avoid dependency resolution issues
+        pkg_spec = package
+        if target_version:
+            pkg_spec = "{}=={}".format(package, target_version)
+
         cmd = [
             sys.executable, '-m', 'pip', 'install', '--upgrade',
-            '--no-deps', '--no-cache-dir', '--disable-pip-version-check', '-q', package
+            '--no-deps', '--no-cache-dir', '--disable-pip-version-check', '-q', pkg_spec
         ]
         
+        print("Using pip upgrade with --no-deps and --no-cache-dir")
         process = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
         stdout, stderr = process.communicate()
         
         if process.returncode == 0:
             print(stdout.decode().strip())
             new_version = get_installed_version(package)  # Get new version after upgrade
-            if compare_versions(new_version, get_latest_version(package)) >= 0:  # Compare versions
+            expected_version = target_version or get_latest_version(package)
+            if expected_version and compare_versions(new_version, expected_version) >= 0:  # Compare versions
                 if attempt == 1:
                     print_status("Upgrade succeeded!", "SUCCESS")
                 else:
@@ -320,20 +332,27 @@ def upgrade_package(package, retries=3, delay=2):  # Updated retries to 3
                 time.sleep(delay)
                 return True
             else:
-                print_status("Upgrade failed. Current version remains: {}".format(new_version), "WARNING")
+                print_status("Upgrade incomplete. Current version: {} Expected at least: {}".format(new_version, expected_version), "WARNING")
                 if attempt < retries:
                     print("Retrying in {} seconds...".format(delay))
-                    time.sleep(delay)
+                    try:
+                        time.sleep(delay + (random.random() * 0.5))
+                    except Exception:
+                        time.sleep(delay)
         else:
             print(stderr.decode().strip())
             print_status("Attempt {}: Upgrade failed with --no-deps.".format(attempt), "WARNING")
             
             # If --no-deps failed, try with --force-reinstall to bypass dependency issues
             if attempt < retries:
-                print("Retrying with --force-reinstall...")
+                print("Fallback this attempt: retrying with --force-reinstall...")
+                pkg_spec = package
+                if target_version:
+                    pkg_spec = "{}=={}".format(package, target_version)
+
                 cmd = [
                     sys.executable, '-m', 'pip', 'install', '--upgrade',
-                    '--force-reinstall', '--no-cache-dir', '--disable-pip-version-check', '-q', package
+                    '--force-reinstall', '--no-cache-dir', '--disable-pip-version-check', '-q', pkg_spec
                 ]
                 
                 process = subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
@@ -342,19 +361,23 @@ def upgrade_package(package, retries=3, delay=2):  # Updated retries to 3
                 if process.returncode == 0:
                     print(stdout.decode().strip())
                     new_version = get_installed_version(package)
-                    if compare_versions(new_version, get_latest_version(package)) >= 0:
+                    expected_version = target_version or get_latest_version(package)
+                    if expected_version and compare_versions(new_version, expected_version) >= 0:
                         print_status("Attempt {}: Upgrade succeeded with --force-reinstall!".format(attempt), "SUCCESS")
                         time.sleep(delay)
                         return True
                     else:
-                        print_status("Upgrade failed. Current version remains: {}".format(new_version), "WARNING")
+                        print_status("Upgrade incomplete. Current version: {} Expected at least: {}".format(new_version, expected_version), "WARNING")
                 else:
                     print(stderr.decode().strip())
                     print_status("Attempt {}: Upgrade failed with --force-reinstall.".format(attempt), "WARNING")
                 
                 if attempt < retries:
                     print("Retrying in {} seconds...".format(delay))
-                    time.sleep(delay)
+                    try:
+                        time.sleep(delay + (random.random() * 0.5))
+                    except Exception:
+                        time.sleep(delay)
     
     print_status("All upgrade attempts failed.", "ERROR")
     return False
@@ -566,7 +589,7 @@ def main():
         print("Current version: {}".format(current_version))
         print("Target version: {}".format(latest_version))
 
-        if upgrade_package(package):
+        if upgrade_package(package, target_version=latest_version):
             # STEP 8: Verify upgrade
             debug_step(8, "Upgrade Verification")
             new_version = get_installed_version(package)

MediCafe/api_core.py

@@ -983,18 +983,18 @@ def is_test_mode(client, body, endpoint_type):
 def submit_uhc_claim(client, x12_request_data):
     """
     Submits a UHC claim and retrieves the claim acknowledgement details.
-
+    
     This function first submits the claim using the provided x12 837p data. If the client is in Test Mode, 
     it returns a simulated response. If Test Mode is not enabled, it submits the claim and then retrieves 
     the claim acknowledgement details using the transaction ID from the initial response.
-
+    
     NOTE: This function uses endpoints that may not be available in the new swagger version:
     - /Claims/api/claim-submission/v1 (claim submission)
     - /Claims/api/claim-details/v1 (claim acknowledgement)
     
     If these endpoints are deprecated in the new swagger, this function will need to be updated
     to use the new available endpoints.
-
+    
     :param client: An instance of APIClient
     :param x12_request_data: The x12 837p data as a string
     :return: The final response containing the claim acknowledgement details or a dummy response if in Test Mode
@@ -1014,24 +1014,24 @@ def submit_uhc_claim(client, x12_request_data):
     endpoints = medi.get('endpoints', {})
     claim_submission_url = endpoints.get(endpoint_name, {}).get('additional_endpoints', {}).get('claim_submission', '')
     claim_details_url = endpoints.get(endpoint_name, {}).get('additional_endpoints', {}).get('claim_details', '')
-
+ 
     MediLink_ConfigLoader.log("Claim Submission URL: {}".format(claim_submission_url), level="INFO")
     MediLink_ConfigLoader.log("Claim Details URL: {}".format(claim_details_url), level="INFO")
-
+ 
     # Headers for the request
     headers = {'Content-Type': 'application/json'} 
-
+ 
     # Request body for claim submission
     claim_body = {'x12RequestData': x12_request_data}
-
+ 
     MediLink_ConfigLoader.log("Claim Body Keys: {}".format(list(claim_body.keys())), level="INFO")
     MediLink_ConfigLoader.log("Headers: {}".format(json.dumps(headers, indent=2)), level="INFO")
-
+ 
     # Check if Test Mode is enabled and return simulated response if so
     test_mode_response = is_test_mode(client, claim_body, 'claim_submission')
     if test_mode_response:
         return test_mode_response
-    
+ 
     # Make the API call to submit the claim
     try:
         MediLink_ConfigLoader.log("Making claim submission API call...", level="INFO")
@@ -1047,16 +1047,43 @@ def submit_uhc_claim(client, x12_request_data):
         
         # Prepare the request body for the claim acknowledgement retrieval
         acknowledgement_body = {'transactionId': transaction_id}
-
+ 
         # Check if Test Mode is enabled and return simulated response if so
         test_mode_response = is_test_mode(client, acknowledgement_body, 'claim_details')
         if test_mode_response:
             return test_mode_response
-
+ 
         # Make the API call to retrieve the claim acknowledgement details
         acknowledgement_response = client.make_api_call(endpoint_name, 'POST', claim_details_url, data=acknowledgement_body, headers=headers)
+        
+        # Persist as unified ack event (best-effort)
+        try:
+            from MediCafe.submission_index import append_ack_event, ensure_submission_index
+            cfg, _ = MediLink_ConfigLoader.load_configuration()
+            receipts_root = extract_medilink_config(cfg).get('local_claims_path', None)
+            if receipts_root:
+                ensure_submission_index(receipts_root)
+                status_text = ''
+                try:
+                    # Attempt to pull a readable status from the response
+                    status_text = acknowledgement_response.get('status') or acknowledgement_response.get('message') or ''
+                except Exception:
+                    status_text = ''
+                append_ack_event(
+                    receipts_root,
+                    '',  # claim_key unknown here
+                    status_text,
+                    'API-277',
+                    'uhcapi',
+                    {'transactionId': transaction_id},
+                    'api_ack',
+                    int(time.time())
+                )
+        except Exception:
+            pass
+        
         return acknowledgement_response
-
+ 
     except Exception as e:
         print("Error during claim processing: {}".format(e))
         raise

MediCafe/submission_index.py

@@ -22,6 +22,9 @@ META_FILENAME = 'submission_index_meta.json'
 INDEX_FILENAME = 'submission_index.jsonl'
 LOCK_FILENAME = 'submission_index.lock'
 
+# New: ack field keys for richer timeline entries
+ACK_FIELDS = ['ack_type', 'ack_timestamp', 'control_ids', 'source', 'file_name']
+
 
 def build_initial_index(receipts_root, lookback_days=200):
     """
@@ -123,6 +126,47 @@ def compute_claim_key(patient_id, payer_id, primary_insurance, date_of_service,
     ])
 
 
+def append_ack_event(receipts_root, claim_key, status_text, ack_type, file_name, control_ids, source, ack_timestamp=None):
+    """
+    Append a lightweight ack/timeline event to the index. XP/Py3.4/ASCII-safe.
+    - claim_key may be empty if unknown. Caller should pass when available.
+    - control_ids is a dict with optional ISA/GS/ST/TRN or transactionId.
+    """
+    try:
+        _ensure_files_exist(receipts_root)
+        event = {
+            'claim_key': claim_key or '',
+            'patient_id': '',
+            'payer_id': '',
+            'primary_insurance': '',
+            'dos': '',
+            'endpoint': source or 'download_ack',
+            'submitted_at': '',
+            'receipt_file': file_name or '',
+            'status': status_text or '',
+            'notes': 'ack event',
+        }
+        # Attach ack fields with basic validation
+        try:
+            event['ack_type'] = ack_type or ''
+            event['ack_timestamp'] = ack_timestamp or int(time.time())
+            event['control_ids'] = control_ids or {}
+            event['source'] = source or ''
+            event['file_name'] = file_name or ''
+        except Exception:
+            pass
+        path = _index_path(receipts_root)
+        line = json.dumps(event)
+        f = open(path, 'a')
+        try:
+            f.write(line)
+            f.write("\n")
+        finally:
+            f.close()
+    except Exception:
+        pass
+
+
 # ------------------------- ASCII-safe meta/lock helpers -----------------------
 
 def _meta_path(root_dir):

MediLink/MediLink_837p_cob_library.py

@@ -101,6 +101,10 @@ def create_2320_other_subscriber_segments(patient_data, config, crosswalk):
     is_secondary = patient_data.get('claim_type', 'primary') == 'secondary'
     
     if is_secondary:
+        # TODO (DATA CONTRACT): If 835-derived fields are present on patient_data, prefer them:
+        # - total_paid -> AMT*D
+        # - cas_adjustments -> CAS
+        # Otherwise accept 'primary_paid_amount' and 'cas_adjustments' provided by upstream workflow.
         # SBR segment for secondary payer
         responsibility_code = "S"  # Secondary
         insurance_type = determine_medicare_payer_type(patient_data, config)
@@ -111,7 +115,9 @@ def create_2320_other_subscriber_segments(patient_data, config, crosswalk):
         segments.append(sbr_segment)
         
         # AMT*D segment for total amount paid by primary
-        total_paid = patient_data.get('primary_paid_amount', '0.00')
+        # TODO (STRICT MODE): When config['MediLink_Config']['cob_settings']['validation_level'] >= 2,
+        # require presence of a numeric total (from 'total_paid' or 'primary_paid_amount').
+        total_paid = patient_data.get('total_paid', patient_data.get('primary_paid_amount', '0.00'))
         amt_segment = "AMT*D*{}~".format(total_paid)
         segments.append(amt_segment)
         
@@ -152,6 +158,7 @@ def create_2330B_prior_payer_segments(patient_data, config, crosswalk):
     segments = []
     
     # Get prior payer information
+    # TODO (CONFIG): Resolve Medicare payer ID from config['MediLink_Config']['cob_settings']['medicare_payer_ids'] if prior_payer_id not provided.
     prior_payer_name = patient_data.get('prior_payer_name', 'MEDICARE')
     prior_payer_id = patient_data.get('prior_payer_id', '00850')
     

MediLink/MediLink_837p_encoder.py

@@ -613,6 +613,12 @@ def process_claim(config, endpoint, patient_data_list, crosswalk, client, suffix
     document_segments = []
 
     for patient_data in patient_data_list:
+        # TODO (SECONDARY PREP): Upstream should mark secondary claims and provide Medicare prior payer info when applicable.
+        # Expected minimal keys for Medicare-secondary:
+        # - claim_type='secondary'
+        # - prior_payer_name='MEDICARE'
+        # - prior_payer_id from config cob_settings.medicare_payer_ids (default '00850')
+        # - optional: primary_paid_amount, cas_adjustments
         # Validate each patient's data before processing
         is_valid, validation_errors = validate_claim_data(patient_data, medi)
         if is_valid:

MediLink/MediLink_837p_encoder_library.py

@@ -980,6 +980,43 @@ def create_clm_and_related_segments(parsed_data, config, crosswalk):
     # - create_2330B_prior_payer_segments() for Medicare prior payer
     # - create_2430_service_line_cob_segments() for service-level adjudication
     # - create_2330C_other_subscriber_name_segments() when patient != subscriber
+    #
+    # Minimal, safe integration (guarded by feature flag):
+    if COB is not None:
+        cob_enabled = False
+        try:
+            # Read feature flag from configuration (expects medi['cob_settings']['enabled'])
+            from MediCafe.core_utils import extract_medilink_config
+            medi_cfg = extract_medilink_config(config)
+            cob_enabled = bool(medi_cfg.get('cob_settings', {}).get('enabled', False))
+        except Exception:
+            cob_enabled = False
+        
+        # Only add COB loops when explicitly enabled and claim is secondary
+        # TODO (COB VALIDATION): When COB is enabled and claim is secondary, validate required fields:
+        # - prior_payer_id/prior_payer_name present
+        # - primary_paid_amount present when sending AMT*D (or skip AMT if not available)
+        # - cas_adjustments schema if provided (list of {group, reason, amount})
+        # If critical fields are missing, log and proceed with best-effort unless config enforces strict mode.
+        if cob_enabled and validated_data.get('claim_type') == 'secondary':
+            try:
+                # 2320 - Other Subscriber Information (OI, AMT, CAS, etc.)
+                segments.extend(COB.create_2320_other_subscriber_segments(validated_data, config, crosswalk))
+            except Exception as _e1:
+                try:
+                    MediLink_ConfigLoader.log("COB 2320 insertion failed: {}".format(str(_e1)), config, level="WARNING")
+                except Exception:
+                    pass
+            
+            try:
+                # 2330B - Prior Payer (Medicare prior payer info, e.g., 00850)
+                segments.extend(COB.create_2330B_prior_payer_segments(validated_data, config, crosswalk))
+            except Exception as _e2:
+                try:
+                    MediLink_ConfigLoader.log("COB 2330B insertion failed: {}".format(str(_e2)), config, level="WARNING")
+                except Exception:
+                    pass
+    
     # TODO (COB ENHANCEMENT): Optional attachment references (PWK) for non-electronic EOB handling
     # See MediLink_837p_cob_library.create_pwk_attachment_segment() for implementation
     # Example: PWK*EB*FX*123456~ for attachment control number
@@ -1002,6 +1039,7 @@ def create_clm_and_related_segments(parsed_data, config, crosswalk):
     segments.append("DTP*472*D8*{}~".format(convert_date_format(validated_data['DATE'])))
     
     # Is there REF - Line Item Control Number missing here? Private insurance doesn't need it, but Medicare does?
+    # TODO (MEDICARE REF): Add conditional REF*6R (line item control number) when payer is Medicare or when crosswalk/config requires it.
     # segments.append("REF*6R*1~") # REF01, Reference Identification Qualifier; REF02, Line Item Control Number.
     # 6R - Provider Control Number (Number assigned by information provider company for tracking and billing purposes)
     # 1 - Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

MediLink/MediLink_DataMgmt.py

@@ -330,7 +330,12 @@ def operate_winscp(operation_type, files, endpoint_config, local_storage_path, c
     local_storage_path = validate_local_storage_path(local_storage_path, config)
 
     remote_directory = get_remote_directory(endpoint_config, operation_type)
-    command = build_command(winscp_path, winscp_log_path, endpoint_config, remote_directory, operation_type, files, local_storage_path)
+    if operation_type == "download":
+        # Prefer explicit ack-focused mask if not provided by endpoint
+        filemask = endpoint_config.get('filemask') or ['era', '277', '277ibr', '277ebr', '999']
+    else:
+        filemask = None
+    command = build_command(winscp_path, winscp_log_path, endpoint_config, remote_directory, operation_type, files, local_storage_path, newer_than=None, filemask=filemask)
 
     if config.get("TestMode", True):
         MediLink_ConfigLoader.log("Test mode is enabled. Simulating operation.")
@@ -470,6 +475,48 @@ def get_remote_directory(endpoint_config, operation_type):
         MediLink_ConfigLoader.log("Critical Error: Endpoint config is missing key: {}".format(e))
         raise RuntimeError("Configuration error: Missing required remote directory in endpoint configuration.")
 
+def normalize_filemask(filemask):
+    """
+    Normalize various filemask inputs into WinSCP-compatible string.
+    Supports list of extensions, comma-separated string, or dict with 'extensions' and other filters.
+    Falls back to '*' when input is invalid.
+    """
+    try:
+        if not filemask:
+            return '*'
+        if isinstance(filemask, list):
+            parts = []
+            for ext in filemask:
+                s = str(ext).strip().lstrip('*.').lstrip('.')
+                if s:
+                    parts.append('*.{}'.format(s))
+            return '|'.join(parts) if parts else '*'
+        if isinstance(filemask, dict):
+            exts = filemask.get('extensions', [])
+            other = []
+            for k, v in filemask.items():
+                if k == 'extensions':
+                    continue
+                other.append(str(v))
+            ext_part = normalize_filemask(exts)
+            other_part = ';'.join(other)
+            if ext_part and other_part:
+                return '{};{}'.format(ext_part, other_part)
+            return ext_part or other_part or '*'
+        if isinstance(filemask, str):
+            # Support comma-separated or pipe-separated lists of extensions
+            raw = filemask.replace(' ', '')
+            if any(sep in raw for sep in [',', '|']):
+                tokens = raw.replace('|', ',').split(',')
+                return normalize_filemask([t for t in tokens if t])
+            # If looks like an extension, prefix
+            s = raw.lstrip('*.').lstrip('.')
+            if s and all(ch.isalnum() for ch in s):
+                return '*.{}'.format(s)
+            return raw or '*'
+    except Exception:
+        return '*'
+
 def build_command(winscp_path, winscp_log_path, endpoint_config, remote_directory, operation_type, files, local_storage_path, newer_than=None, filemask=None):
     # Log the operation type
     MediLink_ConfigLoader.log("[Build Command] Building WinSCP command for operation type: {}".format(operation_type))
@@ -581,14 +628,7 @@ def build_command(winscp_path, winscp_log_path, endpoint_config, remote_director
                 # 5. Add validation for WinSCP-compatible patterns
                 # 6. Add logging for debugging filemask translations
                 # 7. XP QUIRK: Prefer simple masks (e.g., *.csv|*.txt) and avoid complex AND/OR until verified on XP.
-                if isinstance(filemask, list):
-                    filemask_str = '|'.join(['*.' + ext for ext in filemask])
-                elif isinstance(filemask, dict):
-                    filemask_str = '|'.join(['*.' + ext for ext in filemask.keys()])
-                elif isinstance(filemask, str):
-                    filemask_str = filemask  # Assume it's already in the correct format
-                else:
-                    filemask_str = '*'  # Default to all files if filemask is None or unsupported type
+                filemask_str = normalize_filemask(filemask)
             else:
                 filemask_str = '*'  # Default to all files if filemask is None
 
@@ -659,38 +699,25 @@ def execute_winscp_command(command, operation_type, files, local_storage_path):
         MediLink_ConfigLoader.log("WinSCP {} operation completed successfully.".format(operation_type))
 
         if operation_type == 'download':
-            downloaded_files = list_downloaded_files(local_storage_path) 
-            # TODO (HIGH PRIORITY - WinSCP Path Configuration Issue): 
-            # PROBLEM: WinSCP is not downloading files to the expected local_storage_path directory.
-            # The list_downloaded_files() function is checking the wrong location.
-            #
-            # XP/WinSCP SUGGESTION:
-            # - Add config override 'winscp_download_path' to explicitly set WinSCP's target directory.
-            # - If set, prefer list_downloaded_files(config['MediLink_Config']['winscp_download_path']).
-            # - Otherwise, parse the WinSCP log to detect the actual path and fall back to local_storage_path.
-            #
-            # INVESTIGATION STEPS:
-            # 1. Check WinSCP logs to determine actual download destination:
-            #    - Look in config['MediLink_Config']['local_claims_path'] + "winscp_download.log"
-            #    - Parse log entries for "file downloaded to:" or similar patterns
-            # 2. Compare actual WinSCP download path vs configured local_storage_path
-            # 3. Check if WinSCP uses different path conventions (forward/backward slashes)
-            #
-            # IMPLEMENTATION OPTIONS:
-            # Option A: Fix WinSCP command to use correct target directory
-            #   - Update the lcd_command generation in execute_winscp_command()
-            #   - Ensure local_storage_path is properly escaped for WinSCP
-            # Option B: Update list_downloaded_files() to check actual WinSCP location
-            #   - Add function get_actual_winscp_download_path() that parses logs
-            #   - Call list_downloaded_files(get_actual_winscp_download_path())
-            # Option C: Add configuration parameter for WinSCP-specific download path
-            #   - Add 'winscp_download_path' to config
-            #   - Default to local_storage_path if not specified
-            #
-            # RECOMMENDED: Option A (fix root cause) + Option C (explicit config)
-            # FILES TO MODIFY: This file (execute_winscp_command, list_downloaded_files functions)
-            # TESTING: Verify downloads work correctly after fix with various file types
-            MediLink_ConfigLoader.log("Files currently located in local_storage_path: {}".format(downloaded_files), level="DEBUG")
+            # Prefer configured override if present
+            winscp_download_path = None
+            try:
+                from MediCafe.core_utils import extract_medilink_config
+                config, _ = MediLink_ConfigLoader.load_configuration()
+                medi = extract_medilink_config(config)
+                winscp_download_path = medi.get('winscp_download_path')
+            except Exception:
+                winscp_download_path = None
+
+            target_dir = winscp_download_path or local_storage_path
+            downloaded_files = list_downloaded_files(target_dir)
+            MediLink_ConfigLoader.log("Files currently located in target directory ({}): {}".format(target_dir, downloaded_files), level="DEBUG")
+
+            if not downloaded_files and winscp_download_path and winscp_download_path != local_storage_path:
+                # Fallback to original path if override empty
+                fallback_files = list_downloaded_files(local_storage_path)
+                MediLink_ConfigLoader.log("Fallback to local_storage_path yielded: {}".format(fallback_files), level="DEBUG")
+                downloaded_files = fallback_files
 
             if not downloaded_files:
                 MediLink_ConfigLoader.log("No files were downloaded or an error occurred during the listing process.", level="WARNING")
@@ -727,8 +754,12 @@ def list_downloaded_files(local_storage_path):
     except Exception as e:
         MediLink_ConfigLoader.log("Error occurred while listing files in {}: {}".format(local_storage_path, e), level="ERROR")
 
-    # Ensure that the function always returns a list
-    return downloaded_files
+    # Normalize to basenames so downstream move logic in MediLink_Down works cross-platform
+    try:
+        basenames = [os.path.basename(p) for p in downloaded_files]
+        return basenames
+    except Exception:
+        return downloaded_files
 
 def detect_new_files(directory_path, file_extension='.DAT'):
     """

MediLink/MediLink_Decoder.py

@@ -20,7 +20,7 @@ else:
         return {}, {}
     def log(message, level="INFO"):
         print("[{}] {}".format(level, message))
-from MediLink_Parser import parse_era_content, parse_277_content, parse_277IBR_content, parse_277EBR_content, parse_dpt_content, parse_ebt_content, parse_ibt_content
+from MediLink_Parser import parse_era_content, parse_277_content, parse_277IBR_content, parse_277EBR_content, parse_dpt_content, parse_ebt_content, parse_ibt_content, parse_999_content
 
 # Define new_fieldnames globally
 new_fieldnames = ['Claim #', 'Payer', 'Status', 'Patient', 'Proc.', 'Serv.', 'Allowed', 'Paid', 'Pt Resp', 'Charged']
@@ -75,7 +75,8 @@ def process_decoded_file(file_path, output_directory, return_records=False, debu
         '277EBR': parse_277EBR_content,
         'DPT': parse_dpt_content,
         'EBT': parse_ebt_content,
-        'IBT': parse_ibt_content
+        'IBT': parse_ibt_content,
+        '999': parse_999_content
     }
 
     parse_function = parse_functions.get(file_type)
@@ -143,21 +144,26 @@ def format_records(records, file_type):
             claim_number = record.get('Chart Number', '')
         elif file_type == 'EBT':
             claim_number = record.get('Patient Control Number', '')
+        elif file_type == '277':
+            claim_number = record.get('Claim #', '')
+        elif file_type == '999':
+            claim_number = ''  # 999 lacks a direct claim number
         else:
             claim_number = ''  # Default to empty if file type is not recognized
 
-        # Skip records without a claim number
-        if not claim_number:
+        # Skip records without a claim number, except for 999 summary/detail rows
+        if not claim_number and file_type != '999':
             log("Record {} missing claim_number. Skipping.".format(i + 1), level="WARNING")
             continue
 
         # Check for duplicates (within this file and across files in this run)
-        if claim_number in seen_claim_numbers or claim_number in GLOBAL_SEEN_CLAIM_NUMBERS:
+        if claim_number and (claim_number in seen_claim_numbers or claim_number in GLOBAL_SEEN_CLAIM_NUMBERS):
             log("Duplicate claim_number {} found at record {}. Skipping.".format(claim_number, i + 1), level="DEBUG")
             continue
 
-        seen_claim_numbers.add(claim_number)
-        GLOBAL_SEEN_CLAIM_NUMBERS.add(claim_number)  # Add to cross-file set so later files also skip
+        if claim_number:
+            seen_claim_numbers.add(claim_number)
+            GLOBAL_SEEN_CLAIM_NUMBERS.add(claim_number)  # Add to cross-file set so later files also skip
 
         unified_record = UnifiedRecord()
 
@@ -189,8 +195,7 @@ def format_records(records, file_type):
                     'A': 'Accepted',
                     'R': 'Rejected',
                 }
-                # unified_record.status = status_mapping.get(message_type, message_type)
-                unified_record.status = record.get('Message', '')
+                unified_record.status = record.get('Message', '') or status_mapping.get(message_type, message_type)
                 unified_record.payer = record.get('Message Initiator', '')
                 unified_record.patient = record.get('Patient Name', '')
                 unified_record.proc_date = format_date(record.get('To Date', ''))
@@ -204,6 +209,30 @@ def format_records(records, file_type):
                 log("Skipped non-claim EBT Record {}: {}".format(i + 1, record), level="DEBUG")
                 continue
 
+        elif file_type == '277':
+            unified_record.claim_number = claim_number
+            unified_record.status = record.get('Status', '')
+            unified_record.patient = record.get('Patient', '')
+            unified_record.proc_date = format_date(record.get('Proc.', ''))
+            unified_record.serv_date = format_date(record.get('Serv.', ''))
+            unified_record.allowed = ''
+            unified_record.paid = record.get('Paid', '')
+            unified_record.pt_resp = ''
+            unified_record.charged = record.get('Charged', '')
+
+        elif file_type == '999':
+            # Show 999 summary rows; leave claim_number empty
+            unified_record.claim_number = ''
+            unified_record.status = record.get('Status', '')
+            unified_record.patient = ''
+            unified_record.payer = record.get('Functional ID', '')
+            unified_record.proc_date = ''
+            unified_record.serv_date = ''
+            unified_record.allowed = ''
+            unified_record.paid = ''
+            unified_record.pt_resp = ''
+            unified_record.charged = ''
+
         # Append the unified record to the list
         formatted_records.append(unified_record)
 

MediLink/MediLink_Down.py

@@ -45,6 +45,15 @@ except ImportError:
     def tqdm(iterable, **kwargs):
         return iterable
 
+try:
+    from MediCafe.submission_index import append_submission_record as _append_submission_record, ensure_submission_index as _ensure_submission_index, append_ack_event as _append_ack_event
+except ImportError:
+    # Fallback if submission_index not available
+    _append_submission_record = None
+    _ensure_submission_index = None
+    _append_ack_event = None
+
+
 def handle_files(local_storage_path, downloaded_files):
     """
     Moves downloaded files to the appropriate directory and translates them to CSV format.
@@ -55,15 +64,16 @@ def handle_files(local_storage_path, downloaded_files):
     local_response_directory = os.path.join(local_storage_path, "responses")
     os.makedirs(local_response_directory, exist_ok=True)
     
-    # Supported file extensions
-    file_extensions = ['.era', '.277', '.277ibr', '.277ebr', '.dpt', '.ebt', '.ibt', '.txt']
+    # Supported file extensions (enable ERA/277/999; keep EBT)
+    file_extensions = ['.era', '.277', '.277ibr', '.277ebr', '.999', '.dpt', '.ebt', '.ibt', '.txt']
     
     files_moved = []
     
     for file in downloaded_files:
-        if any(file.lower().endswith(ext) for ext in file_extensions):  # Case-insensitive match
+        lower = file.lower()
+        if any(lower.endswith(ext) for ext in file_extensions):  # Case-insensitive match
             source_path = os.path.join(local_storage_path, file)
-            destination_path = os.path.join(local_response_directory, file)
+            destination_path = os.path.join(local_response_directory, os.path.basename(file))
             
             try:
                 shutil.move(source_path, destination_path)
@@ -71,6 +81,8 @@ def handle_files(local_storage_path, downloaded_files):
                 files_moved.append(destination_path)
             except Exception as e:
                 log("Error moving file '{}' to '{}': {}".format(file, destination_path, e), level="ERROR")
+        else:
+            log("Skipping unsupported file '{}'.".format(file), level="DEBUG")
     
     if not files_moved:
         log("No files were moved. Ensure that files with supported extensions exist in the download directory.", level="WARNING")
@@ -93,14 +105,15 @@ def translate_files(files, output_directory):
     translated_files = []
     consolidated_records = []
     
-    # Supported file extensions with selector
+    # Enable processing for ERA, 277 family, 999, and EBT
     file_type_selector = {
-        '.era': False,
-        '.277': False,
-        '.277ibr': False,
-        '.277ebr': False,
+        '.era': True,
+        '.277': True,
+        '.277ibr': True,
+        '.277ebr': True,
+        '.999': True,
         '.dpt': False,
-        '.ebt': True,  # Only EBT files are processed
+        '.ebt': True,
         '.ibt': False,
         '.txt': False
     }
@@ -108,12 +121,24 @@ def translate_files(files, output_directory):
     file_counts = {ext: 0 for ext in file_type_selector.keys()}
 
     for file in files:
-        ext = os.path.splitext(file)[1]
+        ext = os.path.splitext(file)[1].lower()
         if file_type_selector.get(ext, False):  # Check if the file type is selected
             file_counts[ext] += 1
 
             try:
-                records = process_decoded_file(os.path.join(output_directory, file), output_directory, return_records=True)
+                src_path = os.path.join(output_directory, os.path.basename(file))
+                records = process_decoded_file(src_path, output_directory, return_records=True)
+                # Annotate records with source metadata for downstream persistence
+                try:
+                    mtime = os.path.getmtime(src_path)
+                except Exception:
+                    mtime = None
+                for r in records:
+                    try:
+                        setattr(r, 'source_file', src_path)
+                        setattr(r, 'source_mtime', mtime)
+                    except Exception:
+                        pass
                 consolidated_records.extend(records)
                 csv_file_path = os.path.join(output_directory, os.path.basename(file) + '_decoded.csv')
                 translated_files.append(csv_file_path)
@@ -122,11 +147,34 @@ def translate_files(files, output_directory):
                 log("Unsupported file type: {}".format(file), level="WARNING")
             except Exception as e:
                 log("Error processing file {}: {}".format(file, e), level="ERROR")
+        else:
+            log("Skipping unselected file type for '{}'.".format(file), level="DEBUG")
 
     log("Detected and processed file counts by type:")
     for ext, count in file_counts.items():
         log("{}: {} files detected".format(ext, count), level="INFO")
 
+    # Simple, elegant summary for console UI
+    try:
+        if consolidated_records:
+            total = len(consolidated_records)
+            num_rejected = 0
+            num_accepted = 0
+            for r in consolidated_records:
+                status = getattr(r, 'status', '') if hasattr(r, 'status') else r.get('Status', '')
+                if status:
+                    if ('Reject' in status) or (':' in status and status.upper().startswith('R')):
+                        num_rejected += 1
+                    elif ('Accept' in status) or (':' in status and status.upper().startswith('A')):
+                        num_accepted += 1
+            print("\nAcknowledgements Summary:")
+            print("  Total records: {}".format(total))
+            print("  Accepted: {}".format(num_accepted))
+            print("  Rejected: {}".format(num_rejected))
+            print("")
+    except Exception:
+        pass
+
     return consolidated_records, translated_files
 
 def prompt_csv_export(records, output_directory):
@@ -134,6 +182,50 @@ def prompt_csv_export(records, output_directory):
     Prompts the user to export consolidated records to a CSV file.
     """
     if records:
+        # Persist lightweight ack events into receipts index (optional, best-effort)
+        try:
+            config, _ = load_configuration()
+            medi = extract_medilink_config(config)
+            receipts_root = medi.get('local_claims_path', None)
+            if receipts_root and _ensure_submission_index and _append_ack_event:
+                _ensure_submission_index(receipts_root)
+                for rec in records:
+                    try:
+                        # rec may be UnifiedRecord; convert
+                        if hasattr(rec, 'to_dict'):
+                            d = rec.to_dict()
+                        else:
+                            d = rec
+                        claim_no = d.get('Claim #', '')
+                        status_text = d.get('Status', '')
+                        # infer ack_type by presence of fields
+                        ack_type = ''
+                        if d.get('Paid', '') != '' or d.get('Allowed', '') != '':
+                            ack_type = 'ERA'
+                        elif status_text and ':' in status_text:
+                            ack_type = '277'
+                        else:
+                            ack_type = 'EBT'  # default for text notifications
+                        # Use file metadata when available
+                        file_name = os.path.basename(getattr(rec, 'source_file', '')) if hasattr(rec, 'source_file') else 'responses'
+                        ts = getattr(rec, 'source_mtime', None)
+                        control_ids = {}
+                        if claim_no:
+                            _append_ack_event(
+                                receipts_root,
+                                '',  # claim_key unknown here
+                                status_text,
+                                ack_type,
+                                file_name,
+                                control_ids,
+                                'download_ack',
+                                int(ts) if isinstance(ts, (int, float)) else None
+                            )
+                    except Exception:
+                        continue
+        except Exception:
+            pass
+        
         user_input = input("Do you want to export the consolidated records to a CSV file? (y/n): ")
         if user_input.lower() == 'y':
             output_file_path = os.path.join(output_directory, "Consolidated_Records.csv")

MediLink/MediLink_Parser.py

@@ -241,4 +241,83 @@ def parse_ibt_content(content, debug=False):
         for data in extracted_data:
             print(data)
 
-    return extracted_data
+    return extracted_data
+
+def parse_999_content(content, debug=False):
+    """
+    Minimal 999 Implementation Acknowledgment parser.
+    Extracts overall transaction set acknowledgment (AK9) and per-set (AK5) statuses when available.
+    Returns a list with a single summary dict plus optional per-set entries.
+    """
+    records = []
+    segments = content.split('~')
+    overall_status = None
+    functional_id = None
+    control_numbers = []  # AK2 ST02 values
+    per_set_statuses = []  # List of {'set_control': str, 'status': str}
+
+    for seg in segments:
+        parts = seg.split('*')
+        if not parts or not parts[0]:
+            continue
+        tag = parts[0]
+        if tag == 'AK1' and len(parts) > 1:
+            functional_id = parts[1]
+        elif tag == 'AK2' and len(parts) > 2:
+            # Transaction Set Acknowledgment - capture ST02 control number
+            control_numbers.append(parts[2])
+        elif tag == 'AK5' and len(parts) > 1:
+            # Transaction Set Response Trailer - status code in AK5-01 (A, E, R)
+            status_code = parts[1]
+            per_set_statuses.append({'status': status_code})
+        elif tag == 'AK9' and len(parts) > 1:
+            # Functional Group Response Trailer - overall status in AK9-01
+            overall_status = parts[1]
+
+    # Map X12 codes to friendly text
+    status_map = {'A': 'Accepted', 'E': 'Accepted with Errors', 'R': 'Rejected'}
+    overall_text = status_map.get(overall_status, overall_status or '')
+
+    summary = {
+        'Ack Type': '999',
+        'Functional ID': functional_id or '',
+        'Status': overall_text,
+        'Sets Acknowledged': len(control_numbers) if control_numbers else 0,
+    }
+    records.append(summary)
+
+    # Optionally include per-set detail rows
+    for idx, st in enumerate(per_set_statuses):
+        detail = {
+            'Ack Type': '999',
+            'Functional ID': functional_id or '',
+            'Set #': str(idx + 1),
+            'Status': status_map.get(st.get('status', ''), st.get('status', '')),
+        }
+        # Claim # not available in 999; leave out
+        records.append(detail)
+
+    if debug:
+        print('Parsed 999 Content:')
+        for r in records:
+            print(r)
+    return records
+
+def determine_file_type(file_path):
+    file_extensions = {
+        '.era': 'ERA',
+        '.277': '277',
+        '.277ibr': '277IBR',
+        '.277ebr': '277EBR',
+        '.dpt': 'DPT',
+        '.ebt': 'EBT',
+        '.ibt': 'IBT',
+        '.999': '999'
+    }
+    
+    for ext, file_type in file_extensions.items():
+        if file_path.endswith(ext):
+            return file_type
+            
+    log("Unsupported file type for file: {}".format(file_path))
+    return None

MediLink/MediLink_UI.py

@@ -201,6 +201,8 @@ def select_and_adjust_files(detailed_patient_data, config, crosswalk):
                 )
                 if updated_crosswalk:
                     crosswalk = updated_crosswalk
+                # TODO (MEDICARE ROUTING): If original primary was Medicare and crossover failed, prompt to create secondary claim
+                # and set claim_type='secondary' with prior_payer fields for the selected patient.
             else:
                 print("Invalid selection. Keeping the current endpoint.")
                 data['confirmed_endpoint'] = current_effective_endpoint

MediLink/MediLink_main.py

@@ -54,6 +54,10 @@ if PERFORMANCE_LOGGING:
 # - XP note: default to console prompts; optional UI later.
 # This already happens when MediLink is opened.
 
+# Simple in-process scheduler for ack polls
+_last_ack_updated_at = None
+_scheduled_ack_checks = []  # list of epoch timestamps
+
 def _tools_menu(config, medi):
     """Low-use maintenance tools submenu."""
     while True:
@@ -179,12 +183,63 @@ def main_menu():
     if PERFORMANCE_LOGGING:
         print("Main menu initialization completed in {:.2f} seconds".format(menu_init_end - menu_start_time))
 
+    # Validate the calculated date range
+    try:
+        from datetime import datetime, timedelta
+        current_date = datetime.now()
+        start_date = current_date - timedelta(days=15)  # Default to 15-day range
+        end_date = current_date - timedelta(days=1)
+        def validate_date_range(start_date, end_date):
+            if start_date > end_date:
+                raise ValueError("Start date cannot be after end date.")
+            if start_date < (current_date - timedelta(days=30)): # Ensure it's not too far in the past
+                raise ValueError("Start date must be within the last 30 days.")
+            if end_date < (current_date - timedelta(days=30)): # Ensure it's not too far in the past
+                raise ValueError("End date must be within the last 30 days.")
+    except ImportError:
+        print("Date validation requires the 'datetime' module. Please ensure it's installed.")
+        # Fallback to a safe date range within 30 days
+        end_date = current_date - timedelta(days=1)
+        start_date = end_date - timedelta(days=15)  # 15-day range as fallback
+
+    end_date_str = end_date.strftime('%m/%d/%Y')
+    start_date_str = start_date.strftime('%m/%d/%Y')
+
+    # Boot-time one-time ack poll (silent policy: just show summary output)
+    try:
+        print("\nChecking acknowledgements (boot-time scan)...")
+        MediLink_Down.check_for_new_remittances(config)
+        _last_ack_updated_at = int(time.time())
+    except Exception:
+        pass
+
     while True:
+        # Run any due scheduled ack checks before showing menu
+        try:
+            now_ts = int(time.time())
+            if _scheduled_ack_checks:
+                due = [t for t in _scheduled_ack_checks if t <= now_ts]
+                if due:
+                    print("\nAuto-checking acknowledgements (scheduled)...")
+                    MediLink_Down.check_for_new_remittances(config)
+                    _last_ack_updated_at = now_ts
+                    # remove executed
+                    _scheduled_ack_checks = [t for t in _scheduled_ack_checks if t > now_ts]
+        except Exception:
+            pass
+
         # Define static menu options for consistent numbering
         options = ["Check for new remittances", "Submit claims", "Exit", "Tools"]
 
         # Display the menu options.
         menu_display_start = time.time()
+        # Show last updated info if available
+        try:
+            if _last_ack_updated_at:
+                ts_str = time.strftime('%Y-%m-%d %H:%M:%S', time.localtime(_last_ack_updated_at))
+                print("Last acknowledgements update: {}".format(ts_str))
+        except Exception:
+            pass
         MediLink_UI.display_menu(options)
         menu_display_end = time.time()
         if PERFORMANCE_LOGGING:
@@ -201,9 +256,15 @@ def main_menu():
             # Handle remittance checking.
             remittance_start = time.time()
             MediLink_Down.check_for_new_remittances(config)
+            _last_ack_updated_at = int(time.time())
             remittance_end = time.time()
             if PERFORMANCE_LOGGING:
                 print("Remittance check completed in {:.2f} seconds".format(remittance_end - remittance_start))
+            # UX hint: suggest deeper United details
+            try:
+                print("Tip: For United details, run the United Claims Status option for the same date window.")
+            except Exception:
+                pass
         elif choice == '2':
             if not all_files:
                 print("No files available to submit. Please check for new remittances first.")
@@ -226,6 +287,14 @@ def main_menu():
             
             # Process the claims submission.
             handle_submission(detailed_patient_data, config, crosswalk)
+            # Schedule ack checks for SFTP-based systems post-submit: T+90s and T+7200s
+            try:
+                now_ts2 = int(time.time())
+                _scheduled_ack_checks.append(now_ts2 + 90)
+                _scheduled_ack_checks.append(now_ts2 + 7200)
+                print("Scheduled acknowledgements checks in 1-2 minutes and again ~2 hours.")
+            except Exception:
+                pass
             submission_end = time.time()
             if PERFORMANCE_LOGGING:
                 print("Claims submission flow completed in {:.2f} seconds".format(submission_end - submission_start))

{medicafe-0.250812.5.dist-info → medicafe-0.250813.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: medicafe
-Version: 0.250812.5
+Version: 0.250813.0
 Summary: MediCafe
 Home-page: https://github.com/katanada2/MediCafe
 Author: Daniel Vidaud

{medicafe-0.250812.5.dist-info → medicafe-0.250813.0.dist-info}/RECORD

@@ -1,11 +1,11 @@
-MediBot/MediBot.bat,sha256=-Iz8EJDWkSsfSTyZfUjYWuyq47JAZmxM8inuNrt6KUU,26704
+MediBot/MediBot.bat,sha256=el_8wWuikLkL-cmMX63L3VC0EqcuulkIFaT4xv7suzY,26687
 MediBot/MediBot.py,sha256=sHE2vqaXvjiISKuvTvymhur3Ho9smVKuvvPvHbgnluc,36019
 MediBot/MediBot_Charges.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-MediBot/MediBot_Crosswalk_Library.py,sha256=HZHbjKHhjLW2jERmLS6pEZOl-MUxUu1YwA6oUltfdkE,24693
-MediBot/MediBot_Crosswalk_Utils.py,sha256=HQXZUWDZF_LvOMLsdjlsDQ79Yi_IiqNVRKX2Cd0A6x8,38762
+MediBot/MediBot_Crosswalk_Library.py,sha256=K_cz2o1e86qKKRRDcjb6eu5T6rtBgOK-R1nA8t8Z8QA,24957
+MediBot/MediBot_Crosswalk_Utils.py,sha256=KVq2budurwdHB7dglOuPZEQGup-hjD1SeSPyySLpy9M,39015
 MediBot/MediBot_Post.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 MediBot/MediBot_Preprocessor.py,sha256=zAcfyuE8wl9JRzLGsUnnXiHxAr-hbCCIB2M-Jb3LUqI,16203
-MediBot/MediBot_Preprocessor_lib.py,sha256=CWl0urrEYvbrqWeJ64U8npGcjxVvj6hgUZCBdekGAs4,72734
+MediBot/MediBot_Preprocessor_lib.py,sha256=oHQ6_3RUR-X6tikKPpVjOMwHjIRgZ9IKARgje8tj8l0,73162
 MediBot/MediBot_UI.py,sha256=h-vcf5zMPgbK2uiwOFaqUDHqgZ-sKZJ5VvaoTdpjMtE,14305
 MediBot/MediBot_dataformat_library.py,sha256=dxh_SQQMEd9nCEeuBr-6E_Uu6enjLXeoyLpd45nUcZk,10771
 MediBot/MediBot_docx_decoder.py,sha256=gn7I7Ng5khVIzU0HTTOqi31YSSn1yW8Pyk-i_P9r1oA,32472
@@ -15,11 +15,11 @@ MediBot/PDF_to_CSV_Cleaner.py,sha256=ZZphmq-5K04DkrZNlcwNAIoZPOD_ROWvS3PMkKFxeiM
 MediBot/__init__.py,sha256=6IdVLXaWxV5ZdpefonWrC1R8RsJn4V26K0PmUEZ_vU8,3192
 MediBot/get_medicafe_version.py,sha256=uyL_UIE42MyFuJ3SRYxJp8sZx8xjTqlYZ3FdQuxLduY,728
 MediBot/update_json.py,sha256=vvUF4mKCuaVly8MmoadDO59M231fCIInc0KI1EtDtPA,3704
-MediBot/update_medicafe.py,sha256=siOd8s_9jYvSZ-Z5h2enc8Wu6jY7g-G7MLYSMV0IIcY,27445
+MediBot/update_medicafe.py,sha256=KuoGOsSvnNis9EgpAZe_j0Ny6ExVav3fnRQCAu4evnk,28560
 MediCafe/MediLink_ConfigLoader.py,sha256=Ia79dZQBvgbc6CtOaNZVlFHaN-fvUmJRpmmVHz_MFv8,8205
 MediCafe/__init__.py,sha256=DF0XUu3G43AejXvEmd5aCyy0GDQahQD0pMwexmxem-E,5477
 MediCafe/__main__.py,sha256=mRNyk3D9Ilnu2XhgVI_rut7r5Ro7UIKtwV871giAHI8,12992
-MediCafe/api_core.py,sha256=1Vvez4aqJEYp5ymk6QAgmTCech1hadqYr92NptnxC1U,65245
+MediCafe/api_core.py,sha256=rF-8XNc6ILSsoD_YQV-L9R_nW9_XAd0D4VMgqAMY5U4,66420
 MediCafe/api_core_backup.py,sha256=Oy_Fqt0SEvGkQN1Oqw5iUPVFxPEokyju5CuPEb9k0OY,18686
 MediCafe/api_factory.py,sha256=I5AeJoyu6m7oCrjc2OvVvO_4KSBRutTsR1riiWhTZV0,12086
 MediCafe/api_utils.py,sha256=KWQB0q1k5E6frOFFlKWcFpHNcqfrS7KJ_82672wbupw,14041
@@ -29,13 +29,13 @@ MediCafe/logging_config.py,sha256=auT65LN5oDEXVhkMeLke63kJHTWxYf2o8YihAfQFgzU,54
 MediCafe/logging_demo.py,sha256=TwUhzafna5pMdN3zSKGrpUWRqX96F1JGGsSUtr3dygs,1975
 MediCafe/migration_helpers.py,sha256=48GnP4xcgvDNNlzoWsKASCpF4H0KnyveHPbz6kjQy50,17737
 MediCafe/smart_import.py,sha256=23pttO7QTZyvOP9HR9czDIv7lUsE1sHaE2CWC94Xxxo,19800
-MediCafe/submission_index.py,sha256=PPKpNSBuWZQ7hgekIU7sRSB_yLXUlGOBKutaurbHfPA,9576
+MediCafe/submission_index.py,sha256=35gz8Anx1dIqG1I14GvuLY0nTO4dSBr2YsZwof9aIQg,11175
 MediLink/InsuranceTypeService.py,sha256=FKWC1nRfKV_OtCDUtZustauXNhmCYDFiY9jsAGHPPUM,2178
 MediLink/MediLink.py,sha256=p91MYghOCbNf3ikTzm5P9V1Luj035yd83EDbQ-Ov6oM,33258
 MediLink/MediLink_277_decoder.py,sha256=Z3hQK2j-YzdXjov6aDlDRc7M_auFBnl3se4OF5q6_04,4358
-MediLink/MediLink_837p_cob_library.py,sha256=Q1hc1f_JQZT_QUMuL9sbIiWM6WtYFB_T4q1vQIcuurM,30003
-MediLink/MediLink_837p_encoder.py,sha256=kIcsO8im-sMtKnx0wN1IDXD4Lz0juSjiO33z0pncB-4,31780
-MediLink/MediLink_837p_encoder_library.py,sha256=0ruNcdts0n1tjBFK7VZNAMRCfjN2dmJfeEdkbW3YN-c,67821
+MediLink/MediLink_837p_cob_library.py,sha256=glc7SJBDx0taCGmwmCs81GFJJcvA_D7nycIkTfmIuwE,30650
+MediLink/MediLink_837p_encoder.py,sha256=9rMYpvfQ-KwS1Xjo1fKtg1emxdYZBMkr9QAQPP7myeg,32191
+MediLink/MediLink_837p_encoder_library.py,sha256=6NnB5yPt46dmn75DTSsMCIw284FrHR7Vf-3Wr9aVBzM,69985
 MediLink/MediLink_837p_utilities.py,sha256=28H4F6HNXgNHpdnardKWeTPuXgVSzuvu5QEPmkCGp8Q,16285
 MediLink/MediLink_API_Generator.py,sha256=UUml-PBU3BQduun8RzFH4zfUuo6-p5Ufg7b6Vic-VrY,11171
 MediLink/MediLink_API_v2.py,sha256=mcIgLnXPS_NaUBrkKJ8mxCUaQ0AuQUeU1vG6DoplbVY,7733
@@ -44,27 +44,27 @@ MediLink/MediLink_APIs.py,sha256=jm3f9T034MJKH8A_CIootULoeuk7H8s7PazpFZRCbKI,622
 MediLink/MediLink_Azure.py,sha256=Ow70jctiHFIylskBExN7WUoRgrKOvBR6jNTnQMk6lJA,210
 MediLink/MediLink_ClaimStatus.py,sha256=cO9drHSIBtltHfLSKeEf18_m75ixpxIOao5I-TGiHiI,18100
 MediLink/MediLink_ConfigLoader.py,sha256=u9ecB0SIN7zuJAo8KcoQys95BtyAo-8S2n4mRd0S3XU,4356
-MediLink/MediLink_DataMgmt.py,sha256=GVKOkzJNRFZpvgcJ5WZi_2zLya_YH-w1hR4hhHDLvJ0,51840
-MediLink/MediLink_Decoder.py,sha256=194pMSZDs9vhQW6_gZB_s-j_TTq7GYCXH2k0rwbZQeE,14977
+MediLink/MediLink_DataMgmt.py,sha256=dKJtq8BibgGsfnTyWmayX4cTPWB8zgFMsgwKJVb7cJ8,52369
+MediLink/MediLink_Decoder.py,sha256=1gzdybNg4Vv69s5PNbX8bPNrXT_N_kPpFpt2HpkauWA,16430
 MediLink/MediLink_Deductible.py,sha256=fLBDQHDcTk86JtJUtUwrVl-o0KfNackFrWosMxr7qHU,45559
 MediLink/MediLink_Deductible_Validator.py,sha256=2g-lZd-Y5fJ1mfP87vM6oABg0t5Om-7EkEkilVvDWYY,22888
 MediLink/MediLink_Display_Utils.py,sha256=QyHk23VU1rJtNZr_QhtL76Avo66CEc7MZU84uIs-1Lo,4187
-MediLink/MediLink_Down.py,sha256=-jcj4KbecSQ1kmyx0V2VCjZJcotjVnZTE5Ig6XB1x8M,11830
+MediLink/MediLink_Down.py,sha256=us3xKM5AcGpvqnbrKkV8iEt7MmLCkSU7CDFfCoqXO4o,16201
 MediLink/MediLink_ERA_decoder.py,sha256=MiOtDcXnmevPfHAahIlTLlUc14VcQWAor9Xa7clA2Ts,8710
 MediLink/MediLink_Gmail.py,sha256=8iQjqcJMSa_Zfr5azR0dShKAQeXqt-9C-s8seYB9pic,23961
 MediLink/MediLink_GraphQL.py,sha256=O6OCaumT0zIC7YcIAwLOOYxiQnYhoMc48UL8ilNIBec,45720
 MediLink/MediLink_Mailer.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-MediLink/MediLink_Parser.py,sha256=w2ZD4minjwkaMz7nzP_r8v_Ow_uM5KHjpPSY8mIHcdE,9787
+MediLink/MediLink_Parser.py,sha256=eRVZ4ckZ5gDOrcvtCUZP3DOd3Djly66rCIk0aYXLz14,12567
 MediLink/MediLink_PatientProcessor.py,sha256=9r2w4p45d30Tn0kbXL3j5574MYOehP83tDirNOw_Aek,19977
 MediLink/MediLink_Scan.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 MediLink/MediLink_Scheduler.py,sha256=UJvxhDvHraqra2_TlQVlGeh5jRFrrfK6nCVUHnKOEMY,38
 MediLink/MediLink_StatusCheck.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-MediLink/MediLink_UI.py,sha256=hpImDIeDHTMZITOMH99vbVc2vLi-219OkWyPJoVBjZ4,9047
+MediLink/MediLink_UI.py,sha256=6OR2obKUuBO12l3k6B53MXu1a3fCiV3FVBE2QrIYRqk,9279
 MediLink/MediLink_Up.py,sha256=QFdUtpEySc7ceZfFJ2q9XWClnhYJssG-UywFFedlv9w,34899
 MediLink/MediLink_api_utils.py,sha256=dsGLRPRvSwfXPLrrfgnkIKGDIF00wE93TrDB6HMDPQU,11857
 MediLink/MediLink_batch.bat,sha256=nqL5QwCLyRQFSPdv6kgtcV_cpky7FXSOWVl6OxjRXb4,118
 MediLink/MediLink_insurance_utils.py,sha256=g741Fj2K26cMy0JX5d_XavMw9LgkK6hjaUJYfysT7t8,9301
-MediLink/MediLink_main.py,sha256=BwB6BXDT1xnCqqE1M-6FYM_xUS8E17OObZP7KYM0TN0,18424
+MediLink/MediLink_main.py,sha256=iyMcEToFl2aPHP6xE51OnHQqqbGBh0owRqUfFV1F01M,21745
 MediLink/MediLink_smart_import.py,sha256=B5SfBn_4bYEWJJDolXbjnwKx_-MaqGZ76LyXQwWDV80,9838
 MediLink/Soumit_api.py,sha256=5JfOecK98ZC6NpZklZW2AkOzkjvrbYxpJpZNH3rFxDw,497
 MediLink/__init__.py,sha256=Z4Uxt4XZk4n-GwAkUoEeFiL-D7xHbttYiiWGjgKT_ng,3391
@@ -77,9 +77,9 @@ MediLink/test_cob_library.py,sha256=wUMv0-Y6fNsKcAs8Z9LwfmEBRO7oBzBAfWmmzwoNd1g,
 MediLink/test_timing.py,sha256=yH2b8QPLDlp1Zy5AhgtjzjnDHNGhAD16ZtXtZzzESZw,2042
 MediLink/test_validation.py,sha256=FJrfdUFK--xRScIzrHCg1JeGdm0uJEoRnq6CgkP2lwM,4154
 MediLink/webapp.html,sha256=JPKT559aFVBi1r42Hz7C77Jj0teZZRumPhBev8eSOLk,19806
-medicafe-0.250812.5.dist-info/LICENSE,sha256=65lb-vVujdQK7uMH3RRJSMwUW-WMrMEsc5sOaUn2xUk,1096
-medicafe-0.250812.5.dist-info/METADATA,sha256=UMzdPicc3mzjDsoRTP3ZsH5NbBKJPqflV0H7PkDEpKE,3384
-medicafe-0.250812.5.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-medicafe-0.250812.5.dist-info/entry_points.txt,sha256=m3RBUBjr-xRwEkKJ5W4a7NlqHZP_1rllGtjZnrRqKe8,52
-medicafe-0.250812.5.dist-info/top_level.txt,sha256=U6-WBJ9RCEjyIs0BlzbQq_PwedCp_IV9n1616NNV5zA,26
-medicafe-0.250812.5.dist-info/RECORD,,
+medicafe-0.250813.0.dist-info/LICENSE,sha256=65lb-vVujdQK7uMH3RRJSMwUW-WMrMEsc5sOaUn2xUk,1096
+medicafe-0.250813.0.dist-info/METADATA,sha256=0dCrp1oFMB5Y1CdIUbqVjsuXrm0JFUionXfh9D7TuKk,3384
+medicafe-0.250813.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+medicafe-0.250813.0.dist-info/entry_points.txt,sha256=m3RBUBjr-xRwEkKJ5W4a7NlqHZP_1rllGtjZnrRqKe8,52
+medicafe-0.250813.0.dist-info/top_level.txt,sha256=U6-WBJ9RCEjyIs0BlzbQq_PwedCp_IV9n1616NNV5zA,26
+medicafe-0.250813.0.dist-info/RECORD,,