Skip to main content

Send your product and order data to ManoMano

Learn how to send data to the ManoMano marketplace in Productsup.

Introduction

ManoMano is a large European marketplace for DIY, gardening, and home improvement products and services. With France as its biggest market, the marketplace is active in the following six (6) countries:

  • France

  • Belgium

  • Germany

  • Spain

  • Italy

  • UK

Productsup has an ecosystem of five (5) exports and one (1) data source to let you manage your products and orders on ManoMano:

  1. ManoMano - Product Creation

    This flat-file export generates a CSV file with all your products to let you upload them to your ManoMano account.

  2. ManoMano API - Product Update (Price & Stock)

    This API-based export sends price- and stock-related updates to ManoMano.

  3. ManoMano Orders Import v1

    This data source imports orders from ManoMano into Productsup.

  4. ManoMano API - Order Accept/Refuse

    This API-based export lets you accept or refuse orders on ManoMano.

  5. ManoMano API - Refund Orders

    This API-based export sends order refund statuses to ManoMano.

  6. ManoMano API - Shipment Notifications

    This API-based export updates shipment-related data on ManoMano.

To send your product and order data to the ManoMano marketplace, you need to set up this ecosystem in the following order:

  1. ManoMano - Product Creation. See Add an export to send product data to ManoMano.

  2. ManoMano API - Product Update (Price & Stock). See Add an export to update price and stock data on ManoMano.

  3. ManoMano Orders Import v1. See Import orders from ManoMano.

  4. Order-data exports. See Add exports to send order updates to ManoMano.

Prerequisites

The export ManoMano - Product Creation doesn't have any specific prerequisites. To use all API-based ManoMano exports and the order-import data source, you need the following:

  • An active ManoMano seller account.

  • Your ManoMano seller ID.

  • An API key to authenticate in your ManoMano account.

Add an export to send product data to ManoMano

To post your products on ManoMano, add and set up the export ManoMano - Product Creation:

  1. Go to Exports from your site's main menu and select ADD EXPORT.

  2. Search for ManoMano - Product Creation, hover over it, and select Add.

    Add the export ManoMano - Product Creation
  3. Go to Dataflow from the site's main menu and choose the export ManoMano - Product Creation from the drop-down menu in the top ribbon on the left.

  4. Map the mandatory attributes from import to export. You can also map non-mandatory attributes if you have the needed data. Apply rule boxes to optimize the data if needed.

    Tip

    Use the Automap connections drop-down menu in the top ribbon to let the platform automatically connect the attributes.

    Automap connections
  5. Go to Exports and select the name of the export ManoMano - Product Creation.

  6. Select Add Destination, choose Productsup Server from the drop-down list, give it a name as desired, and then select Save.

    Note

    The Productsup Server destination generates a link with a CSV file containing your product data. You can use other available destinations to send data to your ManoMano account if needed.

  7. If your data is ready, select Run or Export this export in the upper right corner of the page.

  8. To copy the link to the output CSV file, go to the Filename section at the bottom of the export setup page.

    Filename download
  9. Paste the link to the CSV file in your ManoMano seller account to let the marketplace upload your products.

Add an export to update price and stock data on ManoMano

To let Productsup automatically update your products' pricing and availability data on ManoMano, add and set up the export ManoMano API - Product Update (Price & Stock):

  1. Go to Exports from your site's main menu and select ADD EXPORT.

  2. Search for ManoMano API - Product Update (Price & Stock), hover over it, and select Add.

    Add the export ManoMano - Product Update (Price & Stock)

    Note

    To use this export, the products you want to update should already exist in your ManoMano seller account.

  3. Go to Dataflow from the site's main menu and choose the export ManoMano API - Product Update (Price & Stock) from the drop-down menu in the top ribbon on the left.

  4. Map the following attributes from import to export:

    1. sku

    2. quantity

    3. price_vat_included

  5. Go to Exports and select the name of the export ManoMano API - Product Update (Price & Stock).

  6. Select Add Destination, choose ManoMano API - Product Update from the drop-down list, give it a name as desired, and then select Save.

  7. In Environment, select whether this export should send data to a test or live ManoMano account:

    1. Sandbox means the export sends data to a test account on ManoMano.

    2. Production means the export sends data to a live ManoMano account.

  8. In Seller contract id, enter your ManoMano seller ID.

  9. In Api key, enter an API key to let the platform authenticate in your ManoMano account.

  10. Toggle the Feedback Import button to Off if you don't want the platform to receive feedback files from ManoMano.

    This feature is active by default to let Productsup receive a feedback file from the ManoMano Partner API in case of errors. This helps to troubleshoot the export setup.

  11. Toggle the Active button to On.

  12. Select Save.

  13. If your data is ready, select Run or Export this export in the upper right corner of the page.

