Skip to content

Ingram Micro Supplier Connector

The merchantCENTRAL Supplier Ingram Micro connects Business Central to the IT distributor Ingram Micro — from the article base to the posted invoice. The connector uses two channels, and each carries what it is made for:

  • Files for the article base: Ingram publishes a daily price list (about 230,000 articles) and an hourly availability file. Both run through the central merchantCENTRAL import pipeline into the Hub table Supplier Data — limited to the manufacturers you choose.
  • The Xvantage API for documents: order, order number, confirmed prices and quantities, delivery dates, tracking and serial numbers, and the invoice with every surcharge.

The connector is an add-on of the merchantCENTRAL Hub: the supplier data feeds pricing, stock and item creation, tracking numbers go to the central tracking, invoices to the Hub's invoice matching.

Why not everything through the API?

Ingram limits the API to 60 calls per minute and prices at most 50 articles per call. Querying the full catalog that way would take more than 4,600 calls — and Ingram prohibits populating the catalog by polling the API. The price list is there for the full range; the API tops up in a targeted way through catalog subscriptions.

Feature Overview

Feature Description
Price list and availability Daily price list and hourly availability by file; articles Ingram no longer lists fall back to Draft
Manufacturer selection Only released manufacturers reach the supplier data
Catalog subscriptions Targeted top-ups of single manufacturers, categories or keywords through the API
Order from the purchase order With a price check against Ingram's real-time price (a deviation above 1 % is shown first)
Transmission from Trading The Hub and merchantCENTRAL Trading can trigger the transmission themselves
No duplicate orders Before every real transmission the connector asks Ingram whether the order is already there
Status sync Through the job queue: order number, quantities, prices, dates, tracking and serial numbers
Invoices Amounts, due date and every surcharge — freight, insurance, fees — as item charges
Drop shipment Tracking, delivery date and serial numbers on the sales order too
Orders placed elsewhere Ordered by e-mail or in Ingram's portal? The sync finds and links the order
Simulation Mode On by default: orders are recorded in Business Central only, nothing goes to Ingram
License & demo Tenant- and module-bound license with a free demo (module code INGRAM-MICRO)

Getting Started

  1. Make sure the merchantCENTRAL Hub is installed and set up.
  2. Install Supplier Ingram Micro from AppSource.
  3. Enable the supplier INGRAM-MICRO in the Supplier List — without a license this starts the free demo registration.
  4. Request your Xvantage credentials (Client ID, Client Secret) from Ingram Micro and note your customer number.
  5. Run the setup wizard — the credential and import steps can be skipped and completed later.
  6. Set up price list and availability and select the manufacturers.
  7. Try the order workflow in Simulation Mode before going live.

Page Overview

Page Description
Dashboard Import overview, orders and API, license
Setup Connection, purchasing, automation, import definitions, manufacturer selection
Setup Wizard Guided first setup in eight steps
Catalog Subscriptions Targeted top-ups through the API
Orders Transmission, simulation, linking existing orders, price check
Invoices Invoice import, surcharges, invoice matching
Serial Numbers Reported serial numbers and their assignment
Document Navigation From every document to the Ingram order and back
Auto-Processing Job queue, follow-up and discovery windows
Troubleshooting Common messages and their causes

Architecture

┌─────────────────────────────────────────────────────────┐
│                      Ingram Micro                        │
│                                                          │
│  Xvantage API (OAuth2)          SFTP data service         │
│  ├── Catalog / price & avail.   ├── Price list (daily)    │
│  ├── Order (v7)                 └── Availability (hourly) │
│  ├── Order search / details                              │
│  └── Invoices                                            │
└────────────┬──────────────────────────┬─────────────────┘
             │ Bearer token +           │ Azure Function →
             │ customer no. / country   │ Azure Blob Storage
┌────────────┴──────────────────────────┴─────────────────┐
│            merchantCENTRAL Supplier Ingram Micro          │
└────────────────────────┬─────────────────────────────────┘
                         │ Events
┌────────────────────────┴─────────────────────────────────┐
│                  merchantCENTRAL Hub                      │
│   (Supplier Data, pricing, stock, tracking, matching)     │
└───────────────────────────────────────────────────────────┘

The status is polled through the job queue. Business Central SaaS gives an extension no publicly reachable endpoint Ingram could deliver events to.

Prerequisites

  • Microsoft Dynamics 365 Business Central (Cloud, version 28.x or later)
  • merchantCENTRAL Hub version 2.99 or later, installed and set up
  • Ingram Micro customer account with Xvantage API access (Client ID, Client Secret) and customer number
  • For the article base: Ingram's data service subscription for price list and availability, and the files staged in Azure Blob Storage — ALTENBRAND sets this up
  • A vendor for Ingram Micro

Trademarks

Ingram Micro and Xvantage are trademarks of Ingram Micro Inc. They are named for descriptive purposes only, to indicate what this software is for. The connector is an independent product of ALTENBRAND Datentechnik GmbH and is not affiliated with, authorized or sponsored by Ingram Micro.

Help & Support