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. |