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.
| 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. Recommended after changing the credentials. |
| Disconnect | Deletes Client ID, Client Secret and token. |
Purchasing
| Field | Default | Description |
|---|---|---|
| Vendor No. | – | The vendor that represents Ingram Micro. Only purchase orders to this vendor show the Ingram actions. |
| 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. |
| 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.
Who provides the files?
Ingram places the files on its SFTP server. An Azure Function picks them up, unpacks them and stages them in Blob Storage. You apply for the files at Ingram with your customer number; ALTENBRAND sets up the pickup.
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.
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.