Overview
      Back to home
      1. Knowledge Base
      2. Sales
      3. Overview

      Reevoo customer_order API Migration

      TABLE OF CONTENTS

       

      Introduction

      As part of the deprecation of Reevoo's customer_order and customer_orders functionality, Feefo now offers an alternative solution through our EnterSaleRemotely API. This API allows you to submit orders and sales data to your Feefo account seamlessly. In this article, we'll explain how to use the EnterSaleRemotely API and provide details on its endpoint, authentication, and parameters for order information.

       

      What is the EnterSaleRemotely API?


      Feefo's EnterSaleRemotely API enables you to make POST requests to submit single order-product lines directly to your Feefo account. It also allows you to combine follow-up POST requests with multiple products, automatically batching orders with the same reference, merchant identifier, and future feedback date.

       

      API Endpoint


      The EnterSaleRemotely API endpoint is

      https://api.feefo.com/api/20/entersaleremotely 

      When you make POST requests to this endpoint, you may receive a 200, 500, or 400 response.

       

      Specifying Your Feefo Account

      In Feefo, your account is identified by a parameter called a merchant identifier, which you can find within your Feefo account's business details page. If your Feefo account has a group-level account structure, any request sent to that group-level account, specifying a merchant identifier within the account structure, will automatically be accepted and submitted to the correct account within the structure, as specified by that merchant identifier.

       

      Authentication


      Unlike Reevoo's customer_order API, the Feefo EnterSaleRemotely API authenticates against an OAuth 2.0 bearer token. This token is generated by secure credentials stored on your Feefo account's App Keys. Detailed instructions on generating and providing a bearer token can be found in our knowledge base.

      The resulting token should be applied as an Authorization header in your request, with the value being "Bearer TOKENGENERATED."

       

      Parameters and Order Information


      Once you have a valid Feefo App Key OAuth 2.0 token generated and applied as a header, you can add the order/sale information through the Body as raw JSON or x-www-form-urlencoded content.

      Below, we provide a list of old customer_order API parameters along with their applicable new parameters for Feefo's EnterSaleRemotely API:

      • Old customer_order API Parameter: orderref
        • New Parameter: orderReference
      • Old customer_order API Parameter: feedbackdate
        • New Parameter: futureFeedbackDate

      Please note that Feefo offers many new parameters, most of which are Product parameters that are optional. These parameters can be ingested through your product feed, product catalog, and/or Google Shopping feed connection. While orderReference and futureFeedbackDate are not mandatory for the upload to be successful, we strongly recommend providing them where possible.

      Old Parameter

      New Parameter

      		 Requirement Description Example

      TRKREF

      MERCHANTIDENTIFIER

      		 Mandatory The merchant's unique Feefo identifier BEST-FRIDGE-UK
      EMAIL EMAIL Mandatory The customer's email address john.smith@email.com
      FIRST_NAME NAME Mandatory The customer's name John Smith
      SKU PRODUCTSEARCHCODE Mandatory The product identifier FRESH22
      ORDER_DATE DATE Mandatory The date of sale 01/01/2023
      ORDER_REF ORDEREF Recommended The merchant's order identifier FRE22JHSM23
      CUSTOMER_REF CUSTOMERREF Optional The merchant's customer reference number  JS02
      LOCALE LOCALE Optional The language of the email that are sent to the customer EN_GB
      PRIC AMOUNT Optional The price paid for the item purchased 300.00
        CURRENCY Optional Currency for the amount GBP
        FEEDBACKDATE Recommended A specific date on which the feedback for this order should be sent 02/02/23
        TAGS Optional Used for filtering data by sales or product attributes for further analysis  
        DESCRIPTION Optional Description of the item purchased  
        PARENTSEARCHCODE Optional The product's parent identifier  
        GTIN Optional The product's global trade item number  
        MPN Optional The product's manufacturer part number  
        PRODUCTLINK Optional The URL to the product page for the product  
        PRODUCTATTRIBUTES Optional Product qualities requiring  targeted feedback through separate feedback form questions   
      FULFILMENT_DATE N/A N/A N/A  
      LANGUAGE N/A N/A N/A  
      TITLE N/A N/A N/A  
      ORDER_ITEMS N/A N/A N/A  
      METADATA N/A N/A N/A  
      KEY_WITH_UNDERSCORE N/A N/A N/A  


      An example request with POST raw JSON BODY is below:

      Endpoint:
      POST: https://api.feefo.com/api/20/entersaleremotely
      HEADER: Authorization:Bearer TOKEN-GENERATED
      BODY:


      {
      "merchantidentifier": "adam-tech-test",
      "email": "john.smith@feefo.com",
      "name": "John",
      "description": "JSONPOST",
      "orderref": "POSTJSON01",
      "date": "01/01/2000",
      "vendorref": "JSONPOST"
      }

       

      Summary

      For more information on Feefo's EnterSaleRemotely API and how to submit orders/sales seamlessly, please refer to our knowledge base or reach out to our support team if you have any questions or need assistance.