Uploading via FTP

Connecting to the FTP server

• Host: ftp.near.live
• Username: apikey
• Password: upload key provided by NearSt for the retail location
• Port: 21
• Initial directory: (empty)

Uploading data

As soon as you are connected, you can upload your stock information in a file named stock.csv. In this file, the first row is assumed to be the header row, and the values of this row will be used as field names for the other rows in the file.

Your stock.csv file should contain at least:

• A standardised barcode (EAN-13 or similar, see below)
• The current retail price, as a decimal number in GBP.
• The current in-stock quantity (stock level). Can be 0 or lower to indicate that a product is currently out of stock. Don't filter by stock quantity!

See the fields reference and examples for accepted formats for the above values.

Do not attempt to delete files from the server: uploaded files are automatically deleted after 30 days, and processing information for recent uploads is available in the Partner Dashboard.

Upload schedule

We recommend uploading data every 15 minutes. Read more in our FAQs.

File names

We recommend uploading your stock as stock.csv or stock.xlsx. XML uploads are also accepted — the file type is detected from the file's contents rather than its extension, so an XML feed uploaded as stock.csv will still be parsed correctly.

How the filename is routed: any file whose base name contains the substring product (case-insensitive) is routed to the product data pipeline. Every other filename is treated as a stock upload.

Examples:

If you upload a stock file whose name contains product, it will silently be treated as a product-data file, will not update stock levels, and its rows will be rejected by the product-data pipeline if they don't match the product data schema. Name stock files without the substring product to avoid this.