How to Use Item Classification FTP

Introduction

Welcome to the Avalara Item Classification FTP Usage Guide. Item Classification automates assigning HS Codes to physical goods shipped internationally. This guide is intended to demonstrate how to set up Secure File Transfer Protocol (FTP) to use Item Classification. For more information, download our Item Classification FTP specs.

File Formats

During the sign-up process, you will designate which file format you would like to use for submitting your data for classification. The available file types for Item Classification are:

Choose the file type that best works with your internal systems and workflow. We are currently unable to change this file type after your account is created.

File Setup

All files for upload must have "HSCR.V2." at the beginning of the file name. For example, a CSV file for Item Classification might be named HSCR.V2.2020_03_01.CSV. When the file is classified, the results file will be named HSCR.CLASSIFICATION.V2.2020_03_01.CSV.

Item Parameters

Many physical goods have qualitative and quantitative details. These details are represented as an array of parameters. You should include as many relevant parameters as you have. Certain physical goods require parameters, for example olive oil requires a volume measurement parameter.

SSH Key Setup

Public-private key pairs are a means securely encrypting information. With Avalara Item Classification FTP, you will need to create a public-private SSH key pair. Send us the public half of the key. Save the private portion of the key and keep it safe. Do not use PuTTYgen on Windows to generate the public-private key pair. The format is incompatible with our file transfer architecture.

Here are instructions for using OpenSSH on Windows 10 to generate a public-private key pair.

  1. Open Windows Powershell
  2. Type: ssh-keygen
  3. Enter the filepath and name where you wish to save the key pair, with empty passphrase if prompted. Example: c:\temp\MySshKeyPair.ssh SSH Example
  4. In the path where you created the keys, there will be two new files. Continuing with the example in #3: MySshKeyPair.ssh and MySshKeyPair.ssh.pub. The .pub file is the public key.
  5. Submit the public key to Avalara via email to your Go-Live representative or Account Manager. The public key is designed to be shared as a means for others to encrypt information sent to you.
  6. Save the private key. This private key, MySshKeyPair.ssh, is your Item Classification FTP password. We will show you how to use this file as your password in your FTP client.

You may read more about public-key cryptography here: https://en.wikipedia.org/wiki/Public-key_cryptography.

File Upload

You will need a secure FTP client to upload your files to Avalara Item Classification. There are many secure FTP applications you can use. For illustrative purposes, the following examples show FileZilla, a free, open-source FTP client application.

  1. Set up connection to Avalara Item Classification FTP. In FileZilla, click on File > Site Manager... Select Site Manager
  2. Set Protocol to SFTP - SSH File Transfer Protocol Select Protocol
  3. Set Host to ftp.classification.avalara.net, leave Port blank Select Host
  4. Set Logon Type to Key file
    Select Logon
  5. Set User to the username provided to you in the "Welcome to Item Classification" email. Select User
  6. Select the private key file you previously created. Select Keyfile
  7. Connect to Avalara Item Classification when ready. Upon successfully connecting, you will see two folders available to you, inbound and outbound. Connect to Avalara Item Classification
  8. Place your formatted files in the inbound folder. Classification results will be in the outbound folder when completed.