This article will walk you through integrating your Ingram Micro account with your Zomentum account. The integration will allow you to retrieve real-time pricing and availability from Ingram Micro when adding a product to a document. This will remove the need to manage your products in two different places.

 

There are two ways to integrate Ingram Micro with Zomentum:

  • API credentials (Recommended)

  • XML credentials (Soon to be deprecated)


Region

Credential Types available

USA

  • API credentials (recommended)

  • XML credentials (Soon to be deprecated)

UK

  • API credentials (recommended)

  • XML credentials (Soon to be deprecated)

Canada

  • API credentials (recommended)

  • XML credentials (Soon to be deprecated)

Australia

XML credentials

New Zealand

XML credentials

Austria

API credentials

Switzerland

API credentials

Germany

API credentials

Sweden

API credentials

Spain

API credentials

France

API credentials

Italy

API credentials

Portugal

API credentials

Hungary

API credentials

Netherlands

XML credentials

 


Integrating using Ingram's API credentials:


To integrate with Zomentum using Ingram's new API, you would first need to create a Production App on Ingram's developer portal. Follow the below steps to create an app and retrieve API credentials from Ingram:


  • Click here to sign up for Ingram's developer account or Log in to the developer portal if you have already registered.

  • Go to the Apps section inside the portal

  • Click on Add Production App

  • Set the app name (Ex: Zomentum)

  • In the description field mention that this app is for a third-party solution called Zomentum (Ex: Third-party app "Zomentum" will use the app to query real-time pricing and availability from Ingram)

  • Enable "Product Catalog" API product.

  • Enter your sales/account manager email.

  • Add the app. This will submit the app for approval. It usually takes 2 days to get approved by the Ingram team.

  • Once the app has been approved, click on the app again, and note down the Customer number, ClientID, and Client Secret. This information will be needed to connect Ingram with Zomentum.

  • Enable the appropriate Ingram APIs from the settings. Two API calls are mandatory for such issues: 

  • Order Management V6 

  • Product Catalog V6



Once the app is approved follow the below steps:


  1. Go to Settings -> Integration

  2. Click on “Connect” shown for Ingram

  3. Please select the Region and Set credentials type. (API credentials is the recommended credentials type for regions including  USA, UK, Canada,)

  4. Enter the ClientID and the Client Secret (Retrieved in previous steps)

  5. Enter the customer number (Ex.: 20-222234)

Note: if there is a hyphen after the first 2 digits, you would need to enter the customer number with the hyphen

  1. Hit ‘Save’ to connect. 








Integrating using Ingram's XML credentials:


Prerequisites:

To integrate Ingram Micro with Zomentum, you will need access credentials to Ingram Micro's IM-XML (Mustang) API for Partners. The XML credentials type is recommended for Australia, Netherlands, and New Zealand regions. Note that these are not the same credentials you use to log into Ingram Micro. To request access, you’ll need to contact the Ingram Micro support team.


 

Below is an example email you can use to contact Ingram Micro's support team to request IM-XML access:

 

Hello,

 

We want to set our account up with access to the API. Please provide the API credentials.

 

Below is our account information:

 

Company Name: *[Your Company Name]*

Ingram Micro Account Number: *[Your Ingram Micro Account Number]*

API Requests will be made from the following IP addresses 

3.210.175.249

34.224.144.84

50.17.76.20

34.197.122.8


 

Thanks.


Below is the contact information for the Ingram Micro support team:



Setting up Integration:


  1. Navigate to Settings -> Integrations tab

  2. Click on Ingram Micro under the Distributor section.

  1. A right-side drawer will appear where you will be asked to enter credentials. These are the IM-XML API credentials and not the ones you use to log in to Ingram Micro. 

  2. Enter Login ID and Password



  1. Hit ‘Save’ and you will be connected



 

Using the Integration

 

Once you are connected, head over to the Quote Block of your document. Search for the products and services you would like to add to your quote using ‘Etilize’ configuration. The query will return with specific product information based on the search term entered along with the real-time pricing & availability along with the product details.

 

To search for products using Etilize Configuration:

  1. Drag and drop a quote block in a document

  2. Click on ‘Add Product’

  3. Select ‘Etilize’ from the Dropdown





  4. Search for the product. The results will populate with real-time pricing along with the stock levels from the integrated distributors




  5. Before adding the product to the quote block, you can set competitive pricing and also modify any product details, if required.