Ingram Micro Catalog Subscriptions
Catalog subscriptions are saved searches in the Ingram catalog through the Xvantage API. They top up in a targeted way — a manufacturer, a category or a keyword — and fetch price and availability for every hit. The price list is there for the full article base.
Opening the Page
- Via search: Ingram Micro Catalog Subscriptions
- Via Ingram Micro Setup → Catalog Subscriptions
- Via the Supplier Card
INGRAM-MICRO→ Ingram Micro Catalog Subscriptions
Fields
| Field | Description |
|---|---|
| Code / Description | Your name for the subscription. |
| Vendor Name Filter / Vendor Number Filter | A manufacturer as Ingram names it (Ingram calls the manufacturer vendor). |
| Category Filter | An Ingram category. |
| Keyword Filter | A free search term. |
| Active | Only active subscriptions run. |
| Last Run DateTime / Last Record Count / Last Error Message | Result of this subscription's last run. |
A subscription needs at least one filter — without one it would query the entire catalog and is refused.
Actions
| Action | Description |
|---|---|
| Run This Subscription | First checks that the connector is enabled and licensed, then searches the catalog and fetches price and availability for every hit, in batches of 50. |
| Run All Active | Starts the import definition INGRAM-CATALOG through the Hub: every active subscription in turn, with the license check and a row in the import log like a scheduled run. |
On a schedule, the subscriptions run through the import definition INGRAM-CATALOG of the Hub's job queue; Execute Import on the dashboard includes them after price list and availability.
Administrators only
With the permission set Ingram Micro User the page is read-only. Creating and running subscriptions requires Ingram Micro Admin — see Permissions.
Working Together with the Price List
Both channels write to the same Supplier Data, and both respect the manufacturer selection.
- With the price list active, subscriptions only add. What a subscription does not find stays as it is — articles Ingram no longer lists are taken out by the daily price list, because only it compares against Ingram's complete list.
- Without a price list, the subscriptions are the only source. A run in which all subscriptions completed then sets to Draft the articles none of them found. If a subscription fails, nothing is set to draft — its articles are missing because of the error, not because Ingram stopped offering them.
Rate limit
Ingram allows 60 calls per minute and can revoke access on excessive use. The connector keeps to at most one call per second (rate limit) — a large subscription takes its time accordingly. Keep subscriptions narrow — one manufacturer or one category, not half the catalog.
Stock Refresh
The import definition INGRAM-STOCK (Ingram Micro Stock (Availability via REST API)) fetches price and availability through the API — but only for offers linked to a Business Central item, i.e. supplier data with an item no. What you sell has to be current; the hourly availability file keeps the rest up to date. No catalog search runs, and nothing is set to draft.
If the run breaks off, it is recorded as failed in the Hub's import log and on the import definition.