Risorse del carrello

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.

Cartello

Descrive un carrello.

Proprietà Digita Descrizione
id stringa Identificatore del carrello fornito al completamento della creazione del carrello.
creationTimeStamp Data/Ora Data di creazione del carrello, in formato data/ora. Applicato al completamento della creazione del carrello.
lastModifiedTimeStamp Data/Ora Data dell'ultimo aggiornamento del carrello, in formato data/ora. Applicato al completamento della creazione del carrello.
expirationTimeStamp Data/Ora Data di scadenza del carrello, in formato data/ora. Applicato al completamento della creazione del carrello.
lastModifiedUser stringa Utente che ha aggiornato il carrello per ultimo. Applicato al completamento della creazione del carrello.
lineItems Matrici di oggetti Matrice di risorse CartLineItem .
stato stringa Stato del carrello. I valori possibili sono "Active" (possono essere aggiornati/inviati) e "Ordered" (è già stato inviato).

CartLineItem

Rappresenta un elemento contenuto in un carrello.

Proprietà Digita Descrizione
id stringa Identificatore univoco per una voce del carrello. Applicato al completamento della creazione del carrello.
catalogItemId stringa Identificatore dell'elemento del catalogo.
friendlyName stringa (Facoltativo). Nome descrittivo dell'elemento definito dal partner per evitare ambiguità.
quantità int Numero di licenze o istanze.
currencyCode stringa Il codice valuta.
billingCycle Oggetto Tipo di ciclo di fatturazione impostato per il periodo corrente.
termDuration stringa Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (un mese), P1Y (un anno) e P3Y (tre anni).
participants Elenco di coppie di stringhe oggetto Raccolta di PartnerID su record per l'acquisto.
provisioningContext Stringa dizionario<, stringa> Contesto aggiuntivo utilizzato durante il provisioning dell'articolo acquistato. Per determinare quali valori sono necessari per un particolare elemento, fare riferimento alla proprietà provisioningVariables dello SKU.
orderGroup stringa Gruppo per indicare quali elementi possono essere inviati insieme nello stesso ordine.
addonItems Elenco di oggetti CartLineItem Raccolta di voci del carrello per i componenti aggiuntivi. Questi articoli verranno acquistati per la sottoscrizione di base risultante dall'acquisto dell'elemento della riga del carrello radice.
error Oggetto Applicato dopo la creazione del carrello se si è verificato un errore.
renewsTo Matrici di oggetti Matrice di risorse RenewsTo .
AttestazioneAccepted bool Indica l'accordo per offrire o sku condizioni. Obbligatorio solo per offerte o SKU in cui SkuAttestationProperties o OfferAttestationProperties enforceAttestation è True.
promotionId stringa ID promozione che sta per essere applicato alla voce del carrello.
customTermEndDate Data/Ora Data di fine del primo periodo di fatturazione della nuova sottoscrizione.

Prezzo

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

Proprietà Type Richiesto 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 ed è stata eseguita la proration.
extendedPrice double No Prezzo della voce con quantità, sconti e proration applicati, nella valuta di fatturazione applicabile.

RenewsTo

Rappresenta un elemento contenuto in una voce del carrello.

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

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedere Codici di errore del Centro per i partner.

CartError

Rappresenta un errore che si verifica dopo la creazione di un carrello.

Proprietà Digita Descrizione
errorCode CartErrorCode Tipo di errore del carrello.
errorDescription stringa Descrizione dell'errore, incluse eventuali note sui valori supportati, i valori predefiniti o i limiti.
additionalInformation AdditionalInformation Informazioni aggiuntive per l'errore.

AdditionalInformation

Informazioni aggiuntive sull'errore.

Proprietà Digita Descrizione
availableQuantity int Numero di licenze rimanenti che possono essere acquistate per lo SKU del prodotto specificato.
purchaseQuantity int Numero di licenze acquistate.

CartErrorCode

Tipi di errori del carrello.

Nome ErrorCode Descrizione
CurrencyIsNotSupported 10000 La valuta non è supportata per il mercato specificato
CatalogItemIdIsNotValid 10001 L'ID elemento del catalogo non è valido
QuotaNotAvailable 10002 Quota insufficiente disponibile
InventoryNotAvailable 10003 L'inventario non è disponibile per l'offerta selezionata
PartecipantiIsNotSupportedForPartner 10004 L'impostazione dei partecipanti non è supportata per i partner
UnableToProcessCartLineItem 10006 Impossibile elaborare l'elemento della riga del carrello.
SubscriptionIsNotValid 10007 La sottoscrizione non è valida.
SubscriptionIsNotEnabledForRI 10008 La sottoscrizione non è abilitata per gli acquisti di prenotazioni.
SandboxLimitExceeded 10009 È stato superato il limite della sandbox.
InvalidInput 10010 L'input generico non è valido.
SubscriptionNotRegistered 10011 La sottoscrizione non è valida.
AttestationNotAccepted 10012 L'attestazione non è stata accettata.
MaxAllowedSeatsPerSubscriptionExceeded 10015 Il numero richiesto di postazioni supera il limite.
Sconosciuto 0 Valore predefinito

CartCheckoutResult

Rappresenta il risultato di un checkout del carrello.

Proprietà Digita Descrizione
orders Elenco di oggetti Order . Raccolta di ordini.
orderErrors Elenco di oggetti OrderError . Raccolta di errori di ordine.

OrderError

Rappresenta un errore che si verifica durante l'estrazione del carrello quando viene creato un ordine.

Proprietà Digita Descrizione
orderGroupId stringa ID del gruppo di ordini dell'ordine con l'errore.
codice int Codice di errore.
description stringa Descrizione dell'errore.