Auto-Processing
A job queue entry fetches the state of the orders at Ingram. It asks about every order that still waits for something and writes back what Ingram reports. Business Central SaaS gives an extension no publicly reachable endpoint — the status is therefore polled, not delivered.
The file imports (price list, availability) and the catalog subscriptions run separately through the Hub's import jobs — see Setup.
The Job
| Property | Value |
|---|---|
| Description | Ingram Micro - Auto Sync Orders |
| Codeunit | ALN MCIM Job Runner |
| Interval | Sync Interval (Minutes), default 60 |
| Time window | Monday to Friday, 06:00 to 20:00 |
| Retries | 3 attempts, 60 seconds apart |
After installation the job is On Hold. It starts when you enable Auto Sync in the setup wizard and finish, or on the setup page with Enable Auto Sync and Create/Update Job Queue. It only runs while the connector is enabled and licensed.
What a Run Does
- Find orders placed elsewhere (see below).
- Ask about open orders — status Submitted, Processing or Backordered, regardless of age.
- Ask about shipped orders with work left — while something is still missing within the follow-up window.
- Read invoices for shipped and completed orders of the last 90 days.
- Match invoices, then timestamp, log and — if set up — the e-mail to the Notification Email.
Every order is completed on its own: if one fails, the ones before it are saved and the run moves on to the next. Simulated orders are never asked about.
What a Sync Writes
Onto the Ingram order: Ingram order number, status and Ingram's status text, order total, currency, and per line the confirmed, backordered and shipped quantity, price, delivery date, tracking, delivery note and invoice number. When nothing is open any more, Follow-up Complete is set.
Onto the purchase order — depending on the switches on the setup page:
- Vendor Order No. and Vendor Shipment No., if still empty
- corrected direct unit costs and quantities
- promised receipt date
- serial numbers
- with Auto Post Receipt: the goods receipt for the reported quantities, exact to the piece — every partial delivery becomes a receipt of its own, posted on the reported shipping date
- with Auto Post Invoice: the purchase invoice, once the invoice matching succeeds
Onto the sales order of a drop shipment: delivery date, serial numbers and tracking.
To the Hub: every status change in Ingram's own wording, every tracking number with the shipping agent recognised from the number, and every invoice read.
Follow-up Window
Ingram often reports the status before the shipment details, and a partial delivery reports its remainder days later. A shipped order is therefore asked about while something is missing — an open quantity, the invoice, its surcharges or serial numbers — and at most Follow-up Window (Days) after shipment (default 60). The window counts from the first run that sees the order as shipped, not from the order date. 0 switches the limit off: the order is then asked about until nothing is waiting any more.
Finding Orders Placed Elsewhere
Every run looks within the Discovery Window (Days) (default 90) for purchase orders to the Ingram vendor that have no Ingram order — for example because they were ordered by e-mail or in Ingram's portal. It searches by Vendor Order No., Vendor Invoice No. and your purchase order number. Only certain hits are linked; uncertain ones appear in the log so you can check them by hand with Link Existing Ingram Micro Order. 0 switches the search off.
Unconfirmed Orders
Ingram assigns the order number asynchronously, usually within minutes. If Ingram still knows no order under your purchase order number after 48 hours, the run sets the Ingram order to Error and writes the reason into Last Error Message. A search that got no answer changes nothing — only Ingram's explicit "no order under this number" counts. See Troubleshooting.
Notification
With a Notification Email and Send Process Notification, every run that did something sends a summary: refreshed orders, invoices read, errors and the run's log.