Skip to main content

File Processing Errors

Modalius Support
Updated

When files fail to process, Modalius provides detailed error information to help you understand what went wrong and how to fix it.

Processing Error Types

Files can fail at different stages of processing:

Error Stage What It Means Common Causes
Error Processing File could not be parsed or validated Invalid EDI format, corrupted file, encoding issues
Error Mapping Data could not be transformed Missing configuration, unexpected data values
Error Delivery File could not be sent to recipient Connection issues, authentication failures
General Error Unexpected system issue System errors, temporary issues

Common Processing Errors

Invalid Sender

Error: Unable to identify or validate the sender

Causes:

  • The sender ID in the EDI file doesn't match any business unit in the system
  • The sender ID is missing from the file
  • The sending business unit is not configured correctly

Resolution: Check the sender ID in the ISA segment of your EDI file. Verify the business unit exists and has the correct EDI identifier configured.

Invalid Receiver

Error: Unable to identify or validate the receiver

Causes:

  • The receiver ID in the EDI file doesn't match any known business unit
  • No active partner relationship exists with the receiver
  • The receiver business unit has been deleted or deactivated

Resolution: Verify the receiver ID in the ISA segment. Check that an active partner relationship exists with the receiving business unit.

Parse/Format Error

Error: Unable to parse EDI file format

Causes:

  • The file is corrupted or incomplete
  • Unsupported EDI format or standard
  • Invalid segment terminators or element separators
  • File contains invalid EDI syntax

Resolution: Validate the EDI file structure using an EDI validator. Check for missing or malformed segments.

Encoding Error

Error: Character encoding issue detected

Causes:

  • The file uses an unsupported character encoding
  • Special characters that aren't valid in EDI
  • File was corrupted during transfer

Resolution: Ensure the file uses ASCII or UTF-8 encoding. Remove any special characters not supported by EDI standards.

Viewing Error Details

To see detailed error information:

  1. Navigate to Files
  2. Filter by error status to find failed files
  3. Click on the failed file to open details
  4. Check the Processing History section for detailed error messages
  5. Review the error message and suggested resolution

The processing history includes:

  • Error code - Specific identifier for the error type
  • Error message - User-friendly description of what went wrong
  • Resolution steps - Suggested actions to fix the issue
  • Timestamp - When the error occurred

Retrying Failed Files

After resolving the underlying issue, you can retry processing:

  1. Open the failed file
  2. Click the Retry button
  3. Monitor the file status for the new processing attempt

Note: For errors related to the file content (parsing, encoding), you may need to correct the original file and upload it again rather than retrying.

When to Contact Support

Contact support if:

  • The error message doesn't provide clear resolution steps
  • The same error persists after following the suggested resolution
  • Multiple files are failing with the same error
  • You see a "General Error" with no specific details
  • Files that previously worked are now failing

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk