Manage orders - Get orders for a customer and an indirect reseller partner

Servizio:

Partner Center Rest

Versione API:

v1

Ottiene una raccolta di ordini per il cliente specificato e un partner rivenditore indiretto.

GET https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/orders

Con parametri facoltativi:

GET https://api.partnercenter.microsoft.com/v{version}/customers/{customer_id}/orders?indirect_reseller_id={indirect_reseller_id}&billingType={billingType}&include_price={include_price}&include_system_purchases={include_system_purchases}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
customer_id	path	True	string	Identificatore del cliente.
version	path	True	string
billingType	query		integer (int32)
include_price	query		boolean	Indica se includere il prezzo nella risposta (impostazione predefinita : false).
include_system_purchases	query		boolean	Indica se includere gli acquisti creati dal sistema (impostazione predefinita: false).
indirect_reseller_id	query		string	ID rivenditore indiretto.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Authorization	True	string	Token di connessione dell'autorizzazione
ms-correlationid		string	Usato per tenere traccia delle richieste internamente. Se non viene specificato un ms-correlationid, il server genererà un nuovo elemento per ogni richiesta
ms-cv		string	Usato per tenere traccia delle richieste internamente. Se non viene specificata una ms-cv, il server genererà un nuovo per ogni richiesta
ms-requestid		string	Usato per l'idempotenza delle richieste. Se non viene specificato un ms-requestid, il server genererà un nuovo per ogni richiesta

Risposte

Nome	Tipo	Descrizione
200 OK	Microsoft.Partner.Core.Collections.ResourceCollection[Microsoft.Partner.Services.Orders.V2.Models.Order]	La richiesta ha avuto esito positivo. Il corpo della risposta contiene gli ordini. Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request		Non è presente un input mancante o non valido. Il corpo della risposta fornirà i dettagli dell'errore. Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized		La richiesta non è stata autenticata. Il client deve prima eseguire l'autenticazione con il servizio API partner. Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden		La richiesta è stata autenticata ma è stata rifiutata perché il chiamante non dispone dei diritti per richiamarlo. Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found		La risorsa non viene trovata o non è disponibile con i parametri di input specificati. Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error		Il servizio API partner o una delle relative dipendenze non è riuscito a soddisfare la richiesta. I chiamanti possono riprovare. Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definizioni

Nome	Descrizione
Microsoft.Partner.Core.Collections.Link
Microsoft.Partner.Core.Collections.ResourceAttributes
Microsoft.Partner.Core.Collections.ResourceCollection[Microsoft.Partner.Services.Orders.V2.Models.Order]
Microsoft.Partner.Core.Collections.ResourceLinks
Microsoft.Partner.Services.Orders.V2.Models.ClientContext
Microsoft.Partner.Services.Orders.V2.Models.Order
Microsoft.Partner.Services.Orders.V2.Models.OrderLineItem
Microsoft.Partner.Services.Orders.V2.Models.OrderLineItemLinks
Microsoft.Partner.Services.Orders.V2.Models.OrderLinks
Microsoft.Partner.Services.Orders.V2.Models.Pricing
Microsoft.Partner.Services.Orders.V2.Models.ProductTerm
Microsoft.Partner.Services.Orders.V2.Models.PurchaseCommitment
Microsoft.Partner.Services.Orders.V2.Models.RenewsTo
Microsoft.Partner.Services.Orders.V2.Models.ScheduledNextTermInstructions
System.Collections.Generic.KeyValuePair[System.String,System.String]

Microsoft.Partner.Core.Collections.Link

Object

Nome	Tipo	Descrizione
body	string
headers	System.Collections.Generic.KeyValuePair[System.String,System.String][]
method	string
uri	string

Microsoft.Partner.Core.Collections.ResourceAttributes

Object

Nome	Tipo	Descrizione
etag	string
objectType	string

Microsoft.Partner.Core.Collections.ResourceCollection[Microsoft.Partner.Services.Orders.V2.Models.Order]

Object

Nome	Tipo	Descrizione
attributes	Microsoft.Partner.Core.Collections.ResourceAttributes
items	Microsoft.Partner.Services.Orders.V2.Models.Order[]
links	Microsoft.Partner.Core.Collections.ResourceLinks
totalCount	integer (int32)

Microsoft.Partner.Core.Collections.ResourceLinks

Object

