Skip to content

Ingram Micro Orders

The Ingram Micro Orders list shows every order the connector transmitted to Ingram, simulated or linked. The Ingram Micro Order card shows one order in detail — header, Business Central documents, shipping, synchronization, lines and tracking.

Opening the Page

  • Via search: Ingram Micro Orders
  • Via the Dashboard → Orders
  • From the purchase order → View Ingram Micro Order

Prerequisites on the Purchase Order

  • The order is addressed to the vendor from the setup. Only then does the ribbon show the Ingram Micro group.
  • Every item line has an Ingram part number. The connector looks for it in this order: in the item's Supplier Data (from the price list or a catalog subscription), in the item vendor catalog of the Ingram vendor, in the Vendor Item No. of the purchase line.
  • If a line has none, the whole order is refused and the item is named. The connector never sends an order that is short a line.
  • Quantities are transmitted in pieces (quantity × quantity per unit of measure). The purchase order's ship-to address goes to Ingram — on a drop shipment, your customer's address.

Actions on the Purchase Order

Action Visible when Description
Create Ingram Micro Order Ingram vendor Checks and transmits the order.
Link Existing Ingram Micro Order Ingram vendor, no order yet Links an order you placed by e-mail or in Ingram's portal.
Check Ingram Micro Availability Ingram vendor Shows stock, backorder and price deviation per line — transmits nothing.
View Ingram Micro Order order exists Opens the Ingram order card.
Refresh Ingram Micro Status order exists Asks Ingram right away. Never posts.
Ingram Micro Serial Numbers order exists The reported serial numbers.

The Ingram Micro Tracking FactBox shows status, tracking number and shipping agent.

Transmitting an Order

  1. Create Ingram Micro Order → confirm.
  2. The connector checks the vendor, the part numbers and whether the order was already transmitted.
  3. Existing order: outside Simulation Mode it asks Ingram whether an order already exists under your purchase order number — for example because an earlier attempt timed out after Ingram had taken the order. That order is then linked instead of ordering twice.
  4. Price check: it compares the lines' direct unit costs with Ingram's real-time prices. If a price deviates by more than 1 %, it shows every deviation and asks whether to order anyway.
  5. The order goes to Ingram. The answer carries a Confirmation No.; Ingram assigns the Ingram Order No. shortly afterwards, and the next sync resolves it through your purchase order number.

No cancellation through the API

The Xvantage API offers no endpoint to change or cancel a transmitted order. The connector therefore never transmits the same purchase order twice. Settle changes with Ingram directly; the next sync takes over whatever Ingram then reports.

Transmission from merchantCENTRAL Trading

The connector tells the Hub what it can do with a purchase order: transmission by API, order confirmation, tracking, invoice, serial numbers and simulation. Trading and every other Hub caller can therefore trigger the transmission themselves — with the same checks, only without the price deviation question. If the transmission fails, the caller is told, with the reason.

Simulation Mode

As long as Simulation Mode is on (the default), nothing goes to Ingram. Create Ingram Micro Order records the Ingram order under the number SIM-‹purchase order no.›, marked Simulated, status Submitted. This lets you check part numbers, quantities and ship-to address before going live.

  • A simulation never blocks the real order: repeating the action replaces the simulation; the real transmission removes it.
  • Simulated orders are never asked about at Ingram and are counted separately on the dashboard.

Linking an Existing Order

If you ordered at Ingram by e-mail, phone or in the portal, the connector has no Ingram order — and therefore no feedback. Two ways bring the order in:

  • Manually: Link Existing Ingram Micro Order → enter the Ingram Micro Order No. The next sync fills in quantities, prices, shipments and serial numbers.
  • Automatically: every sync run looks for purchase orders to the Ingram vendor without an Ingram order within the discovery window — see Auto-Processing.

A linked order counts as transmitted and is never ordered again.

Status Values

Status Meaning
New Recorded, not transmitted yet.
Submitted Sent to Ingram (or simulated); Ingram has not reported anything further.
Processing Ingram is processing the order.
Backordered At least one line is not available.
Shipped Ingram has shipped.
Completed Fully shipped and invoiced.
Cancelled Cancelled by Ingram.
Error The transmission failed, or Ingram did not confirm the order for 48 hours. The reason is in Last Error Message; the purchase order can be transmitted again.

Ingram Micro Status Text shows Ingram's original wording.

Actions in List and Card

Action Description
Refresh All Open Orders Asks Ingram about every order that is not completed, right away.
Refresh Order Asks Ingram about the selected order right away.
Sync Invoices Card only: reads this order's invoices right away.
Order Lines, Purchase Order, Sales Order, Posted Purchase Receipts, Posted Purchase Invoices, Ingram Micro Invoices, Serial Numbers Navigation to the linked documents — see Document Navigation.

A manual refresh never posts

An action called "Refresh" must not post a goods receipt — or, on a drop shipment, a sales shipment — under the hands of whoever clicked it. Posting happens only in the background run and only with Auto Post Receipt.