Integrating with Pimberly

You can quickly and easily integrate Elastic Path Commerce Cloud with Pimberly using the Integrations Hub in Commerce Manager. Integrating Pimberly with Elastic Path Commerce Cloud means you can synchronize catalog data such as products, price, images, and categories between Elastic Path Commerce Cloud and Pimberly.

You can also migrate your catalog data related information to Elastic Path Commerce Cloud as this integration can load all the data from Pimberly.

Collect the following setup information from Pimberly.

To create a new application key, go to SYSTEM > Application Keys.

As part of the Pimberly Integration, changes in catalog data in Pimberly automatically updates catalog data in Elastic Path Commerce Cloud.

• Ensure that you have collected your setup Information.
• Ensure that you have created a template for price book, hierarchies, templates, and Variations in Commerce Manager.

1. In Commerce Manager, go to COMPOSER > Integrations Hub.

2. Under Product Information, click Pimberly.

3. Click Configure. The Pimberly integration guides you through the steps you need to follow to complete the integration.

4. Click Next. The Connection page is displayed.

5. On Connection page, do the following:

   1. Complete the Elastic Path Commerce Cloud Connection credential details:

      • Client-ID - Your Elastic Path Commerce Cloud Client ID.
      • Client-Secret - Your Elastic Path Commerce Cloud Client Secret.
      • Token URL - Your Elastic Path Commerce Cloud API Token URL

   2. Click Connect. The authorization is successfully completed.

   3. Complete the Pimberly Connection credential details:

      • API Key - Your Pimberly API Key.
      • API Base URL - Your Pimberly API Base URL. Default value is https://sandbox.pimber.ly/api/v2.2
      • Webhook URL - Your Pimberly Webhook URL. Default value is https://sandbox-api.pimberly.io

6. Click Next. The Configuration page is displayed.

   The Enable Webhook Setup toggle is always enabled by default to automatically enable webhook in Pimberly.

7. In the Value fields, under the Webhook Actions section, create and update actions are set by default.

   You can set up your webhook actions depending on your requirements. For example, if you only want to publish a message when a product is updated, then delete create from the Value field.

8. (Optional) To add move values, click +Add value.

9. (Optional) If you want to trigger full sync, turn on the Enable Full Sync toggle. The full sync will be triggered as per the Full Sync Cron Job Time. It is disabled by default.

   Default value of Full Sync Cron Job Time is 0 0 31 12. You can set your own time to run the full sync periodically.

10. Click Next. The Templates page is displayed.

11. Click Edit under the Product Template.

12. Update the Product Template to map the Elastic Path Commerce Cloud product templates and attributes to Pimberly. For example, suppose you want to import pimberly field Feature-1 and Feature-2 attributes into Commerce Manager. You need to update the corresponding templateSlug and fieldSlug fields to represent attribute slug in Elastic Path Commerce Cloud.

    The following example shows how this should look in the Product Template.

    "attributes":[[
    {
        "templateSlug":"products(extension)",
        "templateAttributes": [
            [
                $merge([
                    ($.'Feature 1' ?
                        {
                            "fieldSlug":"feature1",
                            "type":"string",
                            "value":$.'Feature 1'
                        } : {}
                    )
                ]),
                $merge([
                    ($.'Feature 2' ?
                        {
                            "fieldSlug":"feature2",
                            "type":"string",
                            "value":$.'Feature 2'
                        } : {}
                    )
                ])
            ]  ~> $filter(function($v, $i, $a) {
                $v.value
            })
        ]
    }
]] ~> $filter(function($v, $i, $a) {
        $count($v.templateAttributes) > 0
})

1. Click Edit under the Node Template.

2. Update the name of the hierarchy created in Elastic Path Commerce Cloud in the hierarchySlug field.

   For example:

   "hierarchySlug": "uk-hierarchy"
   

3. Click Edit under Price Template.

4. Update the price book name of Elastic Path Commerce Cloud in priceBookName field. For example, if the price book name is UKandIEPricebook in Commerce cloud, update the same in the Price Template.

   For example:

   "priceBookName": "UKandIEPricebook"
   

5. Click Edit under the Variation Template.

6. Update the variation template to map with the Elastic Path Commerce Cloud. This is similar to Product Template. If you make any changes in Product, you need to make similar changes in Variations as well.

7. Click Next. The Field Settings page is displayed.

8. In the Child Product Field, the default value is Pimberly is Items. Update this field if you change this in Pimberly.

9. In the Parent Product Field, the default value in Pimberly is Parents. Update this field if you change this in Pimberly.

10. In the Product Type Field, the default value in Pimberly is Product Type. Update this field if you change this in Pimberly.

11. In the Parent Product Type field, the default value in Pimberly is Product. Update this field if you change this in Pimberly.

12. In the SKU Product Type field, the default value in Pimberly is SKU. Update this field if you change this in Pimberly.

13. Click Finish. Your integration is enabled. The webhook will be triggered sucessfully, and you can see the trigger details in Commerce Manager.

Watch the following video to learn how to synchronize your catalog data from Pimberly to Elastic Path Commerce Cloud: