Entersaleremotely API: productsearchcode

Modified on: Wed, Apr 11, 2018

productsearchcode is the product identifier, its value often being your SKU for the product. It serves to:

Identify duplicate products when uploading. If an order line already exists on Feefo with the same orderref and productsearchcode as this order line, the item will be considered a duplicate item and will not be added to the system.

Identify the feedback for a particular product. When displaying product specific feedback on your website (i.e. displaying feedback for a specific product on the product's web page), the value of the productsearchcode will be an argument to a JavaScript call and/or a URL call to the Feefo badge generator, resulting in only feedback appropriate to that product being displayed.

Special Considerations

If multiple variations of a particular product are offered, such as a shirt that comes in red, blue and yellow, in sizes small, medium and large, it may not be desirable to have a separate productsearchcode for each variant. There is often a master variant code (a code that refers to all variants of a particular product) which might be a better choice than the variant SKU.

If the SKU contains the master code within it, or it has a common element, then the data can be uploaded with the variant SKU and the productsearchcode can be specified using a ‘wildcard’ on your product page, the wildcard character being an asterisk *. Please see the following examples for further clarification:

Example 1:

Product 1: Men's shirt, red, medium. SKU = 1234-med-rd

Product 2: Men's shirt, blue, small. SKU = 1234-small-bl

Master variant code = 1234

In this example, the master code ‘1234’ is contained in the product’s SKU. If the sales data is submitted to Feefo with the full product SKU, when selecting this product for feedback display and specifying the productsearchcode of ‘1234*’, feedback for both variants would be returned. If the same customer buys both items, the customer will be asked for feedback on both shirts separately, since the productsearchcode for each is different.

Example 2:

Product 1: Men's shirt, red, medium. SKU = abc123

Product 2: Men's shirt, blue, small. SKU = def234

Master variant code = men-shrt

The master code is not contained in the product’s SKU, and the product’s SKU has no common elements. If the sale is submitted with the master variant code ‘men-shrt’ as the productsearchcode for both products, requesting feedback for ‘men-shrt’ will return feedback for both products. Also, due to Feefo seeing both shirts as having a single productsearchcode, if a customer buys both items, they would only be asked for feedback about one product.

Note:productsearchcodedoes not support values that include the hash (#) character or the URL ASCII code %23.