Ordinare le risorse

  • Articolo

Si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

Un partner effettua un ordine quando un cliente vuole acquistare una sottoscrizione da un elenco di offerte.

Nota

La risorsa Order ha un limite di frequenza di 500 richieste al minuto per identificatore del tenant.

Ordinamento

Descrive l'ordine di un partner.

Proprietà Type Descrizione
id string Identificatore dell'ordine fornito al completamento della creazione dell'ordine.
alternateId string Identificatore descrittivo per l'ordine.
referenceCustomerId string Identificatore cliente.
billingCycle string Indica la frequenza con cui il partner viene fatturato per questo ordine. I valori supportati sono i nomi di membro presenti in BillingCycleType. Il valore predefinito è Mensile o OneTime alla creazione dell'ordine. Questo campo viene applicato al completamento della creazione dell'ordine.
transactionType string Sola lettura. Tipo di transazione dell'ordine. I valori supportati sono UserPurchase, SystemPurchase o SystemBilling
lineItems matrice di risorse OrderLineItem Un elenco articolizzato delle offerte che il cliente sta acquistando, inclusa la quantità.
currencyCode string Sola lettura. Valuta utilizzata durante l'esecuzione dell'ordine. Applicato al completamento della creazione dell'ordine.
currencySymbol string Sola lettura. Simbolo di valuta associato al codice di valuta.
creationDate datetime Sola lettura. Data di creazione dell'ordine, nel formato data-ora. Applicato al completamento della creazione dell'ordine.
stato string Sola lettura. Stato dell'ordine. I valori supportati sono i nomi dei membri trovati in OrderStatus.
collegamenti OrderLinks Collegamenti alla risorsa corrispondenti all'ordine.
Attributi ResourceAttributes Attributi dei metadati corrispondenti all'ordine.

OrderLineItem

Un ordine contiene un elenco di offerte con elementi e ogni elemento è rappresentato come OrderLineItem.

