Ingram Micro Setup
The Ingram Micro Setup page is the connector's only setup page. The same sections also appear on the Hub's Supplier Card for supplier INGRAM-MICRO — under Ingram Micro Settings and Ingram Micro Imports.
Opening the Page
- Via search: Ingram Micro Setup
- Via the Supplier List → row
INGRAM-MICRO→ Set Up - For the guided first setup: Setup Wizard
API Connection
| Field | Description |
|---|---|
| Customer Number | Your Ingram customer number. Sent with every request as header IM-CustomerNumber. |
| Country Code | ISO code of your Ingram branch, e.g. DE (header IM-CountryCode). |
| Use Sandbox | Every call goes to Ingram's sandbox instead of the live system. |
Authentication
Click Client ID and Client Secret to enter them in a masked dialog. Both are stored encrypted in the Hub's central Credential Store, never in a table field; the page shows only Configured or Not configured. If you confirm the dialog with an empty field, the stored value stays as it is.
Access Token shows whether a valid token is cached for this company: Valid or None - requested with the next call. The connector requests the token itself and renews it once it has expired — also for users who may only read the setup.
Credentials per company
Client ID, Client Secret and access token apply to the company you enter them in — like the customer number and the country code. Several companies can thus use different Ingram accounts. The update to version 1.16 copied the credentials, which were stored database-wide until then, into every company. A new Client ID or Client Secret discards the stored token; the next call requests a matching one.
| Action | Description |
|---|---|
| Test Connection | Signs in to Ingram with the credentials. |
| Get Access Token | Requests a new token right away (Ingram tokens are valid for 24 hours). |
| Clear Access Token | Discards the cached token; the next call requests a new one. |
| Disconnect | Deletes Client ID, Client Secret and token of this company. |
Purchasing
The vendor that represents Ingram Micro is kept in the Vendor No. field of the Supplier Card INGRAM-MICRO — only there; the setup wizard writes it there as well. Only purchase orders to this vendor show the Ingram actions, and without a vendor neither the imports nor the search for orders placed elsewhere run.
| Field | Default | Description |
|---|---|---|
| Simulation Mode | on | Orders are recorded in Business Central only, under a SIM- number — see Orders. |
| Auto Update Purchase Order | on | Ingram order number, invoice and delivery note number onto the purchase order. |
| Auto Correct Line Amounts | on | A line's direct unit cost follows Ingram's confirmed price. |
| Auto Update Order Quantities | on | Confirmed quantities onto the lines; received or invoiced lines are only reported. |
| Auto Assign Serial Numbers | on | See Serial Numbers. |
| Auto Add Shipping Charges | on | Freight and surcharges as item charges — see Invoices. |
| Shipping / Insurance / Other Charge No. | – | The item charge freight, transport insurance and every other surcharge are booked on. |
| Auto Update Promised Receipt Date | off | Ingram's delivery date onto the purchase lines. |
| Auto Update Sales Shipment Date | off | Ingram's delivery date onto the lines of the drop shipment sales order. |
| Auto Post Receipt | off | Posts the goods receipt for the quantities Ingram reports as shipped — in the background run only. |
| Auto Post Invoice | off | Posts the purchase invoice once Ingram's invoice matches the purchase order. |
| Notification Email / Send Process Notification | – / on | A summary by e-mail after every sync run. |
Posting cannot be undone
Auto Post Receipt and Auto Post Invoice are off by default. Switch them on only after watching for a few weeks that quantities, surcharges and amounts arrive correctly.
Automation
| Field | Default | Description |
|---|---|---|
| Auto Sync Job | – | State of the job queue entry. |
| Enable Auto Sync | off | Switches the order sync on. |
| Sync Interval (Minutes) | 60 | Time between runs, at least 5. |
| Follow-up Window (Days) | 60 | How long after shipment an order is still asked about while something is open. |
| Discovery Window (Days) | 90 | How far back a run looks for purchase orders placed outside the connector. |
| Price List Batch Size | 50 | Articles per price and availability API call, at most 50. |
| Stock Quantity Cap | 0 | Highest quantity taken from the availability file. Ingram reports 10,000 for much of its range; 0 = no cap. |
Create/Update Job Queue creates the entry or adjusts it to the interval; with Auto Sync off, it puts the entry on hold. Catalog Subscriptions opens the catalog subscriptions.
Import Definitions
Two sections, one per file:
| Section | Code | Content | Published by Ingram |
|---|---|---|---|
| Price List (Article Base) | INGRAM-PRICELIST |
Articles with manufacturer, manufacturer part no., EAN, description, purchase price, list price | daily around 06:00 |
| Availability (hourly) | INGRAM-AVAILABILITY |
Stock per Ingram part number | hourly around xx:04 |
| Field / Action | Description |
|---|---|
| Active | Only active imports run. |
| Source Type | Fixed: Azure Blob Storage through the Hub's central OAuth2 connection. |
| Source URL | Address of the staged file in Blob Storage. |
| Authentication | Shows whether the central storage connection is configured in the merchantCENTRAL setup; a click opens it. |
| Status | Result of the last run. |
| Test Connection | Downloads the file as a test. |
| Run Import Now | Starts the import right away — through the Hub, with the license check and a row in the import log like a scheduled run. |
| Analyze Manufacturers | Price list only: reads the file and enters every manufacturer into the manufacturer selection without importing any article. |
Price list: articles in the file are active afterwards; articles Ingram no longer lists fall back to Draft. An empty or truncated file is a failed run — nothing is set to draft then.
Availability: updates only articles the price list has already delivered. The file is a full snapshot: an article missing from it gets quantity 0. If the file matches no known article, the run counts as failed. Ingram counts in pieces. For an article you sell by the package, merchantCENTRAL converts the quantity to packages like the prices of the price list, provided Prices Per Piece is set for the supplier and the article's category is listed as a Price Per Piece Category. The Stock Quantity Cap applies to the piece count in the file, before this conversion. An article whose manufacturer you deselected after the last price list run no longer gets stock.
Who provides the files?
You do. Ingram places the files on its SFTP server; from there you bring them into an Azure Blob Storage of your own — for example with an Azure Function of your own that picks the files up, unpacks them and stages them. You apply for the files at Ingram with your customer number. ALTENBRAND sets up neither the Blob Storage nor the pickup; the connector only reads the files from the Source URL.
Besides the two files, the connector creates two import definitions for the API, listed in the Hub's Supplier Setup: INGRAM-CATALOG for the catalog subscriptions and INGRAM-STOCK for the stock refresh of linked articles. Execute Import on the dashboard works through every active definition in this order: price list, availability, catalog subscriptions, stock.
Manufacturer Selection
Ingram offers more than 200 manufacturers. To keep your supplier data free of articles you never sell:
- Price List (Article Base) → Analyze Manufacturers.
- Hub Supplier Card → Manufacturer Selection → release the manufacturers you need (see Manufacturer Selection).
- Price List → set Active and Run Import Now.
The selection applies to both channels: catalog subscriptions also take only articles of released manufacturers.
Permissions
| Permission set | Scope |
|---|---|
| mC Ingram Micro - Admin | Full access: setup, catalog subscriptions, imports and all documents. Includes mC Ingram Micro - User and the Hub set mC - Admin. |
| mC Ingram Micro - User | Daily work: transmit and follow orders, read invoices and serial numbers, view catalog subscriptions. Includes the Hub set mC - User. The setup is read-only for this set — the connector still renews an expired access token. |
Running catalog imports is admin work: the Hub user set may only read the supplier data they write.
License
The License FactBox shows the state of module INGRAM-MICRO and asks the license server when the page opens. A license or running demo is needed in a sandbox too — see Licensing.