Parts-Catalogs integration by HTML

1. Prerequisites
2. Get an TWS-key
3. Basic settings
4. Additional settings
5. Install on your website
6. Functionality check
7. FAQ
8. Technical Support

Prerequisites

• TWS-key to integrate with Parts-Catalogs
• Access to edit your website code
• Basic knowledge of HTML/JavaScript

⚠️ We strongly recommend involving a web developer familiar with your website structure

Get an TWS-key

1. Contact your Parts-Catalogs manager
2. Provide the website domain name for HTML-integration
3. Get the API key for integration

🔑 The TWS-key follows the format XXX-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX and remains valid while your subscription is activated

Basic settings

1. Go to the integration page
2. In the Mandatory Settings:
   • Enter your TWS-key
   • Configure the link template for search results

Format of the Link template

/search.html?article={article}&brand={brand}

Available parameters:

💡 See a detailed guide to configure the link template in the article How to get a back-URL for Parts-Catalogs

Additional settings

Language settings

• Select the catalog language or leave the Default value
• Supported languages: Russian, English

Appearance

• Choose a color theme
• Customize the interface elements

Restrict available catalogs

By default, the widget provides access to all OEM catalogs. If you work only with specific brands, you can restrict the list of available catalogs.

To do this, enter the brand names separated by commas:

BMW, AUDI, MERCEDES-BENZ

As a result:

• You can display catalogs only for the selected manufacturers
• Search is conducted only within the selected brands
• Requests to other catalogs are not processed

💡 If the field is left empty, all brands in the catalogs are available

Examples:

• Japanese manufacturers only: TOYOTA, NISSAN, HONDA, MITSUBISHI
• German brands only BMW, AUDI, MERCEDES-BENZ, VOLKSWAGEN, PORSCHE
• Truck manufacturers only: VOLVO TRUCKS, SCANIA, MAN, DAF

Install on your website

1. Copy the generated code
2. Enter the code into the HTML coding of your website

Examples of installation for different CMS:

<?php
// Add it to header.php or through HTML-integration.
?>
<div id="parts-catalog"
  data-key="XXX-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX"
  data-back-url="/search.html?article={article}&brand={brand}"
></div>

<script type="text/javascript" src="https://gui.parts-catalogs.com/v3/parts-catalogs.js"></script>

<?require($_SERVER["DOCUMENT_ROOT"]."/bitrix/header.php");

<div id="parts-catalog"
  data-key="XXX-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX"
  data-back-url="/search.html?article={article}&brand={brand}"
></div>

<script type="text/javascript" src="https://gui.parts-catalogs.com/v3/parts-catalogs.js"></script>

<?require($_SERVER["DOCUMENT_ROOT"]."/bitrix/footer.php");?>

Functionality check

✅ Check list:

1. The catalog is displayed correctly
2. Search works properly
3. Search results open as expected
4. All selected catalogs are available

FAQ

Technical Support

Should you still have questions or need any assistance, our Technical Support team is always ready to help. Contact us →

📚 Дополнительные материалы:

• API documentation
• How to get back-url for Parts-Catalogs
• Integrate prices into Parts-Catalogs