> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ingram Micro Hardware API

> Find Ingram Micro products, read live price and stock, create quotes, and read or place hardware orders

The common uses are quoting hardware for a ticket ("quote three laptops like the one on this ticket"), a product lookup in chat ("price and stock for Dell part N013L545014US"), and order status ("where is PO 48213?").

> [!NOTE]
>
> Automatically enabled when you configure Ingram Micro Hardware permissions in your agent workflow.

## What It Does

* Search the Ingram Micro catalogue by description, vendor part number (VPN) or Ingram SKU, with product details
* Read your price and the stock in each Ingram warehouse, for up to 50 parts in one call
* Create an Ingram quote for the parts a ticket needs, then read it back; search and read your quotes
* Search and read orders with their status, shipments, tracking and serial numbers
* Place an order on your Ingram net terms, and change or cancel one placed on customer hold
* Read invoices, renewals, deals (special-bid pricing), return requests and freight estimates; open a return
* Read cloud subscriptions bought through Xvantage, and estimate a change

This is Ingram Micro's reseller API (Xvantage). Cloud subscriptions and seats bought through the Ingram Micro Cloud Marketplace use the [Ingram Micro](https://docs.neoagent.io/integrations/marketplaces/ingram-micro.md) integration.

## Permission Groups

| Group | Covers |
| - | - |
| Products, Pricing & Deals | Catalogue search and details, your price and the stock per warehouse, deals and special-bid prices, freight estimates. Read only |
| Quotes | Search and read quotes, check a quote is ready to order, and create a quote |
| Quote Emails | Create a quote that Ingram emails, with your Ingram prices, to up to ten addresses. Write only |
| Orders | Search and read orders; place an order; change or cancel an order on customer hold |
| Invoices | Search and read invoices. Read only |
| Renewals | Search and read renewals of warranties, support and licences. Read only |
| Returns | Search and read return requests, and open one |
| Subscriptions | Search and read cloud subscriptions and their plans, and estimate a change. Read only |

## Access Profiles

| Profile | Writes | Asks a technician first |
| - | - | - |
| **Read Only** | None | — |
| **Helpdesk** | Quotes, Quote Emails, Orders, Returns | Orders, Returns and Quote Emails |
| **IT Admin** | Quotes, Quote Emails, Orders, Returns | Orders and Quote Emails |
| **Full Automation** | Quotes, Quote Emails, Orders, Returns | Nothing |

## Safety Controls

| Control | Behavior |
| - | - |
| **Orders ask first** | Every profile but Full Automation asks a technician before an order is placed, changed or cancelled |
| **Quote emails apart** | A quote that Ingram would email to other addresses needs the Quote Emails group, so a quoting agent cannot send your Ingram prices outside |
| **No subscription changes** | Neo reads Xvantage cloud subscriptions and estimates a change; a technician makes the change in Xvantage |
| **Writes outside Ingram's API refused** | A write Ingram's published API does not list is refused before it is sent |
| **Rate limit** | Ingram allows 60 calls a minute per endpoint; Neo paces its calls to stay under it |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.