Proprietà Type Descrizione
lineItemNumber int Ogni voce nella raccolta ottiene un numero di riga univoco, da 0 a conteggio-1.
offerId string ID dell'offerta.
subscriptionId string ID della sottoscrizione.
parentSubscriptionId string Facoltativo. ID della sottoscrizione padre in un'offerta di componente aggiuntivo. Si applica solo alle PATCH.
friendlyName string Facoltativo. Nome descrittivo per la sottoscrizione definita dal partner per evitare ambiguità.
quantity int Numero di licenze o istanze.
customTermEndDate Data/Ora Data di fine del primo periodo di fatturazione della nuova sottoscrizione.
termDuration string Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (1 mese), P1Y (1 anno) e P3Y (3 anni).
transactionType string Sola lettura. Tipo di transazione dell'elemento della riga. I valori supportati sono nuovi, rinnovati, addQuantity, removeQuantity, cancel, convert o customerCredit.
partnerIdOnRecord string Quando un provider indiretto inserisce un ordine per conto di un rivenditore indiretto, popolare questo campo con il PartnerID solo del rivenditore indiretto (mai l'ID del provider indiretto). Questo assicura una contabilizzazione appropriata per gli incentivi.
provisioningContext ProvisioningContext Informazioni necessarie per il provisioning di alcuni elementi nel catalogo. La proprietà provisioningVariables in uno SKU indica quali proprietà sono necessarie per elementi specifici nel catalogo.
collegamenti OrderLineItemLinks Sola lettura. Collegamenti alla risorsa corrispondenti all'elemento della riga dell'ordine.
renewsTo RenewsTo Dettagli sulla durata del rinnovo.
AttestazioneAccepted bool Indica l'accordo per offrire o sku condizioni. Obbligatorio solo per offerte o SKU in cui SkuAttestationProperties o OfferAttestationProperties enforceAttestation è True.
Prezzi Prezzi Dettagli prezzi di listino.
purchaseCommitment PurchaseCommitment Importo fisso di cui è stato eseguito il commit nei servizi di calcolo.

RenewsTo

Rappresenta i dettagli della durata del periodo di rinnovo.

Proprietà Type Obbligatorio Descrizione
termDuration string No Rappresentazione ISO 8601 della durata del periodo di rinnovo. I valori supportati correnti sono P1M (1 mese) e P1Y (1 anno).

Prezzi

Rappresenta i dettagli del prezzo. Gli importi dei prezzi vengono forniti prima della tassazione.

Proprietà Type Obbligatorio Descrizione
listPrice double No Prezzo elencato nel catalogo senza modificatori di prezzi applicati.
discountedPrice double No Prezzo dopo l'applicazione di tutti i modificatori di prezzi applicabili.
proratedPrice double No Prezzo scontato dopo l'esecuzione della proration.
price double No Prezzo nella valuta di fatturazione applicabile dopo l'applicazione di tutti gli sconti e viene eseguita la proration.
extendedPrice double No Prezzo della voce con quantità, sconti e proration applicati, nella valuta di fatturazione applicabile.

Rappresenta i collegamenti alle risorse corrispondenti all'ordine.

Proprietà Type Descrizione
provisioningStatus Collegamento Se popolato, il collegamento per recuperare lo stato di provisioning per l'ordine.
self Collegamento Collegamento per recuperare la risorsa dell'ordine.

Rappresenta la sottoscrizione completa associata all'ordine.

Proprietà Type Descrizione
provisioningStatus Collegamento Quando viene popolato, il collegamento per recuperare lo stato di provisioning dell'elemento della riga.
sku Collegamento Collegamento per recuperare le informazioni sullo SKU per l'elemento del catalogo acquistato.
sottoscrizione Collegamento Se popolato, il collegamento alle informazioni complete sulla sottoscrizione.
activationLinks Collegamento Quando viene popolata, la risorsa GET per i collegamenti per attivare la sottoscrizione.

OrderStatus

[Enum/dotnet/api/system.enum) con valori che indicano lo stato dell'ordine.

Valore Posizione Descrizione
Sconosciuto 0 Inizializzatore di enumerazione.
Completato 1 L'ordine viene completato.
in sospeso 2 L'ordine è l'elaborazione.
cancelled 3 L'ordine viene annullato.
suspended 4 L'ordine viene sospeso. Per altre informazioni, vedere: Stati del ciclo di vita della sottoscrizione - NCE sospeso.
revisione in sospeso 5 L'ordine è in attesa di revisione secondaria. I partner potrebbero essere necessari per caricare la documentazione. Per informazioni su cosa aspettarsi se si è selezionati per una revisione della trattativa secondaria, vedere Presentazione della revisione delle trattative secondarie.
caricamento po in sospeso 6 Il partner consiste nel caricare l'ordine di acquisto del cliente e immettere i dettagli, come descritto in per la revisione da parte di Microsoft.
caricamento po completato 7 L'ordine di acquisto è stato inviato dal partner e Microsoft sta esaminando. Nessun'altra azione richiesta dal partner.
recensione po rifiutata 8 Questo ordine non ha superato la revisione secondaria e non verrà elaborato.
esito positivo parziale 9 Una o più sottoscrizioni nell'ordine presentano un problema. I partner devono riacquistare le sottoscrizioni non riempite.
Errore 10 L'ordine ha generato un errore. I partner devono riacquistare.

OrderLineItemProvisioningStatus

Rappresenta lo stato di provisioning di un OrderLineItem.

Proprietà Type Descrizione
lineItemNumber int Numero di riga univoco dell'elemento della riga dell'ordine. I valori sono compresi tra 0 e count-1.
stato string Stato del provisioning dell'elemento della riga dell'ordine. I valori includono:
Evaso: l'evasione dell'ordine è stata completata correttamente e l'utente sarà in grado di usare le prenotazioni
non soddisfatte: non soddisfatta a causa dell'annullamento
prefulfillment In sospeso: la richiesta è ancora in fase di elaborazione, l'evasione non è ancora stata completata
quantityProvisioningInformation List<QuantityProvisioningStatus> Elenco di informazioni sullo stato del provisioning della quantità per l'elemento della riga dell'ordine.

QuantityProvisioningStatus

Rappresenta lo stato del provisioning in base alla quantità.

Proprietà Type Descrizione
quantity int Numero di elementi.
stato string Stato del numero di elementi.

ProvisioningContext

Informazioni necessarie per il provisioning di alcuni elementi nel catalogo. La proprietà provisioningVariables in uno SKU indica quali proprietà sono necessarie per elementi specifici nel catalogo.

Proprietà Type Descrizione
ambito string Tipo di ambito per un acquisto che indica dove si applicano i vantaggi: Single, Shared.
entitlementId string ID della sottoscrizione di Azure che verrebbe usata per un acquisto. Obbligatorio per ambito singolo.

PurchaseCommitment

Importo fisso di cui è stato eseguito il commit nei servizi di calcolo.

Proprietà Type Descrizione
amount int Impegno fisso.
Valuta string Valuta dell'impegno.
grano string Periodo dell'impegno.