Add Idealo Partner API v2.0 export

Add an Idealo Partner API v2.0 export from the Productsup platform.

Introduction

This section describes how you can upload your feed to the Idealo Partner API v2.0 in the Productsup platform.

See Idealo's Partner Web Service (PWS 2.0) API documentation.

In the platform, choose from four Idealo Partner API v2.0 export templates to upload your feed:

  • Idealo Partner API v2.0 - Price Comparison Offers export template for products available for price comparison.

  • Idealo Partner API v2.0 - Direct Checkout Offers export template for products available for direct checkout on Idealo.

  • Idealo Partner API v2.0 - Offers Export template for products available for direct checkout and price comparisons on Idealo.

  • Idealo Partner API v2.0 - Partial Offer Updates for updates to existing products only.

Requirements

You need to map two attribute groups in Dataflow to set up an Idealo Partner API v2.0 successfully:

  1. paymentCosts attributes - You must provide a value for at least one (1) payment cost field and for any payment method you accept.

    Idealo Partner API v2.0 export channel paymentCosts attribute
    • If you do not want to associate a cost, enter 0.00.

  2. energyLabels, referred to as EEK (Energy Efficient Class) attributes - You must have values for applicable products, for example, electronics, lighting, and tires, for these fields, as required under EU law:

    Idealo Partner API v2.0 energyLabels attributes

    See:

    You can also learn more in Idealo's API documentation regarding labels. See Partner Web Service (PWS 2.0) API Documentation.

Idealo Partner API v2.0 - Price Comparison Offers

Use the Idealo Partner API v2.0 - Price Comparison Offers export template for products available for price comparison.

  1. Go to Exports A/B from your site’s main menu.

  2. Select ADD EXPORT and search for Idealo Partner API v2.0 - Price Comparison Offers.

    add_idealo_price_comparison_offs__export.png
  3. Select Add, give it a custom name if you desire, and select Add again.

  4. Under Destinations, select Add Destination and choose Idealo Offer Export API from the drop-down list. Optionally, you can customize the destination's description in Name.

    add_ideal_off_api_destination.png
  5. In Client ID and Client Secret, enter your Idealo client credentials.

  6. Enter the Idealo Shop ID for shop orders.

  7. (Optional) To continue with the feedback import option, switch Feedback import to On. Use this option if you want an error file returned to the platform once your data export finishes. The platform returns the feedback error file to your site as an additional data source with the following:

    • SKU: Your product ID. This field contains the default name or the name you defined during setup in step 3.

    • **___idealo_id**: The Idealo product ID.

    • **___idealo_status**: Product upload status. For example, OK, failed, and ignored.

    • **___idealo_status_message**: The reason why the upload failed for this product. For example, Mandatory field 'title' is missing or empty!

  8. Turn on the destination by switching Active to On.

  9. Select Save.

    idealo_api_destination_settings.png

Idealo Partner API v2.0 - Direct Checkout Offers

Use the Idealo Partner API v2.0 - Direct Checkout Offers export template for products available for direct checkout on Idealo.

  1. Go to Exports A/B from your site’s main menu.

  2. Select ADD EXPORT and search for Idealo Partner API v2.0 - Direct Checkout Offers.

    add_idealo_direct_checkout_offs__export.png
  3. Select Add, give it a custom name if you desire, and select Add again.

  4. Under Destinations, select Add Destination and choose Idealo Offer Export API from the drop-down list. Optionally, you can customize the destination's description in Name.

    add_ideal_off_api_destination.png
  5. In Client ID and Client Secret, enter your Idealo client credentials.

  6. Enter the Idealo Shop ID for shop orders.

  7. (Optional) To continue with the feedback import option, switch Feedback import to On. Use this option if you want an error file returned to the platform once your data export finishes. The platform returns the feedback error file to your site as an additional data source with the following:

    • SKU: Your product ID. This field contains the default name or the name you defined during setup in step 3.

    • **___idealo_id**: The Idealo product ID.

    • **___idealo_status**: Product upload status. For example, OK, failed, and ignored.

    • **___idealo_status_message**: The reason why the upload failed for this product. For example, Mandatory field 'title' is missing or empty!

  8. Turn on the destination by switching Active to On.

  9. Select Save.

    idealo_api_destination_settings.png

Idealo Partner API v2.0 - Offers Export

Use the Idealo Partner API v2.0 - Offers Export template for products available for direct checkout and price comparisons on Idealo.

  1. Go to Exports A/B from your site’s main menu.

  2. Select ADD EXPORT and search for Idealo Partner API v2.0 - Offers Export.

    add_idealo_offers_export.png
  3. Select Add, give it a custom name if you desire, and select Add again.

  4. Under Destinations, select Add Destination and choose Idealo Offer Export API from the drop-down list. Optionally, you can customize the destination's description in Name.

    add_ideal_off_api_destination.png
  5. In Client ID and Client Secret, enter your Idealo client credentials.

  6. Enter the Idealo Shop ID for shop orders.

  7. (Optional) To continue with the feedback import option, switch Feedback import to On. Use this option if you want an error file returned to the platform once your data export finishes. The platform returns the feedback error file to your site as an additional data source with the following:

    • SKU: Your product ID. This field contains the default name or the name you defined during setup in step 3.

    • **___idealo_id**: The Idealo product ID.

    • **___idealo_status**: Product upload status. For example, OK, failed, and ignored.

    • **___idealo_status_message**: The reason why the upload failed for this product. For example, Mandatory field 'title' is missing or empty!

  8. Turn on the destination by switching Active to On.

  9. Select Save.

    idealo_api_destination_settings.png

Idealo Partner API v2.0 - Partial Offer Updates

Use the Idealo Partner API v2.0 - Partial Offer Updates for updates to existing products only. This method is efficient since there are fewer attributes required to send.

  1. Go to Exports A/B from your site’s main menu.

  2. Select ADD EXPORT and search for Idealo Partner API v2.0 - Partial Offer Updates.

    add_idealo_partial_offs__updates_export.png
  3. Select Add, give it a custom name if you desire, and select Add again.

  4. Under Destinations, select Add Destination and choose Idealo Offer Updates API from the drop-down list. Optionally, you can customize the destination's description in Name.

    add_idealo_partial_off_update.png
  5. In Client ID and Client Secret, enter your Idealo client credentials.

  6. Enter the Idealo Shop ID for shop orders.

  7. (Optional) To continue with the feedback import option, switch Feedback import to On. Use this option if you want an error file returned to the platform once your data export finishes. The platform returns the feedback error file to your site as an additional data source with the following:

    • SKU: Your product ID. This field contains the default name or the name you defined during setup in step 3.

    • **___idealo_id**: The Idealo product ID.

    • **___idealo_status**: Product upload status. For example, OK, failed, and ignored.

    • **___idealo_status_message**: The reason why the upload failed for this product. For example, Mandatory field 'title' is missing or empty!

  8. Turn on the destination by switching Active to On.

  9. Select Save.

    idealo_offer_updates_destination_settings.png