Import orders from ManoMano

To let the platform import orders from your ManoMano seller account, add and set up the data source ManoMano Orders Import v1:

  1. Go to Data Sources from your site's main menu and select ADD DATA SOURCE.

  2. Search for ManoMano Orders Import v1, select Add, give it a name as desired, and then choose Continue.

    Add the data source ManoMano Orders Import v1
  3. In Environment, select whether this data source should import data from a test or live ManoMano account:

    1. Sandbox means the data source imports data from a test account on ManoMano.

    2. Production means the data source imports data from a live ManoMano account.

  4. In Seller contract id, enter your ManoMano seller ID.

  5. In Api key, enter an API key to let the platform authenticate in your ManoMano account.

  6. If you want your Productsup site to import orders with specific statuses only, enter them in Order status and separate them with commas.

    The supported order statuses are:

    1. WAITING_PAYMENT

    2. PENDING

    3. REFUSED

    4. PREPARATION

    5. SHIPPED

    6. REFUNDED

    7. REFUNDING

    8. REMORSE_PERIOD

    Note

    See ManoMano Partner API for more information on order statuses and the order flow. To proceed with order-data exports, you need to know what statuses support accepting, refusing, refunding, and shipping an order.

  7. If you want to import orders created within a specific timeframe only, select the desired dates in Orders from date and Orders till date.

  8. Specify the desired name of the data source in Description (optional).

  9. Select Save.

  10. Choose Run or Import in the upper right corner of the page to let the site import the order data.

Add exports to send order updates to ManoMano

To accept or refuse orders on ManoMano as well as send order refund statuses and shipment notifications to your ManoMano seller account, do the following:

  1. Go to Exports from your site's main menu and select ADD EXPORT.

  2. Search for ManoMano and check the boxes next to the following exports:

    1. ManoMano API - Order Accept/Refuse

    2. ManoMano API - Refund Orders

    3. ManoMano API - Shipment Notifications

    Add ManoMano API exports to send order data
  3. Select Add exports at the bottom of the page.

  4. Go to Dataflow from the site's main menu. Choose the added ManoMano exports in the drop-down menu on the left and map the following attributes from import to export:

    Export name

    Export-stage attributes

    ManoMano API - Order Accept/Refuse

    • order_reference

    ManoMano API - Refund Orders

    • order_reference

    • quantity

    • refund_reason

    • refund_shipping_fees

    • seller_sku

    ManoMano API - Shipment Notifications

    • order_reference

    • quantity

    • seller_sku

    • seller_contract_id

    • carrier

    • tracking_number

    • tracking_url

  5. Go to Exports, select the name of each added ManoMano export, and choose Add Destination to add and set up the following export destinations:

    1. For the export ManoMano API - Order Accept/Refuse, choose the destination ManoMano API - Order accept/refuse v1.

    2. For the export ManoMano API - Refund Orders, choose the destination ManoMano API - Refund Orders.

    3. For the export ManoMano API - Shipment Notifications, choose the destination ManoMano API - Shipment Notifications.

  6. Change the names of the added destinations as desired and select Save.

  7. On the setup page of each destination, take these steps:

    1. In Environment, select whether the destination should send data to a test or live ManoMano account:

      1. Sandbox means the destination sends data to a test account on ManoMano.

      2. Production means the destination sends data to a live ManoMano account.

    2. In Seller contract id, enter your ManoMano seller ID.

    3. In Api key, enter an API key to let the platform authenticate in your ManoMano account.

    4. Toggle the Feedback Import button to Off if you don't want the platform to receive feedback files from ManoMano.

      This feature is active by default to let Productsup receive a feedback file from the ManoMano Partner API in case of errors. This helps to troubleshoot the export setup.

    5. Toggle the Active button to On.

  8. On the setup page of the destination ManoMano API - Refund Orders, select one of the following values in the Accept or Refuse drop-down menu:

    1. Select Accept to let the destination send orders to ManoMano with the status PREPARATION.

    2. Select Refuse to let the destination send orders to ManoMano with the status REFUSED.

    Tip

    To let Productsup export both accepted and refused orders, set up two (2) separate ManoMano API - Refund Orders exports and choose different values in this drop-down menu.

  9. Select Save.

  10. If your data is ready, select Run or Export this export in the upper right corner of the page.