2.2.1. Full integration Setup with Magento 2.

This guide details the process of establishing a secure, two-way connection between your Magento 2 store and Fozzels. You will generate the necessary API Tokens and configure permissions, ensuring seamless product data import and content export.

The Magento 2 integration requires creating a dedicated New Integration in the Magento admin panel to generate four essential keys: Consumer Key, Consumer Secret, Access Token, and Access Token Secret. We will also configure the required fozzels_completion_date attribute for tracking content synchronization.

Part 1: Magento 2 Setup (Creating the Integration and Tokens)

You must create a new integration and define specific permissions within your Magento admin panel.

Step 1: Create a New Integration

1. Log in to your Magento admin panel.

2. Go to System / Integrations.

3. Click the “Add New Integration” button.

Step 2: Fill in Integration Info

1. Navigate to the Integration Info tab (Basic settings).

2. Fill in the required fields:
   2.1. Enter Name: Fozzels.
   2.2. Enter E-mail: info@fozzels.com.
   2.3. Enter your Magento admin password for confirmation.

3. Skip optional fields (Callback URL, Identity link URL).

Step 3: Configure API Permissions (Scopes)

1. Click the "API" tab.

2. In the dropdown menu, select "Custom".

3. Tick only these checkboxes (for Read/Write access):
   3.1. Catalog: Categories, Inventory, Products, Update Attributes, Edit Product Design.
   3.2. Stores: Settings, All Stores.
   3.3. Attributes: Product, Attribute Set.

Step 4: Save and Activate the Integration

1. Click the “Save” button in the top right corner.

2. On the Integrations list page, locate the new Fozzels integration.

3. Click the ”Activate” link.

4. On the activation detail page, check if the correct APIs (from Step 3) have been selected, and click "Allow".

Step 5: Copy and Store the API Keys

1. After clicking "Allow," you will be redirected to the “Integration tokens for extensions” page.

2. Copy and securely store all four automatically filled-in values:
   2.1. Consumer Key
   2.2. Consumer Secret
   2.3. Access Token
   2.4. Access Token Secret

3. Click “Done”.

4. Check or edit integration details later by pressing the “Edit” button on the Integrations page.
   
   

Part 2: Important: Configuring the Synchronization Tracking Attribute

Fozzels utilizes a special attribute named fozzels_completion_date on the Magento side to track the synchronization status and content delivery success.

Since Magento supports multiple attribute sets, Fozzels cannot automatically assign this attribute globally. Therefore, manual assignment in the Magento Admin panel is required for the attribute to be active and visible in your product grid.

Step 6: Assign the fozzels_completion_date Attribute

1. In Magento Admin, go to Stores / Attributes / Attribute Set / Default (or your primary set).

2. Under “Unassigned attributes,” find fozzels_completion_date.

3. Drag and drop it into the left column “Groups” under the “Product Details” category.

4. Click Save.
   
   
   
   

Part 3: Fozzels Activation and Data Sync

You will use the keys from Part 1 to connect Fozzels and initiate the data import.

Step 7: Create New Integration in Fozzels

1. Log in to your Fozzels account.

2. Go to Integrations.

3. Click “Create New Integration”.

4. Choose "Magento" from the available options.

Step 8: Fill in Connection Details

1. Name your integration clearly.

2. Enter the URL to your Magento website.

3. Fill in the four keys copied in Step 5 into the corresponding fields.

4. Click “Save”.

Step 9: Activate and Synchronize Stores

1. Switch on the ‘Active’ toggle in the top right corner. Without this, the connection will not work.

2. Navigate to the “Websites & Stores” tab.

3. Click the "Pull websites and stores" button. Your websites and stores should now appear.

4. Verify that the integration has the following statuses: Authorized: yes and REST API Connected: yes.

5. Enable the current websites and stores using the toggle for further work.

Step 10: Pull Products and Verify

1. Click the “Pull Products” button to start the process of importing your product catalog.
    

2. Wait for the products to load (progress will be shown in the progress bar).

3. Go to the "Attributes" tab to configure your synchronization rules.

4. Read more about working with product attributes and customizing data fields here.