Creare una sottoscrizione per i prodotti del marketplace commerciale

È possibile creare una sottoscrizione per i prodotti del marketplace commerciale usando le API del Centro per i partner. È necessario ottenere un elenco di offerte per un marketplace, creare e inviare un ordine per un abbonamento al marketplace commerciale, quindi recuperare un collegamento di attivazione.

È anche possibile eseguire la gestione del ciclo di vita e gestire le fatture per queste sottoscrizioni.

Prerequisiti

• credenziali di autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con credenziali sia di app autonome che di App+Utente.
• Identificatore del cliente. Se non si dispone dell'identificatore di un cliente, seguire la procedura descritta in Ottenere un elenco di clienti. In alternativa, accedere al Centro per i Partner, scegliere il cliente dall'elenco dei clienti, selezionare Account, quindi salvare il loro ID Microsoft.

Ottenere un elenco di offerte per un mercato

È possibile controllare le offerte disponibili per un mercato usando i modelli API del Centro per i partner seguenti:

• Product: costrutto di raggruppamento per beni o servizi acquistabili. Un prodotto stesso non è un articolo acquistabile.
• SKU: unità di mantenimento delle scorte (SKU) acquistabile in un prodotto. Gli SKU rappresentano le diverse forme del prodotto.
• disponibilità: configurazione in cui è disponibile uno SKU per l'acquisto (ad esempio paese/area geografica, valuta o segmento del settore).

Prima di acquistare una prenotazione di Azure, completare la procedura seguente:

1. Identificare e recuperare il prodotto e lo SKU da acquistare. Se si conosce già l'ID prodotto e l'ID SKU, selezionarli.

   • Ottenere un elenco di prodotti
   • Ottenere un prodotto usando l'ID prodotto
   • Ottenere un elenco di SKU per un prodotto
   • Ottieni uno SKU usando l'ID SKU

   Nota

   È possibile identificare i prodotti del marketplace commerciale in base alla proprietà ProductType di "Azure" e alla proprietà SubType di "SaaS" .

2. Se gli SKU sono contrassegnati con il prerequisito InventoryCheck, verificare l'inventario per uno SKU.

   Nota

   Al momento, non esistono prodotti del marketplace commerciale che supportano il controllo dell'inventario o sono contrassegnati con un prerequisito InventoryCheck.

3. Recuperare la disponibilità per lo SKU. Avrai bisogno del CatalogItemId della disponibilità quando effettui l'ordine, che puoi recuperare tramite le API seguenti:

   • Ottenere un elenco di disponibilità per uno SKU
   • Ottenere una disponibilità usando l'ID di disponibilità

Creare e inviare un ordine

1. Creare un carrello per contenere la raccolta di articoli del catalogo che si intende acquistare. Quando si crea un carrello , gli articoli del carrello vengono raggruppati automaticamente in base a ciò che è possibile acquistare insieme nello stesso ordine . È anche possibile aggiornare un carrello.
2. Controllare il carrello, che comporta la creazione di un ordine .

Ottenere i dettagli dell'ordine

È possibile recuperare i dettagli di un singolo ordine usando l'ID ordine. È anche possibile recuperare un elenco di tutti gli ordini per un cliente specifico.

Nota

Dopo l'invio di un ordine, si verifica un ritardo massimo di 15 minuti prima che l'ordine venga visualizzato nell'elenco degli ordini del cliente.

Ottieni il link di attivazione

Il partner o il cliente deve attivare le sottoscrizioni ai prodotti Azure Marketplace. È possibile ottenere un collegamento di attivazione per la voce di ordine. È anche possibile ottenere un abbonamento tramite ID, quindi enumerare la sua proprietà Links per creare un collegamento di attivazione.

Gestione del ciclo di vita

È possibile gestire il ciclo di vita delle sottoscrizioni ai prodotti del marketplace commerciale usando i metodi seguenti:

• Annullare una sottoscrizione del marketplace commerciale
• Abilitare o disabilitare il rinnovo automatico per una sottoscrizione di un marketplace commerciale

Gestione della quantità

La quantità di una sottoscrizione del marketplace commerciale deve essere compresa nei limiti definiti dall' SKU associato(vedere gli attributi minimumQuantity e maximumQuantity). Per aggiornare la quantità di una sottoscrizione del marketplace commerciale, usare il metodo seguente:

• Modificare la quantità di una sottoscrizione

Fattura e riconciliazione

È possibile gestire le fatture del cliente (comprese le spese per le sottoscrizioni ai prodotti del marketplace commerciale) utilizzando i seguenti metodi:

• Ottenere le voci di consumo fatturate del marketplace commerciale
• Ottenere i collegamenti per la stima della fattura
• Ottieni le voci di consumo non fatturate del marketplace commerciale
• Ottenere le voci di riconciliazione non fatturate

Ambiente di prova

Per indicazioni sulla sandbox del Marketplace, vedere testare ed eseguire il debug con la sandbox di integrazione del Centro per i partner.