What are basic failed upload errors when troubleshooting SFTP?

What are basic failed upload errors when troubleshooting SFTP?

Fixing SFTP File Upload Errors

This guide explains common issues like 'invalid byte sequence in UTF-8' and errors related to missing quantities when uploading files via SFTP. Learn how to identify and fix encoding problems and troublesome white space to ensure your files upload successfully to Clarus WMS.


Step-by-Step Guide

1. Check File Encoding

If you see an 'invalid byte sequence in UTF-8' error, your file may not be saved with the correct encoding. It should be saved as UTF-8.


2. Identify White Space

White space is a common cause of SFTP upload failures and can lead to errors such as 'Quantity is missing: order_reference'. This includes extra spaces after information, spaces between commas, or accidental extra lines.


3. Open File in Notepad

To inspect your file for white space, go to your file explorer, right-click on the import file, select Open with, and then choose Notepad.


4. Understand File Layout

In Notepad, you will see the import laid out in text form. The top line contains the various fields (e.g., receipt_reference, warehouse_code). Each line below provides the information from one cell, with a comma separating data for the next cell. Empty cells will appear as a single comma.


5. Remove White Space and Extra Lines

WarningWARNING: Any spaces after information, spaces between commas, or extra lines (which appear as a bunch of empty commas at the bottom of the file) are considered white space. You must remove these to ensure your file uploads successfully.

Removing these commas at the bottom and any spaces within the file will eliminate the white space and should allow the file to upload without issue.


FAQs

What does 'invalid byte sequence in UTF-8' mean?

This error usually means the file you are trying to upload is not saved using the correct encoding, which should be UTF-8.

What is white space?

White space refers to invisible characters like spaces or extra lines in your file. It can cause upload failures, even if the file looks correct visually. This includes spaces after data, between commas, or entirely empty lines at the end of the file.

Why is white space a common issue?

Even though white space might not be visible, it can interfere with how the system processes the file, leading to errors. It's the most frequent reason for SFTP files failing to upload.

How can I prevent white space?

REMEMBER: Always double-check your file in a plain text editor like Notepad before uploading. Pay close attention to any extra spaces after commas or data, and ensure there are no unintended empty lines at the end of the file.


    • Related Articles

    • Troubleshooting failed scheduled reports

      Troubleshooting Blank or Failed Scheduled Reports This guide explains how to troubleshoot scheduled reports that are failing to run or appearing blank in Clarus WMS. Follow these steps before escalating the issue or requesting further assistance. ...

    • Troubleshooting - Checking the FTP/SFTP Queue

      Checking the FTP/SFTP Queue This guide explains how to check the FTP and SFTP queues to ensure your import files are processing correctly in Clarus WMS, especially when dealing with large datasets or potential import failures. Step-by-Step Guide 1. ...

    • Imports unsuccessful Troubleshooting

      Troubleshooting Failing or Unuploaded Imports This guide helps you resolve issues where your imports are not working correctly or are not appearing in Clarus WMS. Follow these steps to diagnose and fix common problems. Step-by-Step Guide 1. Check ...

    • How Do I Use SFTP for Imports in Clarus WMS?

      This guide explains how to use SFTP (Secure File Transfer Protocol) for encrypted and secure file transfers to Clarus WMS. You will learn the steps for uploading import files and checking the status of your upload. SFTP is a secure way to transfer ...

    • How do I import stock attributes via SFTP in Clarus WMS?

      Update Stock Attributes When you receive new stock and need to update its details, you can do so by importing the Stock Attribute file via SFTP. This file allows you to change various details about your stock, such as descriptions, dates, and FIFO ...