HemiKnowledge BaseHemiIntegrations & Marketplace Documentation
Table of Contents
Related Articles
Knowledge Base
Hemi System Administration Integrations Hemi PRD Library Hemi Content Stream General Information Custom additions Core Integrations & Marketplace Documentation Hemi Advanced Functionalities Data Management MP Tokens generation Hemi Technology Trainings Hemi Platform Integrations Release Notes
FAQs

LaRedoute / LaRedoute User Guide

LaRedoute User Guide

We provide hybrid API integration as we use FTP for file transfer between both systems. All requests are done via API and all the responses are recieved on the sFTP. You can access the seller central from https://sellr.laredoute.com/web/guest/welcome

Account set up

  1. Log into the respective Hemi installation and go to Admin Tasks > Account, click the
  1. Fill in the form for LaRedoute as shown:
  • Tick Active so your account could be activated
  • Choose your LaRedoute account name
  • Select LaRedoute for marketplace
  • Enter Time zone – select the correct time zone by clicking Available Time Zones
  • On the next screen Exchange Rate Calculator Fields (Arcade specific, for the time being the functionality is not fully developed, please restrain from filling in any fields that are not explicitly stated in this document): Enter EUR as currency
  • Fill the information in “Account Marketplace LaRedoute” tab
  • Login User – The account username
  • Login Password – The account password
  • SFTP Host – This is the Host for the LaRedoute FTP server which you receive via email
  • SFTP User – This is the User for the LaRedoute FTP server which you receive via email
  • SFTP Password – This is the Password for the LaRedoute FTP server which you receive via email
  • SFTP Port – This is the Port for the LaRedoute FTP server which you receive via email
  • Vendor ID – Seller ID received via email
  • Create Items Token – Token is received via email
  • Read Orders Token – Token is received via email
  • Update Orders Token – Token is received via email
  • Default Tracking URL - Carrier site tracking link
  • Calculate RRP - Indicates if the RRP calculation is triggered
  • Discount RRP as a percentage - Specify the threshold percentage of the RRP discount

3. RRP Calculation functionality

If you have turned on the Calculate RRP you also will have to specify the Discount RRP as a percentage in order to activate the feature. What will happen and how it works: For example we have Calculate RRP = True and Discount RRP as a percentage = 40% This way we will calculate the RRP for all products where there is difference between StartPrice and RRP > 40%. We will re-calculate all RRPs which are 40% bigger then the StartPrice and send exactly 40% bigger RRP than the StartPrice.  If there is a requirement that the RRP can not be bigger than 40%. All other RRPs which difference does not hit the Discount RRP as a percentage the StartPrice will be send as normal.  It is important to check what is the requirement on the channel before setting the Discount RRP as a percentage because if activated it will affect the whole account.

  • Example behaviour:

    StartPrice = 100 RRP = 200

    200*0.6 = 120 (more than 100) THEN RRP = 100/0.6 = 166.66

  • ProductsThe product information can be found in Product tab:

