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

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_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_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.6.dist-info → medicafe-0.250813.0.dist-info}/METADATA

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

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

@@ -19,7 +19,7 @@ MediBot/update_medicafe.py,sha256=KuoGOsSvnNis9EgpAZe_j0Ny6ExVav3fnRQCAu4evnk,28
 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,7 +29,7 @@ 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
@@ -44,17 +44,17 @@ 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
@@ -64,7 +64,7 @@ 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.6.dist-info/LICENSE,sha256=65lb-vVujdQK7uMH3RRJSMwUW-WMrMEsc5sOaUn2xUk,1096
-medicafe-0.250812.6.dist-info/METADATA,sha256=Yj5TFAW1DhsTAh-WrLFvHJCGeF1Hvx4ywj_qTnVkTag,3384
-medicafe-0.250812.6.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-medicafe-0.250812.6.dist-info/entry_points.txt,sha256=m3RBUBjr-xRwEkKJ5W4a7NlqHZP_1rllGtjZnrRqKe8,52
-medicafe-0.250812.6.dist-info/top_level.txt,sha256=U6-WBJ9RCEjyIs0BlzbQq_PwedCp_IV9n1616NNV5zA,26
-medicafe-0.250812.6.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,,