Creare una sottoscrizione per i prodotti del marketplace commerciale
Puoi 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 mercato, creare e inviare un ordine per una sottoscrizione del 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 le credenziali app autonome e App+Utente.
- Identificatore 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 e quindi salvare l'ID Microsoft.
Ottenere un elenco delle offerte per un mercato
È possibile controllare le offerte disponibili per un mercato usando i modelli API del Centro per i partner seguenti:
- Prodotto: costrutto di raggruppamento per beni o servizi acquistabili. Un prodotto stesso non è un articolo acquistabile.
- SKU: unità di mantenimento delle scorte (SKU) acquistabili in un prodotto. Questi 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:
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 dei prodotti
- Ottenere un prodotto usando l'ID prodotto
- Ottenere un elenco degli SKU per un prodotto
- Ottenere uno SKU usando l'ID SKU
Nota
È possibile identificare i prodotti del marketplace commerciale in base alla proprietà ProductType di "Azure" e alla relativa proprietà SubType "SaaS".
Se gli SKU sono contrassegnati con un prerequisito InventoryCheck , controllare l'inventario per uno SKU.
Nota
Al momento, non ci sono prodotti del marketplace commerciale che supportano il controllo dell'inventario o sono contrassegnati con un prerequisito InventoryCheck .
Recuperare la disponibilità per lo SKU. Sarà necessario catalogitemId della disponibilità quando si effettua l'ordine, che è possibile recuperare tramite le API seguenti:
Creare e inviare un ordine
Per inviare l'ordine di prenotazione di Azure, seguire questa procedura:
- Creare un carrello per contenere la raccolta di articoli del catalogo che si intende acquistare. Quando si crea un carrello, le righe del carrello vengono raggruppate automaticamente in base a ciò che può essere acquistato insieme nello stesso ordine. È anche possibile aggiornare un carrello.
- 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.
Ottenere il collegamento di attivazione
Il partner o il cliente deve attivare le sottoscrizioni ai prodotti Azure Marketplace. È possibile ottenere un collegamento di attivazione in base all'elemento della riga dell'ordine. È anche possibile ottenere una sottoscrizione in base all'ID, quindi enumerare la relativa proprietà Links per creare un collegamento di attivazione.
Gestione ciclo di vita
È possibile gestire il ciclo di vita delle sottoscrizioni ai prodotti del marketplace commerciale usando i metodi seguenti:
- Annullare un abbonamento del marketplace commerciale
- Abilitare o disabilitare l'autorenew per una sottoscrizione del marketplace commerciale
Gestione della quantità
La quantità di una sottoscrizione del marketplace commerciale deve essere compresa nei limiti definiti dallo SKU associato (vedere gli attributi minimumQuantity e maximumQuantity). Per aggiornare la quantità di una sottoscrizione del marketplace commerciale, usare il metodo seguente:
Fattura e riconciliazione
È possibile gestire le fatture dei clienti (inclusi gli addebiti per le sottoscrizioni ai prodotti del marketplace commerciale) usando i metodi seguenti:
- Ottenere le voci di consumo fatturate del marketplace commerciale
- Ottenere i collegamenti relativi alle stime delle fatture
- Ottenere le voci di consumo non fatturate del marketplace commerciale
- Ottenere le voci di riconciliazione non fatturate
Testare l'uso dell'account sandbox di integrazione
In produzione, dopo aver creato una sottoscrizione per i prodotti SaaS del marketplace commerciale, è necessario recuperare un collegamento di attivazione personalizzato dal Centro per i partner e visitare il sito dell'editore per completare il processo di configurazione. La fatturazione della sottoscrizione inizierà solo dopo il completamento dell'installazione.
Nell'ambiente sandbox CSP non esiste alcuna integrazione con isv. Se si tenta di recuperare un collegamento di attivazione dal Centro per i partner, verrà restituito un collegamento fittizio. Non è possibile usare questo collegamento fittizio per completare il processo di installazione nel sito dell'editore. Per usare l'account sandbox di integrazione per testare la fatturazione per le sottoscrizioni ai prodotti SaaS del marketplace commerciale, usare invece il metodo seguente per attivare la sottoscrizione. La fatturazione della sottoscrizione inizierà dopo l'attivazione riuscita: