Skip to main content
Clarus logs every file it receives for import, and every attempt to process it. When you need to know what happened to an import, start with these logs. They are on the Import Files page, in the left-hand menu under Imports > Import Files. The page lists every file Clarus has received for import, whether it was sent over SFTP or AS2 or uploaded in the web app. For each file you can:
  • Check that Clarus received it and whether it processed or failed.
  • See every attempt to process it, with how many records it imported.
  • View the errors behind a failed attempt in plain language.
  • Retry a failed file once you have fixed the cause. You don’t need to send the file again.
  • Download the file exactly as Clarus received it, to check what the sender actually sent.
If your file isn’t listed at all, Clarus never received it. See When a file won’t upload.
Clarus keeps a copy of each file for 15 days after it arrives. The Available Until column shows when a file’s copy expires. After that date you can no longer download or retry the file.

Before you start

  • To see the page and its files, your role needs the Import Files ability with Read access. With Read access only, the Download, Upload and Retry buttons are disabled.
  • To download, upload or retry files, your role needs Manage access as well. The Admin role has both by default. See User roles.
  • Uploading and retrying need an import configuration, which tells Clarus how to read the file. If your files have no import configuration yet, contact Clarus support. See Bespoke Imports.

Find your file

Each row is one file. The newest files are at the top. Use the filters and column options to find a file by name, date or status. See Customising Data Grids.

File statuses

See why a file failed

1

Open the file

Click Show on the file’s row. The General section shows where the file came from and how long it is kept.
2

Find the failed attempt

The Attempts section lists every time Clarus has processed the file, newest first. It shows each attempt’s status, the import configuration used, the number of Imported Records, who ran it and when.
3

View the errors

Click View Errors on the attempt. The Import Errors window lists each problem in plain language, for example Product not found (Code: ABC123). When the same problem affects several lines, it is listed once with the number of times it happened.Expand Details to see the full technical error. This is useful if you need to contact support.
An attempt has one of these statuses:

Retry a failed file

Most failures are caused by reference data that doesn’t exist in Clarus yet, such as a new product or a delivery address that isn’t set up. Fix the data in Clarus, then retry the file. You don’t need to resend it.
1

Fix the cause

Use the errors to find what is missing or wrong. For example, create the missing product.
2

Open the file and click Retry

Retry is available when the file’s status is Failed or Uploaded and its copy is still available.
3

Choose the import configuration

The sidebar selects the import configuration used last time. Change it if you need to, then click Retry.
4

Check the result

The file is queued for processing, and a new attempt appears in the Attempts section. Records created by the retry are recorded against your user.
Retry processes the file exactly as it was received. If the problem is in the file itself, such as a mistyped product code, correct the file and upload the corrected version instead.

Download a file

Click Download on the file’s row, or open the file and click Download at the top of the page. You get the file exactly as Clarus received it. Use it to check what a sender actually sent when someone queries the data. You can also use it to get a sample file during testing.
If the button is disabled, the file’s copy has passed its Available Until date, or your role doesn’t have Manage access to Import Files.

Upload a corrected file

You can upload a file on the same page instead of sending it over SFTP. Use it to send a corrected file after a failure, or for a one-off import or initial data load when you haven’t set up an SFTP connection yet.
1

Click Upload

Click Upload at the bottom of the Import Files list.
2

Choose the file

Select a file of up to 1 MB.
3

Choose an import configuration (optional)

To process the file straight away, select the Import Configuration to use. To keep the file for later, leave it empty. The file is saved with the status Uploaded, and you can process it later with Retry.
4

Click Upload

The file appears in the list with the source UI Upload. If you chose a configuration, it is queued for processing.
No. Only Failed and Uploaded files can be retried, so a successful file can’t be imported twice by mistake. You can still download it.
Clarus keeps each file for 15 days. Files that arrived before the Import Files page was introduced aren’t listed.
The 1 MB limit only applies to uploads in the web app. Send larger files over SFTP, or split the file into smaller files. See SFTP Overview.
No. For regular, automated imports from another system, SFTP is still the best option. Uploading in the web app is for files you send by hand. Files from both routes appear in the same list.