Inbound Files - Failed

In platform Live board, under the section Inbound Files, you can see different boxes that contain inbound files in different statuses. These boxes have different colors, Green, Blue, Yellow, and Red.

In this document we are going to learn about inbound files failures and how to correct an inbound file.

File edition is restricted to specific roles. If you do not have access to this part of the platform and need to modify a file content, please contact your administrator.

How do inbound files go to the failed queue?

In the platform, some validations are applied to files before processing them. The following validations can change the status of the file to “Failed”:

File encryption issue: You can configure the platform to decrypt encrypted files in the flow configuration. If something goes wrong during decryption, the file is set as failed.
Validating file uniqueness: If you send the same file twice through the same organization, the file is set as failed.
File size: If your file exceeds 150MB, the file is set as failed.
File normalization: To process financial transactions available in inbound files, the platform applies some format validation and transformation of data. If something goes wrong during normalization, the file is set as failed. The format of the file needs to be specified in the flow configuration.
Total count validation: The total count of transactions contained in the inbound file needs to match the total count field entered in the file (not applicable in MT format).
Total sum validation: The total amount of all transactions contained in the inbound file needs to match the total amount field entered in the file (not applicable in MT format).

All inbound files can only be corrected from the “Files failed” queue available into the Live Board.

How to identify the reason for the failure?

Inbound files with the status "Failed" are files whose processing has failed. In order to correct the right information or to avoid this scenario on your file, you must first identify the reason for this failure and then define the changes to be made.

To identify the file failure reason, within the Live Board > Inbound Files section:

Click on the “Files failed” queue to display the list of files.
Find the file you want to view within this list.
Click on Details to display the whole file information.
Use the View state button to know the status reason. The State reason will display the rejection reason.

In this example, the file uniqueness validation failed. The user needs to apply some changes to the files or import it into another organization.

To identify the changes to be made on your file, we advise that you validate all the data in your file. If the file seems correct, it's probably a configuration problem: please contact your administrator directly.

How to correct a file?

In the Inbound Files section within the Live Board, you can find all transactions in the “Failed” status.

To correct a file, you need to:

Click on the “Files failed” queue: you will have access to the list of files in error.
Find the file you want to correct within this list.
Click on Edit button on the line containing your file information.

Click of Details to display the whole file information and click on Edit.

The following screen appears

You can select another flow or edit the file content to correct the data.
Click on Edit to process again the file.

Flows available on the last screen are only those that belong to the same organization as the current inbound file.