Importing Products

Contents

• Introduction
• Product File Set Overview
• Naming Files
• File Contents
• Version Tracking

Introduction

The Spaaza product import file set consists of two CSV files uploaded at intervals to manage product and variant catalogue information within the Spaaza platform.

Product File Set Overview

The file set consists of the following 2 files in CSV format:

1. Product List file

Provides a list of products/items sold by the retailer and includes information such as product name, brand, season, base price, image URL and identifiers. Always includes all products carried by a retailer.

Sample product list file data:

Download sample product list file

Product List Field Definitions:

2. Variant List file

Lists all product variants (sizes, colours, barcodes). Often incremental — only changes since the last upload are included unless resynchronising.

See the Spaaza Variant List File documentation for detailed field definitions and examples.

Naming Files

Product files follow this naming convention:

<filetype>_<YYYYMMDD>_<HHMMSS>.csv

The filetype prefixes are:

• Product List file: productlist
• Variant List file: variantlist

Where:

• <YYYYMMDD> = date (year, month, day)
• <HHMMSS> = time (hours, minutes, seconds, 24-hour clock)

Example filenames:

productlist_20251024_100000.csv
variantlist_20251024_100000.csv

When uploading files, both files in a set must use exactly the same date and time in the filename. The Spaaza importer processes files in increasing order of date and time of creation.

File Contents

Product files are valid CSVs with:

• Comma separators
• Double quotes (") as escape characters
• First row = column headers (UPPERCASE)
• UTF-8 encoding in Unix format (LF line endings)

Old-format feeds remain compatible; new fields are always added at the end of each file.

We recommend using a CSV validator to validate files before upload.

Version Tracking