Retrying Failed Files

When a file fails to process or deliver, you can retry it after resolving the underlying issue. Modalius offers multiple ways to retry files - individually, in bulk by selection, or in bulk by filter.

When Can You Retry?

You can retry files that are in an error status:

• Error Processing - Retry will attempt to parse the file again
• Error Mapping - Retry will attempt to transform the data again
• Error Delivery - Retry will attempt to send the file again
• Error - Retry will restart processing from the beginning

Retrying a Single File

1. Navigate to Files in the main menu
2. Find the failed file (filter by error status to see all failures)
3. Click on the file to open the detail view
4. Review the error message to understand what went wrong
5. Click the Retry button
6. Monitor the file's progress as it reprocesses

Bulk Retry: Selected Files

To retry multiple specific files at once:

1. Navigate to Files or Errors
2. Use the checkboxes to select the files you want to retry
3. Click the Retry X Failed or Retry X Selected button that appears
4. Review the confirmation dialog showing which files will be retried
5. Click Retry Files to confirm

Bulk Retry: By Filter

For retrying large numbers of files matching specific criteria (without selecting each one):

1. Navigate to Errors
2. Click the Bulk Retry by Filter button
3. Set your filter criteria:
   • Receiver Business Unit - Retry files for a specific receiving business unit
   • Sender Business Unit - Retry files from a specific sending business unit
   • Error Stage - Processing Error, Mapping Error, Delivery Error, or General Error
   • Date Range - Start and end dates to limit the scope
4. Click Retry to start the bulk operation

Before You Retry

Always address the root cause before retrying:

For Processing Errors:

• Verify the sender ID in the EDI file matches an EDI Identifier configured on the sending business unit
• Verify the receiver ID in the EDI file matches an EDI Identifier on the receiving business unit
• Check the Partner Relationship is "Accepted" and not suspended
• Ensure EDI Identifiers are unique (not duplicated across multiple business units)
• For format errors: Verify the file is valid EDI (X12, EDIFACT) with UTF-8 encoding
• If the file is corrupted, upload a corrected version instead of retrying

For Mapping Errors:

• Review the file history log for detailed error messages in the "Data Mapping" category
• Verify the sender and receiver business units were correctly identified during processing
• Check that the Partner Relationship is accepted and not suspended
• Mapping errors are often transient: try retrying the file first
• If the error persists, contact support for mapping rule adjustments

For Delivery Errors:

• Check the connection type: Is this internal Modalius SFTP or an external connection (SFTP, AS2, API)?
• Verify the file has a receiver business unit set and valid EDI identifiers configured
• Check the connection health indicator: green (working), yellow (issues), red (unreachable)
• For external SFTP: Verify the directory path exists and credentials are correct
• For AS2: Check that certificates haven't expired
• Review connection rules to ensure they match the file's identifiers and filename patterns
• If connection is red: Partner server may be down; the system auto-tests every minute

What Happens After Retry