Sending Sales Data

The feedback process begins with you sending us a sales file, which is a list of your recent customers, together with what they’ve purchased and when. ...
Feefo’s preferred format for importing sales information is a tab-delimited (TXT) or comma-separated (CSV) data file encoded in UTF-8. If you're unsure a...
The following sales file fields can be used in tab-delimited (TXT), comma-separated (CSV) and XML files.  Note that field names are case-insensitive in t...
This article introduces Feefo's product catalogue and its structure, and provides instructions for creating, validating and uploading the file to the Fee...
The following product catalogue fields can be used in tab-delimited (TXT) or comma-separated (CSV) files encoded in UTF-8 format. Note that all field nam...
Feefo’s preferred format for importing sales (sales files) and product (product catalogues) information is a tab-delimited (TXT) or comma-separated (CSV) d...
A sales file consists of several required and optional fields saved as a UTF-8 encoded tab-delimited (TXT), comma-separated (CSV) or XML file. For in...
merchant identifier is used in both sales files and product catalogues to define the merchant’s unique Feefo identifier which is usually in the form me...
TXT/CSV file field name XML field name (case sensitive) Required/Optional Default value name name Required None name is the customer's name and has t...
TXT/CSV file field name XML field name (case sensitive) Required/Optional Default value email email Required None email is the customer's email address. ...
TXT/CSV file field name XML field name (case sensitive) Required/Optional Default value date date Required None date is the date that the sale was comple...
description is used by both sales files and product catalogues to define a brief description of the product being purchased or catalogued. It must accuratel...
mpn is recommended only if the product does not have a manufacturer assigned gtin.  The inclusion of gtin or mpn and brand will be required in future releas...
TXT/CSV file field name XML field name (case sensitive) Required/Optional Default value order ref order_ref Required None order ref is the unique ide...
product search code is the product identifier, its value consisting of unicode characters that is often an SKU for the product. It is used in both sales f...
gtin is recommended for both sales files and product catalogues if the product being uploaded or catalogued has a Global Trade Item Number (GTIN).  You can...
TXT/CSV file field name XML field name (case sensitive) Required/Optional Default value mobile mobile Optional (Required when sending SMS messages) N...
TXT/CSV file field name XML field name (case sensitive) Required/Optional Default value feedback date feedback_date Optional As defined by the Feedbac...
TXT/CSV file field name XML field name (case sensitive) Required/Optional Default value customer ref customer_ref Optional None customer ref is your ...
TXT/CSV file field name XML field name (case sensitive) Required/Optional Default value amount amount Optional None amount is the numerical value paid f...
TXT/CSV file field name XML field name (case sensitive) Required/Optional Default value currency currency Optional The currency of the country associat...
product link is the full URL starting with http or https to the product page on your website (do not include tracking string parameters). It’s used to c...
image link is the full URL starting with http or https to the product's main image. The image can be sourced from any server or website. It’s used to displa...
tags define additional attributes for uploaded sales data or product catalogues allowing you to create subsets of the full data. Data subsets can be us...
The following table lists the sales and product tags that can be applied to sales file data.  Note that each tag can only be applied once per sale, the 't...
TXT/CSV file field name XML field name (case sensitive) Required/Optional Default value locale locale Optional Your 'language_country' loc...
product attributes are used to extend the single product rating that Feefo requests for products. Rather than just a single rating, you might wish to...
parent product ref is used for both sales files and product catalogues as the product's parent search identifier, its value consisting of unicode characte...
title is a required field in a product catalogue to define the name of the product. It should accurately describe your product and match the title on your l...
brand is used in a product catalogue to define the brand name of the product. It is only required if the product has an mpn. The inclusion of gtin or mpn an...
image link is the full URL starting with http or https to the product's main image. The image can be sourced from any server or website. It’s used to di...
product category indicates the category of your item based on the Google product classifications. Although optional, categorising your product ensures that ...