ingrammicro_create_cloud_order
Destructive
Place a cloud-subscription order or convert a validated quote into a real order, returning a confirmation number for asynchronous processing.
Instructions
Place a cloud-subscription order, or convert an existing Quote (Quote-to-Order / Configure-to-Order) into a real order. Asynchronous: this call only returns a confirmationNumber acknowledging receipt — Ingram Micro pushes the actual order result (success or error) later via its own webhook, not in this response.
For standard stocked/direct-ship/licensing/warranty SKUs (not
cloud, not quote-based), use ingrammicro_create_order instead.
Real money against the reseller's net-terms account — no dry-run,
no credit-card ordering. Always validate a quote first with
ingrammicro_validate_quote_to_order before passing quote_number
here.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lines | No | Standard-order line items (ignored in Quote-to-Order mode): [{"customerLineNumber", "ingramPartNumber", "vendorPartNumber", "quantity", "unitPrice", "endUserPrice" (required for export orders), "specialBidNumber", "notes"}]. Required unless quote_number is given. | |
| notes | No | Order header-level notes. | |
| quote_number | No | Ingram Micro quote number for Quote-to-Order or Configure-to-Order. When given, any SKU/quantity/price in `lines` is IGNORED — the quote's own details are used instead. Validate it first with ingrammicro_validate_quote_to_order to learn any vendor-mandatory fields to pass here. | |
| ship_to_info | No | Optional shipping destination override: {"addressId" (Ingram-issued address id from onboarding), "contact", "companyName", "name1", "name2", "addressLine1/2/3", "city", "state", "postalCode", "countryCode", "phoneNumber", "email"}. Omit to ship to the address tied to addressId on the account. | |
| end_user_info | No | Optional end-customer identity, used for pricing/discount purposes: {"endUserId", "contact", "companyName", "name1", "name2", "addressLine1/2/3", "city", "state", "postalCode", "countryCode", "phoneNumber", "email"}. | |
| reseller_info | No | Optional reseller identity/address override: {"resellerId", "companyName", "contact", "addressLine1/2/3", "city", "state", "postalCode", "countryCode", "phoneNumber", "email"}. Omit to use the account's on-file reseller info. | |
| shipment_details | No | Optional shipping instructions: {"carrierCode", "freightAccountNumber" (bill reseller's own carrier account directly), "shipComplete" ("true"/"C"=hold until all lines ship, "P"=ship-complete per line, "E"=ship-complete across all distributions), "requestedDeliveryDate" (date, not guaranteed), "signatureRequired" (bool), "shippingInstructions"}. | |
| accept_back_order | No | Accept the order even if backordered. | |
| bill_to_address_id | No | Billing address suffix from onboarding. | |
| special_bid_number | No | Header-level special-pricing bid number. | |
| vendor_auth_number | No | Vendor authorization number, if the specific vendor requires it. | |
| additional_attributes | No | Optional Ingram-specific flags as [{"attributeName", "attributeValue"}] pairs — e.g. allowPartialOrder, allowDuplicateCustomerOrderNumber, government-order fields (govtProgramType, govtEndUserType, etc). Rarely needed; omit unless a specific Ingram-documented flag is required. | |
| customer_order_number | No | Your own order number for reference (max 18 chars). Strongly recommended even though not strictly required. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |