Feefo Interface

Created by Migration Bot, Modified on Fri, 23 Oct at 2:29 PM by Migration Bot

Originally written by John Hardwick, last updated Oct 24, 2023, on the Swan Retail knowledge base (FRS).


Based on SwanFRS release version 1205

Overview

This document describes how to set up and operate the ‘customer feed-back’ request notification system, which sends feedback requests to Feefo.

It is necessary to change the configuration of SwanFRS to enable feedback processing. If you are wishing to use this service, please contact Swan Support or your implementation team.

An FTP connection is required to push the data collected in SwanFRS to the feedback provider.

Configuration

Application Parameters

Menu Location: System > Administration > Set Up Application Parameters

The following application parameters are required for this process to operate.

Parameter

Description

FEEDBACK_GTIN

Specify the GTIN number provided by your feedback provider

FEEDBACK_COMPLETE_AFTER_DAYS

Specify the number of days after the sales order is completed for the first time a feedback request is to be generated.

Setting to 0 turns this feature off.

FEEDBACK_SERVICE_AFTER_DAYS

Specify the number of days after the completion of the service call a feedback request is to be generated.

Setting to 0 turns this feature off.

FEEDBACK_ATTRIBUTE

Specify a list of ‘feedback’ attributes as specified by the feedback provider, separated by commas.

Customers

SwanFRS offers the ability to exclude pre-specified customers from the automated feedback request.

The control setting may be changed at any time prior to the completion of the sales order / service to turn off the feedback request service for this customer.

To omit the customer from the feedback process, tick the Exclude From Feedback checkbox.

Suppliers

SwanFRS allows chosen suppliers to be omitted from the feedback request, If the service / order relates solely to products or services provided by an excluded supplier the feedback request is not issued.

To omit the supplier from the feedback request, tick the Exclude From Feedback checkbox.

Other Exclusions

The feedback request is also excluded for orders / services for the following codes. Please check your system to ensure these codes are not used.

SKU Codes Omitted

55-1-127

5115-8356-34045

5115-8356-34046

5115-8356-34047

5115-8356-34048

5115-8356-34049

5115-8356-34050

5115-8356-34051

5115-8356-57619

5115-8356-57620

5115-8500-55769

5115-8500-36864

5115-11151-59372

5115-11152-2

46-1-128

46-1-160

46-6594-35898

46-9889-47864

46-9890-1

46-6594-29365

Product Groups Omitted

A72

A74

A80

S

S01

S03

U01

ALLOWANCE

Operation

There area no changes to the way orders or services are processed.

When the sales order changes to the COMPLETE status for the first time, the feedback request status is checked.

When a service order is CLOSED, the feedback process begins.

  • If the FEEDBACK_COMPLETE_AFTER_DAYS is set to zero, no sales order completions will be processed.

  • If the FEEDBACK_SERVICE_AFTER_DAYS is set to zero, no service completions will be processed.

The process of issuing a feedback request is fully automated.

  • Orders / services linked to sales orders who are not excluded will be considered.

  • Orders / services linked to non-excluded suppliers will be considered.

  • The customer must have valid email (email adheres to the <xxx>@<xxx> format)

  • If the order / service consists of solely excluded SKUs / product groups, no feedback request will be processed.

  • One record per item delivered / processed on the service will be generated.

The feedback request will be issued the stipulated number of days after the completion / closure of the order / service.

A record of the feedback request is recorded in the Sales Order Notes section.

The issuing process when automated will occur overnight at a pre-agreed time.

Where necessary, the Accounts Interface routine can be used to manually instigate the generation of feedback data.

Feedback requests are not triggered if further action is progressed on a completed sales order / closed service - for example, if the order is re-opened and new items are added or returns are processed.

Export Data

SwanFRS generates a comma separated data file which is output to the designated OUT folder and then FTP’d across to the feedback provider's server.

The format of the output file is as follows.

Merchant Identified
Customer Full Name
Customer Email
Completion Date (Original Order / Service Completion Date)
(Debranded) Supplier Name & Range
Sales Order Number
Product SKU
GTIN Code (FEEDBACK_GTIN)
Model number
Date Feedback Requested (Export Date)
Customer ID
Line Selling Value
(Tags) "Advisor="Salesperson
Feedback attributes (FEEDBACK_ATTRIBUTE)
Image Link (Blank Not Used)

Files from the Confluence page

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article