Knowledgebase: Modules

Shift4Shop and Extend.com Integration

 

This integration will allow you to sell your Extend.com Warranty contracts directly from your product pages.

Requirements:

  • Shift4Shop store with the following:
    • Extend.com module purchased and enabled
    • Core Theme
  • Extend.com account with the following:
    • Store ID
    • API key

Configuring the Module

Once the module is purchased and enabled:

  1. Log into your Shift4Shop Online Store Manager
  2. Using the left hand navigation menu, go to Modules
  3. On the Modules page, use the search bar at the top to search for “Extend.com Integration”

  1. When the module appears, click on “Settings”
  2. Mark the “Enable” checkbox
  3. Enter your Extend.com Store ID in the first provided field
  4. Enter your Extend API Key in the second provided field
  5. Click “Save” at the top right

The module is now enabled and configured.


Custom Export Set

The next step is to create a custom CSV export that will be used to synchronize products from your Shift4Shop store to your Extend.com account.

From your Shift4Shop Online Store Manager:

  1. Using the left hand navigation menu, go to Products >Product List
  2. Once there, click on the “Export/Import” button located at the top right.
  3. Next, click on the + icon next to Products on the “Export” side of the page.
  4. Click on “Manage” next to “Export Sets” to create your custom export set.
  5. On the next page, click on the “+Add New” button to begin creating the Custom Export Set.
  6. Enter a name for the export set. For example “Extend” or “Extend Export”
  7. Click “Save” to continue

The next steps involve adding existing export fields that your Shift4Shop uses for product information and configuring them into a format that will be use by your Extend.com account.

At the top of the page, you will see a drop down menu labeled “Add New Field” where you will select the Shift4Shop specific fields. When you select a field from the dropdown menu and click “+Add New” the field will be added to the bottom of the page. After it is added to the export set, you will change the Alias so that the field will be recognized by your Extend.com account.

We’ll go over adding the first one for reference.

  1. Click on the “Add New Field” dropdown menu and select “manufacturer”
  2. Click on the “+Add New” button to add the field to your export set.
  3. Once the field is added, change the Alias field to “brand” (all lowercase)
  4. Click Save.

Repeat these steps for the rest of the fields using the following:
(Note spelling and letter-case for the alias entries)

Shift4Shop Field Alias
categories category
description description
image_link imageUrl
extra_field_11 mfrWarrantyParts
extra_field_12 mfrWarrantyLabor
extra_field_13 mfrWarrantyUrl
price price
title title
catalogid referenceId
id sku
gtin gtin

Your completed export set should look like the following:

Using the Custom Export Set

To export your Extend.com CSV file:

  1. Using the left hand navigation menu, go to Products >Product List
  2. Once there, click on the “Export/Import” button located at the top right.
  3. Next, click on the + icon next to Products on the “Export” side of the page.
  4. Under “Export Sets” select the custom export set you created in the steps above
  5. Click “Export Data” to generate the CSV file

When the export is complete, download the CSV file to your computer. This file will then be uploaded to your Extend.com account for the synchronization.


HTML Template Edits

Products designated with Extend.com warranties will have the warranty selectors added to the product listing page.

If your store is using the default listing_0.html template found with Core Themes, you will not need to make any changes to your HTML. However, if you have customized your listing_0.html template, you will need to make sure the following changes are in place on the template (to ensure the warranty buttons appear correctly).

Template: listing_0.html

Section 1: Look for the following:

<!--END: CATEGORY_FULLINE-->

Add the following immediately after

<!--START: extendWarrantySdk-->
<!--END: extendWarrantySdk-->

Section 2: Look for the following:

<!--START: Google_Pay-->

Add the following right before:

<!--START: extend_warranty_offer_block-->
<div id="extend-offer"></div>
<!--END: extend_warranty_offer_block-->

<div class="clear"></div>

Help Desk Software by Kayako fusion