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.
Carretto
Descrive un carrello.
| Proprietà | Digitare | Descrizione |
|---|---|---|
| Id | corda | Identificatore del carrello fornito al completamento della creazione del carrello. |
| data e ora di creazione | Data e Ora | Data di creazione del carrello, in formato data/ora. Applicato al completamento della creazione del carrello. |
| lastModifiedTimeStamp | DateTime | Data dell'ultimo aggiornamento del carrello, in formato data/ora. Applicato al momento della riuscita creazione del carrello. |
| timestamp di scadenza | DateTime | Data di scadenza del carrello, in formato data/ora. Applicato al momento della creazione riuscita del carrello. |
| ultimoUtenteModificato | corda | Utente che ha aggiornato il carrello per ultimo. Applicato al completamento della creazione del carrello. |
| lineItems | Matrice di oggetti | Matrice di risorse CartLineItem. |
| stato | corda | 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à | Digitare | Descrizione |
|---|---|---|
| Id | corda | Identificatore univoco per una voce del carrello. Applicato dopo la creazione riuscita del carrello. |
| catalogItemId | corda | Identificatore dell'elemento del catalogo. |
| nome amichevole | corda | Opzionale. Nome descrittivo dell'elemento definito dal partner per evitare ambiguità. |
| quantità | Int | Numero di licenze o istanze. |
| codice valuta | corda | Codice valuta. |
| ciclo di fatturazione | Oggetto | Tipo di ciclo di fatturazione impostato per il periodo corrente. |
| durata del termine | corda | Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (un mese), P1Y (un anno) e P3Y (tre anni). |
| Partecipanti | Elenco di coppie oggetto-stringa | Raccolta dei PartnerID registrati relativi all'acquisto. |
| provisioningContext | Stringa<dizionario, stringa> | Contesto aggiuntivo utilizzato durante la fornitura dell'articolo acquistato. Per determinare quali valori sono necessari per un particolare elemento, fare riferimento alla proprietà provisioningVariables dello SKU. |
| orderGroup | corda | Gruppo per indicare quali elementi possono essere inviati insieme nello stesso ordine. |
| elementi aggiuntivi | Elenco di oggetti CartLineItem | Raccolta di elementi del carrello per i componenti aggiuntivi. Questi articoli verranno acquistati per l'abbonamento di base che risulta dall'acquisto della riga iniziale del carrello. |
| errore | Oggetto | Applicato dopo la creazione del carrello se si è verificato un errore. |
| rinnova fino a | Matrice di oggetti | Matrice di risorse RenewsTo. |
| AttestazioneAccettata | Bool | Indica l'accettazione delle condizioni dell'offerta o delle condizioni SKU. Obbligatorio solo per offerte o SKU in cui SkuAttestationProperties o OfferAttestationProperties enforceAttestation è True. |
| promotionId | corda | L'ID promozione che sta per essere applicato all'elemento della riga del carrello. |
| customTermEndDate | DateTime | Data di fine del primo periodo di fatturazione della nuova sottoscrizione. |
Prezzi
Rappresenta i dettagli del prezzo. Gli importi sono forniti prima della tassazione.
| Proprietà | Digitare | Obbligatorio | Descrizione |
|---|---|---|---|
| prezzo di listino | doppio | No | Prezzo elencato nel catalogo senza modificatori di prezzi applicati. |
| prezzo scontato | doppio | No | Prezzo dopo l'applicazione di tutti i modificatori di prezzi applicabili. |
| prezzo ripartito | doppio | No | Prezzo scontato dopo il calcolo proporzionale. |
| prezzo | doppio | No | Prezzo nella valuta di fatturazione applicabile dopo l'applicazione di tutti gli sconti e l'esecuzione della ripartizione proporzionale. |
| prezzo esteso | doppio | No | Prezzo della voce con quantità, sconti e proration applicati, nella valuta di fatturazione applicabile. |
RenewsTo
Rappresenta un elemento contenuto in una linea del carrello.
| Proprietà | Digitare | Obbligatorio | Descrizione |
|---|---|---|---|
| durata del termine | corda | 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 esito positivo della risposta
Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere il codice, il tipo di errore e i parametri aggiuntivi. Per l'elenco completo, vedere codici di errore del Centro Partner.
CartError
Rappresenta un errore che si verifica dopo la creazione di un carrello.
| Proprietà | Digitare | Descrizione |
|---|---|---|
| codice di errore | CartErrorCode | Tipo di errore del carrello. |
| Descrizione dell'errore | corda | Descrizione dell'errore, incluse eventuali note sui valori supportati, i valori predefiniti o i limiti. |
| informazioni aggiuntive | Informazioni aggiuntive | Informazioni aggiuntive per l'errore. |
Informazioni Aggiuntive
Informazioni aggiuntive sull'errore.
| Proprietà | Digitare | Descrizione |
|---|---|---|
| quantitàDisponibile | Int | Numero di licenze rimanenti che possono essere acquistate per lo SKU del prodotto specificato. |
| quantità acquistata | Int | Numero di licenze acquistate. |
CartErrorCode
Tipi di errori del carrello.
| Nome | CodiceErrore | Descrizione |
|---|---|---|
| La valuta non è supportata | 10000 | La valuta non è supportata per il mercato specificato |
| CatalogoElementoIdNonValido | 10001 | L'ID elemento del catalogo non è valido |
| QuotaNotAvailable | 10002 | Quota insufficiente disponibile |
| InventarioNonDisponibile | 10003 | L'inventario non è disponibile per l'offerta selezionata |
| PartecipantiIsNotSupportedForPartner | 10004 | L'impostazione dei partecipanti non è supportata per i Partner |
| Impossibile elaborare la voce del carrello | 10006 | Impossibile elaborare l'elemento della riga del carrello. |
| L'abbonamento non è valido | 10007 | La sottoscrizione non è valida. |
| La sottoscrizione non è abilitata per RI. | 10008 | Non è possibile utilizzare la sottoscrizione per acquisti di prenotazione. |
| Eccesso del limite della sandbox | 10009 | È stato superato il limite della sandbox. |
| Input non valido | 10010 | L'input generico non è valido. |
| SottoscrizioneNonRegistrata | 10011 | La sottoscrizione non è valida. |
| AttestazioneNonAccettata | 10012 | L'attestazione non è stata accettata. |
| Numero massimo di posti consentiti per abbonamento superato | 10015 | Il numero richiesto di posti a sedere supera il limite. |
| Sconosciuto | 0 | Valore predefinito |
RisultatoCarrelloAcquisto
Rappresenta il risultato di un checkout del carrello.
| Proprietà | Tipo | Descrizione |
|---|---|---|
| Ordini | Elenco di oggetti dell'ordine . | Raccolta di ordini. |
| orderErrors | Elenco di oggetti OrderError. | Raccolta di errori di ordine. |
OrderError
Rappresenta un errore che si verifica durante il checkout del carrello quando avviene la creazione di un ordine.
| Proprietà | Digitare | Descrizione |
|---|---|---|
| IDgruppoOrdine | corda | ID del gruppo d'ordine dell'ordine con l'errore. |
| codice | Int | Codice di errore. |
| descrizione | corda | Descrizione dell'errore. |