This article will walk you through how to integrate 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:

  • Via XML credentials

  • Via API credentials


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

 


1. 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:


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

  2. Go to the "Apps" section inside the portal

  3. Click on "Add Production App" 

  4. Set the app name (Ex.: Zomentum)

  5. 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)

  6. Enable "Product Catalog" API product (At this moment, we support only the API version 5 of the Ingram catalogue, hence please select Product Catalog v5)

  7. Enter your sales/account manager email

  8. Add the app. This will submit the app for approval. It usually takes 2 days to get approved.

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




Once the app is approved follow the below steps:


  1. Go to Settings -> Integration

  2. Click on Ingram

  3. Please select the Region and Set credentials type. (API credentials is the recommended credentials type for regions including  USA, UK, Canada, Austria, Switzerland, Germany, Sweden, Spain, France, Italy, Portugal, and Hungary)

  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. 





2. 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 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 would like to set our account up with access to the IM-XML (Mustang) API. Please provide the XML credentials.

 

Below is our account information:

 

Company Name: *[Your Company Name]*

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

 

Thanks.


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

  • Email: electronic.services@ingrammicro.com

  • Phone: 1-800-616-4665



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