Note
On November 15th, 2021 Ingram Micro has updated Marketplace API on production, which has changed the way the API behaves in some cases. It is imperative that you read the Marketplace API 1.6 release notes carefully, modify your integrations (API clients) to match the updated specifications, and prepare to update your API clients at the time when the new version is implemented by Ingram Micro.
The documentation for the new version can be found under https://apidocs.cloud.im/1.6/. After November 15th, this documentation portal will automatically display this new version.
Certain products in the Ingram Micro catalog will have special requirements to complete the fulfillment of orders.
Some products require specific parameters, unique to the specific vendor and/or product, to be included during the order placement. The parameters are passed as a property of the products array when creating a new order.
"parameters": [
{
"name": "<parameter name>",
"value": "<parameter value>"
}
]
Note
Remember that parameters are case-sensitive.
As of now, a few products have been identified to have special order parameters or business rules. As Ingram Micro is constantly adding new products, this list may be extended in the future. In all cases, please contact your Sales Representative to learn more about the business rules for the products you wish to sell.
Avepoint has the following parameters:
Parameter Name |
Description |
Example Value |
---|---|---|
|
A valid email address. |
|
|
A valid email address. |
Dropbox has the following parameters:
Parameter Name |
Description |
Example Value |
---|---|---|
|
The email address to be used for creating the Dropbox team administrator. |
Parameter Name |
Description |
Example Value |
---|---|---|
|
The email address to be used for creating the HelloSign team administrator. |
Azure CSP has the following parameters:
Parameter Name |
Description |
Example Value |
---|---|---|
|
This parameter will be deprecated soon. Use the
|
customer1000057 |
|
The full domain to be used for the Azure Tenant. |
customer1000057.onmicrosoft.com |
Azure CSP has the following parameters:
Parameter Name |
Description |
Example Value |
---|---|---|
|
The domain to be used for Azure Tenant. This must include ‘.onmicrosoft.com’ in the value. |
customer1000057.onmicrosoft.com |
For all marketplaces other than NZ, Office 365 has the following parameters:
Parameter Name |
Description |
Example Value |
---|---|---|
|
The domain to be used for Office 365 Tenant. Important! When placing the order, do not include ‘.onmicrosoft.com’ in this value. But you must include it when validating parameters. |
Order placement: J.smith@example.org Parameter validation: customer1000057.onmicrosoft.com |
|
This parameter is required when you are placing an order for an existing tenant: a customer who has already purchased Microsoft services through a 3rd-party provider. |
917cd03a-c81a-43ac-91ad-a3c1c3f57bcd |
For the NZ marketplace, Office 365 has the following parameters:
Parameter Name |
Description |
Example Value |
---|---|---|
|
The domain to be used for Office 365 Tenant. This must include ‘.onmicrosoft.com’ in the value. |
customer1000057.onmicrosoft.com |