PartSmart offers a powerful solution for businesses to integrate real-time parts lookup and ordering directly into their websites. This streamlines the customer experience and boosts sales. This blog post by Anablock will guide you through the process of embedding PartSmart into your HTML page and explore key features such as picklist exporting and cart integration.
Embedding PartSmart
Embedding PartSmart is simple and only requires a script tag. Here's how:
- Obtain Access Tokens: Use PartSmart's RESTful APIs to authenticate and retrieve the necessary access tokens. You'll need an access token for a valid OEM/Distributor Admin User account.
- Authorize the Admin User: Click "Authorize" within the PartSmart interface and enter the access token (preceded by "Bearer") to authorize the Admin User.
- Get User-Specific Access: Use the Account/PortalUserToken API to request access token information for the specific user who will be using the embedded PartSmart. This API also allows you to create new non-admin users.
- Add the Script Tag: Place the PartSmart script tag into your HTML page, including the access token, refresh token, and expiration time as query string parameters.
Iframe Communication
PartSmart is rendered within an iframe. Communication with the PartSmart iframe occurs through client-side APIs exposed via the ARI object. This object provides functions for managing sessions and handling events.
Exporting Picklists
PartSmart enables you to export selected picklist data for integration into your own systems.
- Enable Picklist Export: Within the PartSmart admin account, navigate to the User Group settings and enable the "Pick List Export" option.
- Choose Format and Destination: Select the export format (JSON or XML) and specify whether to open the export in a new window.
- Set Up HTTP Post: Configure the HTTP Post URL and POST Variable Name to send the picklist data to your system or an external API.
Whitelisting PartSmart
If your organization has domain restrictions, whitelist the necessary PartSmart domains to ensure proper access.
Model Deep Linking
PartSmart supports deep linking to specific models by appending query string parameters to the script tag URL. These parameters include the catalog code and model ID.
Cart Integration
You can integrate PartSmart with your website's shopping cart by registering a JavaScript function that PartSmart will call when the "Add to Cart" button is clicked. You can customize which part properties are passed to your cart function.
Conclusion
Integrating PartSmart into your website enhances the user experience by providing a seamless way for customers to find and order parts. With features like picklist exporting, model deep linking, and cart integration, PartSmart is a valuable tool for businesses in the automotive and equipment industries.