Nome	Tipo	Descrizione
next	Microsoft.Partner.Core.Collections.Link
previous	Microsoft.Partner.Core.Collections.Link
self	Microsoft.Partner.Core.Collections.Link

Microsoft.Partner.Services.Orders.V2.Models.ClientContext

Object

Nome	Tipo	Descrizione
deviceFamily	string
marketplaceCountry	string
name	string

Microsoft.Partner.Services.Orders.V2.Models.Order

Object

Nome	Tipo	Descrizione
alternateId	string
attributes	Microsoft.Partner.Core.Collections.ResourceAttributes
billingCycle	enum: annual (int32) monthly (int32) none (int32) one_time (int32) triennial (int32) unknown (int32)
client	Microsoft.Partner.Services.Orders.V2.Models.ClientContext
creationDate	string (date-time)
currencyCode	string
currencySymbol	string
id	string
lineItems	Microsoft.Partner.Services.Orders.V2.Models.OrderLineItem[]
links	Microsoft.Partner.Services.Orders.V2.Models.OrderLinks
referenceCustomerId	string
status	enum: cancelled (int32) completed (int32) error (int32) partial_success (int32) pending (int32) pending_po_upload (int32) pending_review (int32) po_review_rejected (int32) po_upload_complete (int32) suspended (int32) unknown (int32)
totalPrice	number (double)
transactionType	string

Microsoft.Partner.Services.Orders.V2.Models.OrderLineItem

Object

Nome	Tipo	Descrizione
attestationAccepted	boolean
customTermEndDate	string (date-time)
friendlyName	string
lineItemNumber	integer (int32)
links	Microsoft.Partner.Services.Orders.V2.Models.OrderLineItemLinks
offerId	string
parentSubscriptionId	string
partnerIdOnRecord	string
pricing	Microsoft.Partner.Services.Orders.V2.Models.Pricing
promotionId	string
provisioningContext	object
purchaseCommitment	Microsoft.Partner.Services.Orders.V2.Models.PurchaseCommitment
quantity	integer (int32)
renewsTo	Microsoft.Partner.Services.Orders.V2.Models.RenewsTo
scheduledNextTermInstructions	Microsoft.Partner.Services.Orders.V2.Models.ScheduledNextTermInstructions
subscriptionId	string
termDuration	string
transactionType	string

Microsoft.Partner.Services.Orders.V2.Models.OrderLineItemLinks

Object

Nome	Tipo	Descrizione
activationLinks	Microsoft.Partner.Core.Collections.Link
availability	Microsoft.Partner.Core.Collections.Link
product	Microsoft.Partner.Core.Collections.Link
provisioningStatus	Microsoft.Partner.Core.Collections.Link
sku	Microsoft.Partner.Core.Collections.Link
subscription	Microsoft.Partner.Core.Collections.Link

Microsoft.Partner.Services.Orders.V2.Models.OrderLinks

Object

Nome	Tipo	Descrizione
patchOperation	Microsoft.Partner.Core.Collections.Link
provisioningStatus	Microsoft.Partner.Core.Collections.Link
self	Microsoft.Partner.Core.Collections.Link

Microsoft.Partner.Services.Orders.V2.Models.Pricing

Object

Nome	Tipo	Descrizione
discountedPrice	number (double)
extendedPrice	number (double)
listPrice	number (double)
price	number (double)
proratedPrice	number (double)

Microsoft.Partner.Services.Orders.V2.Models.ProductTerm

Object

Nome	Tipo	Descrizione
availabilityId	string
billingCycle	enum: annual (int32) biennial (int32) monthly (int32) none (int32) one_time (int32) triennial (int32) unknown (int32)
productId	string
skuId	string
termDuration	string

Microsoft.Partner.Services.Orders.V2.Models.PurchaseCommitment

Object

Nome	Tipo	Descrizione
amount	number (double)
currency	string
grain	string

Microsoft.Partner.Services.Orders.V2.Models.RenewsTo

Object

Nome	Tipo	Descrizione
termDuration	string

Microsoft.Partner.Services.Orders.V2.Models.ScheduledNextTermInstructions

Object

Nome	Tipo	Descrizione
product	Microsoft.Partner.Services.Orders.V2.Models.ProductTerm
quantity	number (int32)

System.Collections.Generic.KeyValuePair[System.String,System.String]

Object

Nome	Tipo	Descrizione
key	string
value	string