End Listing currently not in use for this integration

  1. Promotion Manager The has to be imported using the Items Import in UNIX TIMESTAMP. Offer Nature is internal field in order to keep track of the promo.

    Some specifics when creating products in LaRedoute are:

    • La Redoute is a catalog based marketplace, there so we have to first create the products and then send an offer for the product. The mandatory specification for each product are:The product GTIN13/EAN13 number;The leaf category;The product identification;
    • Master SKU;
    • Title
    • Description
    • Product Brand (via brand code delivered by LaRedoute)
    • Main Photo
    • The Catalog identifier;The taxonomy attributes of the article subclass;The variation of attributes (color and size);One or several photos representing the article (8 photos max);

    The product description must be written in French. It should be sales oriented, appealing and respecting the legislation (ex: material composition, energy class). The description must be readable and correctly formatted (example via the use of HTML tags). We ask you to use HTML tags so the accented characters are correctly read and displayed on the website.

    Integration: Product creation

    LaRedoute is a catalog based marketplace. Seller initially sends the mandatory information in order to create the item itself and then sends “offers” to the existing product. Offers could be send by a seller if he is authorized for the specific brands. If he is not, LaRedoute don’t list the seller. In situation where a new seller provides information that he owns or manufactures the brand the old seller will be denied access to the brand and no longer will be able to send offers. Prices, stock levels and delivery options are all set in the offers. All offers are to be send per EAN/SKU level, which means that the seller have to push as many offers as his SKUs for sale are.

    List items (uses Creating item list or updating existing item information FeedType) – Hemisphere launches one API call with required metadata to only create items - In Hemi “List/Update the whole item”=Pending. The status will change to “Sent” and after the product data pass quality check and validation on LaRedoute the status will be updated to “Not Needed” and the LaRedoute #part number will be downloaded as ChannelItemID. Once we send the products for creation we set the channel status as product_integrated. This cron job runs every 15 minutes.

    Update product data ( uses the Creating item list or updating existing item information FeedType)-   Hemisphere launches an API call with required metadata to only update items - In Hemi “List/Update the whole item”=Pending. The status will change to “Sent” and after the product data pass quality check and validation on LaRedoute the status will be updated to “Not Needed”. Note that once an item has been created in LaRedoute system you cannot update Seller Part #, Manufacturer, Manufacturer Part#, and UPC/EAN. If any error applies during the process and the item cannot be listed/updated LaRedoute will sent an error in the “Update Item Error:” text box with explanation why the error occurs and “List/Update the whole item”=Error. Once we successfully sent the offer the channel status is set to offer_integrated. This way we know that this product is live and we send updates for it. This cron job runs every 15 minutes.

    The feeds we generate can be tracked in https://{client}.myhemisphere.com/Hub/web/app_dev.php/en/form/table/16100 which contains all feeds we have send and https://{client}.myhemisphere.com/Hub/web/app_dev.php/en/form/table/16102 which have all feed objects (all products per feed)

    Integration: Product updates

    Stock Updates

    Type: Manual / Automated
    Frequency: every 30 mins

    Update products works only with channel status - offer_integrated Update stock uses the Updating inventory and price FeedType. Hemisphere launches an API call with required metadata to only update stock. In Hemisphere “Update Stock”=Pending. The status will be updated to “Not Needed” after success response from LaRedoute. If any error occur and the stock cannot be updated error message with clarification will be sent from LaRedoute in the “Error Updating Quantity” text area and “Update Stock”=Error. There are some limitations on stock updates – not to be sent often than 1 hour. LaRedoute system could not operate that fast and newer feed might overwrite and stuck the previous one and as a result none of them will be shown correctly on the website.

    Price Updates

    Type: Manual / Automated
    Frequency: every 30 mins

    Price updates - uses the Updating inventory and price FeedType. Hemisphere launches an API call with required metadata to only update prices. In Hemisphere “Update Price” = Pending. The status will be updated to “Not Needed” after success response from LaRedoute. If any error occur and the stock cannot be updated error message with clarification will be sent from LaRedoute in the “Error Updating Price” text area and “Update Price” = Error. There are some limitations on price updates – not to be sent often than 1 hour. LaRedoute system could not operate that fast and newer feed might overwrite and stuck the previous one and as a result none of them will be shown correctly on the website.

    Products delisting

    In Hemi “End item” = Yes on item account level will send 0 stock (stop the item from selling) the product on LaRedoute. This cron job runs every 15 minute. End item works only with channel status - offer_integrated

  • Orders

    Integration: Order download

    Orders are downloaded from LaRedoute every 10 minutes via API

    Integration: Order statuses

    There are 4 stages in the life cycle of an order on La Redoute:

    • Created - Customer order: When a buyer places an order on La Redoute, it is the MP who is first taking control. La Redoute uses a scoring tool to detect potential frauds on orders. If no fraud suspicion is detected, the order is created. Hemisphere is pilling data on regular intervals to retrieve the orders. The order will contain the following information: items references, quantity, price, postal code, city and delivery country. At this stage the order has a status “Created”.
    • Accepted - Seller acceptance: If all of the ordered items are present in stock, the seller can accept the order and the status is changed to “Accepted”.
    • Refused – order cancelled by Seller: Before the seller successfully receives the order, he has to check the stock level. If the product is no longer available, he can cancel the order. In that situation the status is changed to “Refused” and La Redoute sends an automatic e-mail to the buyer. When there is a multiple line order it is possible to cancel only the missing items and to accept the rest. Hemisphere is not able to do that currently.
    • To ship/ To Refund/ Refunded - Customer debit by La Redoute: The next step consists of verifying the customer creditworthiness. It is done by La Redoute which can, at this stage, cancel the order for payment failure. If the customer debit fails, the order status becomes “To cancel” and then automatically “Cancelled”. Otherwise, La Redoute debits the buyer and sends him an automatic e-mail “Acceptance of the Marketplace order”. After successful retrieval of the payment detail the status of the order becomes “To ship”. If the seller chooses to cancels the order at this stage, he cannot choose the status “To cancel”. The seller has to use the status “To refund”.
    • Shipped - Order shipped to the customer: If there are no problems with the order creation or anything else the seller can pick and pack the order. When this is complete, the seller has to send the “Shipped” status along with the delivery tracking information. La Redoute sends an automatic e-mail to the buyer “Shipping order e-mail”.

    Integration: Order updates

    Order updates runs every 10 minutes via API.

    Integration: Shipping methods

    There are two shipping methods:

    • Standard
    • Tracked (Express)

    Implementation: Payment methods

    There are two ways you can pay for your order:

    • Credit Card
    • PayPal

    Your account will be debited only at the time of dispatch.

    Integration: Cancellations & refunds

    • Order cancellations

    For LR canceled mean refused order

    • Order refunds

    Orders can be refunded via Hemisphere and LaRedoute only when the order status is To Ship or Shipped. The cron runs every 20 minutes.Refund flow for LaRedoute is the standardised and the correct way of refunding order is to use the order payment refund type row. In the new UI refund modal you will set up you refund details and depend on the order status Hemi will push refuse or refund. Please note this is handled from the integrationand there is no need to refuse the item and set the order status on pending.

Is this article helpful?
0 0 0