❌ DI Error: Header mismatch found in file

Problem 

When attempting to upload a file through an SFTP data integration job in DI Studio, the job fails and returns an error similar to the following:

Header mismatch found in file: [filename]

Example:

Cause

This error occurs when one or more existing files — stored on the server hosting the DIS agent services — share the same name as the file being uploaded but contain a mismatched header. The conflicting files must be removed before the upload can complete successfully.

Solution

The resolution depends on whether your DIS agent is hosted on-premise or by Prophix.

If the DIS agent is hosted on-premise (client-managed):

1. Locate and delete the conflicting file(s) on your DIS agent server. Refer to the How to Locate the File section below for step-by-step instructions.
2. Re-run the DI job.

If the DIS agent is hosted by Prophix:

1. Contact Prophix Support and request that all files matching the filename referenced in the error message be deleted.
2. Re-run the DI job.

How to Locate the File

1. Remote into the server hosting the DIS agent.
2. Navigate to the following directory: C:\Program Files\Prophix\DataIntegration\ProphixTemp
3. Inside ProphixTemp, you will find one folder per Site ID. If multiple folders are present, identify the correct one by matching the Site ID shown on the Admin page in DI Studio.
4. Within the Site ID folder, you will find either files or subfolders, depending on your SFTP configuration.
5. Search for the filename referenced in the error message and delete all matching files.