medicafe 0.250711.1__py3-none-any.whl → 0.250720.1__py3-none-any.whl

MediLink/MediLink_837p_encoder.py

@@ -4,6 +4,8 @@ from datetime import datetime
 import MediLink_ConfigLoader
 from MediLink_DataMgmt import parse_fixed_width_data, read_fixed_width_data
 import MediLink_837p_encoder_library
+# TODO (COB ENHANCEMENT): Import COB library when implementing Medicare and secondary claim support
+# import MediLink_837p_cob_library
 #from tqdm import tqdm
 
 def format_single_claim(patient_data, config, endpoint, transaction_set_control_number, crosswalk, client):
@@ -46,7 +48,18 @@ def format_single_claim(patient_data, config, endpoint, transaction_set_control_
     
     # Subscriber information, possibly including endpoint-specific logic
     segments.extend(MediLink_837p_encoder_library.create_hl_subscriber_segment())
+    
+    # TODO (COB ENHANCEMENT): Enhanced SBR segment creation for COB scenarios
+    # Replace the standard SBR segment creation with enhanced COB-aware version
+    # Current: segments.append(MediLink_837p_encoder_library.create_sbr_segment(config, patient_data, endpoint))
+    # Enhanced: 
+    # if patient_data.get('claim_type') == 'secondary':
+    #     enhanced_sbr = MediLink_837p_cob_library.create_enhanced_sbr_segment(patient_data, config, crosswalk)
+    #     segments.append(enhanced_sbr)
+    # else:
+    #     segments.append(MediLink_837p_encoder_library.create_sbr_segment(config, patient_data, endpoint))
     segments.append(MediLink_837p_encoder_library.create_sbr_segment(config, patient_data, endpoint))
+    
     segments.append(MediLink_837p_encoder_library.create_nm1_subscriber_segment(config, patient_data, endpoint))
     segments.extend(MediLink_837p_encoder_library.create_subscriber_address_segments(patient_data))
     segments.append(MediLink_837p_encoder_library.create_dmg_segment(patient_data))
@@ -58,9 +71,36 @@ def format_single_claim(patient_data, config, endpoint, transaction_set_control_
     segments.extend([MediLink_837p_encoder_library.create_2010BB_payer_information_segment(patient_data)])
     #segments.extend(MediLink_837p_encoder_library.create_payer_address_segments(config)) OMITTED
     
+    # TODO (COB ENHANCEMENT): COB processing for secondary claims and Medicare adjudication
+    # See MediLink_837p_cob_library.process_cob_claim() for complete COB implementation
+    # This would include:
+    # - Enhanced SBR segments with Medicare payer types (MB/MA)
+    # - 2320 loop for other subscriber information
+    # - 2330B loop for prior payer (Medicare) information
+    # - 2330C loop when patient != subscriber
+    # - 2430 loop for service-level COB adjudication
+    # - PWK segments for attachment references
+    # 
+    # Integration point for COB processing:
+    # if patient_data.get('claim_type') == 'secondary' or patient_data.get('requires_cob_processing'):
+    #     cob_segments = MediLink_837p_cob_library.process_cob_claim(patient_data, config, crosswalk, client)
+    #     segments.extend(cob_segments)
+    
     # Rendering Provider (2310B Loop)
     segments.extend(MediLink_837p_encoder_library.create_nm1_rendering_provider_segment(config))
     
+    # TODO (COB ENHANCEMENT): Enhanced CLM segment creation for COB claims
+    # Replace standard CLM creation with COB-aware version
+    # Current: segments.extend(MediLink_837p_encoder_library.create_clm_and_related_segments(patient_data, config, crosswalk))
+    # Enhanced:
+    # if patient_data.get('claim_type') == 'secondary':
+    #     enhanced_clm = MediLink_837p_cob_library.create_enhanced_clm_segment(patient_data, config, crosswalk)
+    #     segments.append(enhanced_clm)
+    #     # Add service line segments separately for COB
+    #     segments.extend(MediLink_837p_encoder_library.create_service_line_segments(patient_data, config, crosswalk))
+    # else:
+    #     segments.extend(MediLink_837p_encoder_library.create_clm_and_related_segments(patient_data, config, crosswalk))
+    
     # Claim information 2300, 2310C Service Facility and 2400 loop segments
     segments.extend(MediLink_837p_encoder_library.create_clm_and_related_segments(patient_data, config, crosswalk))
 

MediLink/MediLink_837p_encoder_library.py

@@ -10,27 +10,22 @@ if project_dir not in sys.path:
 from MediBot import MediBot_Preprocessor_lib
 load_insurance_data_from_mains = MediBot_Preprocessor_lib.load_insurance_data_from_mains
 from MediBot import MediBot_Crosswalk_Library
-from MediLink_API_v3 import fetch_payer_name_from_api
-
-# Converts date format from one format to another.
-def convert_date_format(date_str):
-    # Parse the input date string into a datetime object using the input format    
-    # Determine the input date format based on the length of the input string
-    input_format = "%m-%d-%Y" if len(date_str) == 10 else "%m-%d-%y"
-    date_obj = datetime.strptime(date_str, input_format)
-    # Format the datetime object into the desired output format and return
-    return date_obj.strftime("%Y%m%d")
-
-# Formats date and time according to the specified format.
-def format_datetime(dt=None, format_type='date'):
-    if dt is None:
-        dt = datetime.now()
-    if format_type == 'date':
-        return dt.strftime('%Y%m%d')
-    elif format_type == 'isa':
-        return dt.strftime('%y%m%d')
-    elif format_type == 'time':
-        return dt.strftime('%H%M')
+from .MediLink_API_v3 import fetch_payer_name_from_api
+
+# Import utility functions from utilities module
+from .MediLink_837p_utilities import (
+    convert_date_format,
+    format_datetime,
+    get_user_confirmation,
+    prompt_user_for_payer_id,
+    format_claim_number,
+    generate_segment_counts,
+    handle_validation_errors,
+    get_output_directory,
+    winscp_validate_output_directory
+)
+
+
 
 # Constructs the ST segment for transaction set.
 def create_st_segment(transaction_set_control_number):
@@ -152,14 +147,18 @@ def create_1000A_submitter_name_segment(patient_data, config, endpoint):
     # Submitter contact details
     contact_name = config.get('submitter_name', 'NONE')
     contact_telephone_number = config.get('submitter_tel', 'NONE')
-    entity_type_qualifier = '2' # if contact_name else '1'  BUG - 1 if submitter_first_name is not empty. Reference: billing_entity_type_qualifier = '1' if billing_provider_firstname else '2' 
+    
+    # Get submitter first name to determine entity type qualifier
+    submitter_first_name = config.get('submitter_first_name', '')
+    # Determine entity_type_qualifier: '1' for individual (with first name), '2' for organization
+    entity_type_qualifier = '1' if submitter_first_name else '2' # Make sure that this is correct. Original default was 2.
     
     # Construct NM1 segment for the submitter
     nm1_segment = "NM1*41*{}*{}*****{}*{}~".format(entity_type_qualifier, submitter_name, submitter_id_qualifier, submitter_id) # BUG - need to check submitter_name because this is written as fixed ****** which implies a single entry and not a first and last name. This is weird.
     
     # Construct PER segment for the submitter's contact information
     per_segment = "PER*IC*{}*TE*{}~".format(contact_name, contact_telephone_number)
-
+    
     return [nm1_segment, per_segment]
 
 # Constructs the NM1 segment for the receiver (1000B).
@@ -237,15 +236,7 @@ def create_2010BB_payer_information_segment(parsed_data):
     # Build NM1 segment using provided payer name and payer ID
     return build_nm1_segment(payer_name, payer_id)
 
-def get_user_confirmation(prompt_message):
-    while True:
-        response = input(prompt_message).strip().lower()
-        if response in ['yes', 'y']:
-            return True
-        elif response in ['no', 'n']:
-            return False
-        else:
-            print("Please respond with 'yes' or 'no'.")
+
 
 def resolve_payer_name(payer_id, config, primary_endpoint, insurance_name, parsed_data, crosswalk, client):
     # Check if the payer_id is in the crosswalk with a name already attached to it.
@@ -405,18 +396,7 @@ def handle_missing_payer_id(insurance_name, config, crosswalk, client):
         MediLink_ConfigLoader.log("User did not confirm the standard insurance name. Manual intervention is required.", config, level="CRITICAL")
         return None
 
-def prompt_user_for_payer_id(insurance_name):
-    """
-    Prompts the user to input the payer ID manually and ensures that a valid alphanumeric ID is provided.
-    """
-    while True:
-        print("Manual intervention required: No payer ID found for insurance name '{}'.".format(insurance_name))
-        payer_id = input("Please enter the payer ID manually: ").strip()
-        
-        if payer_id.isalnum():
-            return payer_id
-        else:
-            print("Error: Payer ID must be alphanumeric. Please try again.")
+
 
 def build_nm1_segment(payer_name, payer_id):
     # Step 1: Build NM1 segment using payer name and ID
@@ -539,6 +519,12 @@ def create_sbr_segment(config, parsed_data, endpoint):
     # Insurance Type Code
     insurance_type_code = insurance_type_selection(parsed_data)
 
+    # TODO (COB ENHANCEMENT): Enhanced SBR segment for Medicare and COB support
+    # For Medicare Part B: SBR09 = "MB"
+    # For Medicare Advantage: SBR09 = "MA" 
+    # For secondary claims: SBR01 = "S"
+    # See MediLink_837p_cob_library.create_enhanced_sbr_segment() for implementation
+
     # Construct the SBR segment using the determined codes
     sbr_segment = "SBR*{responsibility_code}*18*******{insurance_type_code}~".format(
         responsibility_code=responsibility_code,
@@ -591,6 +577,12 @@ def insurance_type_selection(parsed_data):
     # Retrieve insurance options with codes and descriptions
     config, _ = MediLink_ConfigLoader.load_configuration()
     insurance_options = config['MediLink_Config'].get('insurance_options')
+    
+    # TODO (COB ENHANCEMENT): Enhanced insurance options for Medicare support
+    # See MediLink_837p_cob_library.get_enhanced_insurance_options() for Medicare codes:
+    # - MB: Medicare Part B
+    # - MA: Medicare Advantage  
+    # - MC: Medicare Part C
 
     def prompt_display_insurance_options():
         # Prompt to display full list
@@ -684,15 +676,7 @@ def create_nm1_rendering_provider_segment(config, is_rendering_provider_differen
     else:
         return []
 
-def format_claim_number(chart_number, date_of_service):
-    # Remove any non-alphanumeric characters from chart number and date
-    chart_number_alphanumeric = ''.join(filter(str.isalnum, chart_number))
-    date_of_service_alphanumeric = ''.join(filter(str.isalnum, date_of_service))
-    
-    # Combine the alphanumeric components without spaces
-    formatted_claim_number = chart_number_alphanumeric + date_of_service_alphanumeric
-    
-    return formatted_claim_number
+
 
 # Constructs the CLM and related segments based on parsed data and configuration.
 def create_clm_and_related_segments(parsed_data, config, crosswalk): 
@@ -705,6 +689,14 @@ def create_clm_and_related_segments(parsed_data, config, crosswalk):
     Service Line Information (2400 Loop):
     Verify that the service line number (LX), professional service (SV1), and service date (DTP) segments contain
     accurate information and are formatted according to the claim's details.
+    
+    TODO (COB ENHANCEMENT): This function needs enhancement for COB scenarios:
+    1. Enhanced CLM segment with proper claim frequency (CLM05-3)
+    2. Support for service-level COB adjudication (2430 loop)
+    3. Integration with 835-derived adjudication data
+    4. PWK segment support for attachments
+    
+    See MediLink_837p_cob_library.create_enhanced_clm_segment() for enhanced implementation.
     """
     
     segments = []
@@ -715,15 +707,22 @@ def create_clm_and_related_segments(parsed_data, config, crosswalk):
     formatted_claim_number = format_claim_number(chart_number, date_of_service)
         
     # CLM - Claim Information
-    segments.append("CLM*{}*{}***{}:B:1*Y*A*Y*Y~".format(
+    # TODO (COB ENHANCEMENT): Enhanced claim frequency handling
+    # For COB claims, CLM05-3 should be "1" (original) unless replacement logic applies
+    claim_frequency = "1"  # Default to original
+    # if parsed_data.get('claim_type') == 'secondary':
+    #     claim_frequency = "1"  # Original for secondary claims
+    
+    segments.append("CLM*{}*{}***{}:B:{}*Y*A*Y*Y~".format(
         formatted_claim_number,
         parsed_data['AMOUNT'],
-        parsed_data['TOS']))
+        parsed_data['TOS'],
+        claim_frequency))
     
     # HI - Health Care Diagnosis Code
     # Hardcoding "ABK" for ICD-10 codes as they are the only ones used now.
     medisoft_code = ''.join(filter(str.isalnum, parsed_data['DIAG']))
-    diagnosis_code = next((key for key, value in crosswalk.get('diagnosis_to_medisoft', {}).items() if value == medisoft_code), None) 
+    diagnosis_code = next((key for key, value in crosswalk.get('diagnosis_to_medisoft', {}).items() if value == medisoft_code), None)
     
     if diagnosis_code is None:
         error_message = "Diagnosis code is empty for chart number: {}. Please verify. Medisoft code is {}".format(chart_number, medisoft_code)
@@ -743,8 +742,21 @@ def create_clm_and_related_segments(parsed_data, config, crosswalk):
     segments.extend(create_service_facility_location_npi_segment(config))
     
     # For future reference, SBR - (Loop 2320: OI, NM1 (2330A), N3, N4, NM1 (2330B)) - Other Subscriber Information goes here.
-    
-    # LX - Service Line Number
+    # TODO (COB ENHANCEMENT): COB loops for secondary claims and Medicare adjudication
+    # See MediLink_837p_cob_library for implementation of:
+    # - create_2320_other_subscriber_segments() for secondary payer info
+    # - 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
+    # 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
+    # if parsed_data.get('requires_attachment'):
+    #     pwk_segment = MediLink_837p_cob_library.create_pwk_attachment_segment(parsed_data, config)
+    #     if pwk_segment:
+    #         segments.append(pwk_segment)
+    
+    # LX - Service Line Counter
     segments.append("LX*1~")
     
     # SV1 - Professional Service
@@ -762,6 +774,14 @@ def create_clm_and_related_segments(parsed_data, config, crosswalk):
     # 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
     
+
+    # TODO (COB ENHANCEMENT): Service-level COB adjudication (2430 loop)
+    # See MediLink_837p_cob_library.create_2430_service_line_cob_segments() for implementation
+    # This would include SVD, CAS, and DTP*573 segments for service-level adjudication
+    # if parsed_data.get('service_adjudications'):
+    #     cob_segments = MediLink_837p_cob_library.create_2430_service_line_cob_segments(parsed_data, config, crosswalk)
+    #     segments.extend(cob_segments)
+    
     return segments
 
 def get_endpoint_config(config, endpoint):
@@ -892,70 +912,5 @@ def create_interchange_trailer(config, num_transactions, isa13, num_functional_g
     
     return ge_segment, iea_segment
 
-# Generates segment counts for the formatted 837P transaction and updates SE segment.
-def generate_segment_counts(compiled_segments, transaction_set_control_number):
-    # Count the number of segments, not including the placeholder SE segment
-    segment_count = compiled_segments.count('~')   # + 1 Including SE segment itself, but seems to be giving errors.
-    
-    # Ensure transaction set control number is correctly formatted as a string
-    formatted_control_number = str(transaction_set_control_number).zfill(4)  # Pad to ensure minimum 4 characters
 
-    # Construct the SE segment with the actual segment count and the formatted transaction set control_number
-    se_segment = "SE*{0}*{1}~".format(segment_count, formatted_control_number)
 
-    # Assuming the placeholder SE segment was the last segment added before compiling
-    # This time, we directly replace the placeholder with the correct SE segment
-    formatted_837p = compiled_segments.rsplit('SE**', 1)[0] + se_segment
-    
-    return formatted_837p
-
-def handle_validation_errors(transaction_set_control_number, validation_errors, config):
-    for error in validation_errors:
-        MediLink_ConfigLoader.log("Validation error for transaction set {}: {}".format(transaction_set_control_number, error), config, level="WARNING")
-    
-    print("Validation errors encountered for transaction set {}. Errors: {}".format(transaction_set_control_number, validation_errors))
-    user_input = input("Skip this patient and continue without incrementing transaction set number? (yes/no): ")
-    if user_input.lower() == 'yes':
-        print("Skipping patient...")
-        MediLink_ConfigLoader.log("Skipped processing of transaction set {} due to user decision.".format(transaction_set_control_number), config, level="INFO")
-        return True  # Skip the current patient
-    else:
-        print("Processing halted due to validation errors.")
-        MediLink_ConfigLoader.log("HALT: Processing halted at transaction set {} due to unresolved validation errors.".format(transaction_set_control_number), config, level="ERROR")
-        sys.exit()  # Optionally halt further processing
-        
-def winscp_validate_output_directory(output_directory):
-    """
-    Validates the output directory path to ensure it has no spaces.
-    If spaces are found, prompts the user to input a new path.
-    If the directory doesn't exist, creates it.
-    """
-    while ' ' in output_directory:
-        print("\nWARNING: The output directory path contains spaces, which can cause issues with upload operations.")
-        print("    Current proposed path: {}".format(output_directory))
-        new_path = input("Please enter a new path for the output directory: ")
-        output_directory = new_path.strip()  # Remove leading/trailing spaces
-    
-    # Check if the directory exists, if not, create it
-    if not os.path.exists(output_directory):
-        os.makedirs(output_directory)
-        print("INFO: Created output directory: {}".format(output_directory))
-    
-    return output_directory
-
-def get_output_directory(config):
-    # Retrieve desired default output file path from config 
-    output_directory = config.get('outputFilePath', '').strip()
-    # BUG (Low SFTP) Add WinSCP validation because of the mishandling of spaces in paths. (This shouldn't need to exist.)
-    if not output_directory:
-        print("Output file path is not specified in the configuration.")
-        output_directory = input("Please enter a valid output directory path: ").strip()
-    
-    # Validate the directory path (checks for spaces and existence)
-    output_directory = winscp_validate_output_directory(output_directory)
-    
-    if not os.path.isdir(output_directory):
-        print("Output directory does not exist or is not accessible. Please check the configuration.")
-        return None
-    
-    return output_directory

MediLink/MediLink_837p_utilities.py

@@ -0,0 +1,264 @@
+# MediLink_837p_utilities.py
+"""
+837P Encoder Utility Functions
+
+This module contains utility functions extracted from MediLink_837p_encoder_library.py
+to reduce the size and complexity of the main encoder library while avoiding circular imports.
+
+Functions included:
+- Date/time formatting utilities
+- User interaction utilities  
+- File/path handling utilities
+- Processing utilities
+- Validation utilities
+
+Import Strategy:
+This module only imports base Python modules and MediLink_ConfigLoader to avoid 
+circular dependencies. Other modules import from this utilities module.
+"""
+
+from datetime import datetime
+import sys
+import os
+import re
+
+# Import MediLink_ConfigLoader for logging functionality
+try:
+    from MediLink import MediLink_ConfigLoader
+except ImportError:
+    import MediLink_ConfigLoader
+
+# =============================================================================
+# DATE/TIME UTILITIES
+# =============================================================================
+
+def convert_date_format(date_str):
+    """
+    Converts date format from one format to another.
+    
+    Parameters:
+    - date_str: Date string in MM-DD-YYYY or MM-DD-YY format
+    
+    Returns:
+    - Date string in YYYYMMDD format
+    """
+    # Parse the input date string into a datetime object using the input format    
+    # Determine the input date format based on the length of the input string
+    input_format = "%m-%d-%Y" if len(date_str) == 10 else "%m-%d-%y"
+    date_obj = datetime.strptime(date_str, input_format)
+    # Format the datetime object into the desired output format and return
+    return date_obj.strftime("%Y%m%d")
+
+def format_datetime(dt=None, format_type='date'):
+    """
+    Formats date and time according to the specified format.
+    
+    Parameters:
+    - dt: datetime object (defaults to current datetime if None)
+    - format_type: 'date', 'isa', or 'time'
+    
+    Returns:
+    - Formatted date/time string
+    """
+    if dt is None:
+        dt = datetime.now()
+    if format_type == 'date':
+        return dt.strftime('%Y%m%d')
+    elif format_type == 'isa':
+        return dt.strftime('%y%m%d')
+    elif format_type == 'time':
+        return dt.strftime('%H%M')
+
+# =============================================================================
+# USER INTERACTION UTILITIES
+# =============================================================================
+
+def get_user_confirmation(prompt_message):
+    """
+    Prompts user for yes/no confirmation with validation.
+    
+    Parameters:
+    - prompt_message: Message to display to user
+    
+    Returns:
+    - Boolean: True for yes, False for no
+    """
+    while True:
+        response = input(prompt_message).strip().lower()
+        if response in ['yes', 'y']:
+            return True
+        elif response in ['no', 'n']:
+            return False
+        else:
+            print("Please respond with 'yes' or 'no'.")
+
+def prompt_user_for_payer_id(insurance_name):
+    """
+    Prompts the user to input the payer ID manually and ensures that a valid alphanumeric ID is provided.
+    
+    Parameters:
+    - insurance_name: Name of the insurance for context
+    
+    Returns:
+    - Valid alphanumeric payer ID
+    """
+    while True:
+        print("Manual intervention required: No payer ID found for insurance name '{}'.".format(insurance_name))
+        payer_id = input("Please enter the payer ID manually: ").strip()
+        
+        if payer_id.isalnum():
+            return payer_id
+        else:
+            print("Error: Payer ID must be alphanumeric. Please try again.")
+
+# =============================================================================
+# FILE/PATH UTILITIES
+# =============================================================================
+
+def format_claim_number(chart_number, date_of_service):
+    """
+    Formats claim number by combining chart number and date of service.
+    
+    Parameters:
+    - chart_number: Patient chart number
+    - date_of_service: Date of service
+    
+    Returns:
+    - Formatted claim number (alphanumeric only)
+    """
+    # Remove any non-alphanumeric characters from chart number and date
+    chart_number_alphanumeric = ''.join(filter(str.isalnum, chart_number))
+    date_of_service_alphanumeric = ''.join(filter(str.isalnum, date_of_service))
+    
+    # Combine the alphanumeric components without spaces
+    formatted_claim_number = chart_number_alphanumeric + date_of_service_alphanumeric
+    
+    return formatted_claim_number
+
+def winscp_validate_output_directory(output_directory):
+    """
+    Validates the output directory path to ensure it has no spaces.
+    If spaces are found, prompts the user to input a new path.
+    If the directory doesn't exist, creates it.
+    
+    Parameters:
+    - output_directory: Directory path to validate
+    
+    Returns:
+    - Validated directory path
+    """
+    while ' ' in output_directory:
+        print("\nWARNING: The output directory path contains spaces, which can cause issues with upload operations.")
+        print("    Current proposed path: {}".format(output_directory))
+        new_path = input("Please enter a new path for the output directory: ")
+        output_directory = new_path.strip()  # Remove leading/trailing spaces
+    
+    # Check if the directory exists, if not, create it
+    if not os.path.exists(output_directory):
+        os.makedirs(output_directory)
+        print("INFO: Created output directory: {}".format(output_directory))
+    
+    return output_directory
+
+def get_output_directory(config):
+    """
+    Retrieves and validates output directory from configuration.
+    
+    Parameters:
+    - config: Configuration dictionary
+    
+    Returns:
+    - Valid output directory path or None if invalid
+    """
+    # Retrieve desired default output file path from config 
+    output_directory = config.get('outputFilePath', '').strip()
+    # BUG (Low SFTP) Add WinSCP validation because of the mishandling of spaces in paths. (This shouldn't need to exist.)
+    if not output_directory:
+        print("Output file path is not specified in the configuration.")
+        output_directory = input("Please enter a valid output directory path: ").strip()
+    
+    # Validate the directory path (checks for spaces and existence)
+    output_directory = winscp_validate_output_directory(output_directory)
+    
+    if not os.path.isdir(output_directory):
+        print("Output directory does not exist or is not accessible. Please check the configuration.")
+        return None
+    
+    return output_directory
+
+# =============================================================================
+# PROCESSING UTILITIES
+# =============================================================================
+
+def generate_segment_counts(compiled_segments, transaction_set_control_number):
+    """
+    Generates segment counts for the formatted 837P transaction and updates SE segment.
+    
+    Parameters:
+    - compiled_segments: String containing compiled 837P segments
+    - transaction_set_control_number: Transaction set control number
+    
+    Returns:
+    - Formatted 837P string with correct SE segment
+    """
+    # Count the number of segments, not including the placeholder SE segment
+    segment_count = compiled_segments.count('~')   # + 1 Including SE segment itself, but seems to be giving errors.
+    
+    # Ensure transaction set control number is correctly formatted as a string
+    formatted_control_number = str(transaction_set_control_number).zfill(4)  # Pad to ensure minimum 4 characters
+
+    # Construct the SE segment with the actual segment count and the formatted transaction set control_number
+    se_segment = "SE*{0}*{1}~".format(segment_count, formatted_control_number)
+
+    # Assuming the placeholder SE segment was the last segment added before compiling
+    # This time, we directly replace the placeholder with the correct SE segment
+    formatted_837p = compiled_segments.rsplit('SE**', 1)[0] + se_segment
+    
+    return formatted_837p
+
+# =============================================================================
+# VALIDATION UTILITIES
+# =============================================================================
+
+def handle_validation_errors(transaction_set_control_number, validation_errors, config):
+    """
+    Handles validation errors with user interaction for decision making.
+    
+    Parameters:
+    - transaction_set_control_number: Current transaction set control number
+    - validation_errors: List of validation errors
+    - config: Configuration for logging
+    
+    Returns:
+    - Boolean: True to skip patient, False to halt processing
+    """
+    for error in validation_errors:
+        MediLink_ConfigLoader.log("Validation error for transaction set {}: {}".format(transaction_set_control_number, error), config, level="WARNING")
+    
+    print("Validation errors encountered for transaction set {}. Errors: {}".format(transaction_set_control_number, validation_errors))
+    user_input = input("Skip this patient and continue without incrementing transaction set number? (yes/no): ")
+    if user_input.lower() == 'yes':
+        print("Skipping patient...")
+        MediLink_ConfigLoader.log("Skipped processing of transaction set {} due to user decision.".format(transaction_set_control_number), config, level="INFO")
+        return True  # Skip the current patient
+    else:
+        print("Processing halted due to validation errors.")
+        MediLink_ConfigLoader.log("HALT: Processing halted at transaction set {} due to unresolved validation errors.".format(transaction_set_control_number), config, level="ERROR")
+        sys.exit()  # Optionally halt further processing
+
+# =============================================================================
+# UTILITY FUNCTION REGISTRY
+# =============================================================================
+
+# Export all utility functions for easy importing
+__all__ = [
+    'convert_date_format',
+    'format_datetime', 
+    'get_user_confirmation',
+    'prompt_user_for_payer_id',
+    'format_claim_number',
+    'winscp_validate_output_directory', 
+    'get_output_directory',
+    'generate_segment_counts',
+    'handle_validation_errors'
+] 

MediLink/MediLink_ClaimStatus.py

@@ -21,9 +21,10 @@ start_date_str = start_date.strftime('%m/%d/%Y')
 billing_provider_tin = config['MediLink_Config'].get('billing_provider_tin')
 
 # Define the list of payer_id's to iterate over
-payer_ids = ['87726']  # Default value, getting a bad request error when trying to get all payer_ids.
-# Allowed payer id's for UHC
-# payer_ids = ['87726', '03432', '96385', '95467', '86050', '86047', '95378', '06111', '37602']
+payer_ids = ['87726'] # Default Value
+# Allowed payer id's for UHC 87726, 03432, 96385, 95467, 86050, 86047, 95378, 37602. This api does not support payerId 06111.
+# payer_ids = ['87726', '03432', '96385', '95467', '86050', '86047', '95378', '37602']
+# Oddly enough, the API is completely ignoring the payerId parameter and returning the exact same dataset for all payer IDs. 
 
 # Initialize the API client
 client = MediLink_API_v3.APIClient()