Creare una sottoscrizione per i prodotti Microsoft Marketplace

È possibile creare una sottoscrizione per i prodotti Microsoft Marketplace 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 di Microsoft Marketplace e 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 Accounte quindi salvare il valore ID Microsoft del cliente.

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: un'unità di mantenimento delle scorte (SKU) acquistabile in un prodotto. Gli SKU rappresentano le varietà 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 (per paese/area geografica)
   • Ottenere un prodotto in base all'ID
   • Ottenere un elenco di SKU per un prodotto (per paese/area geografica)
   • Ottieni un SKU tramite ID

   Nota

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

2. Se i codici articolo sono contrassegnati con un prerequisito InventoryCheck, controllare l'inventario per un codice articolo.

   Nota

   Al momento, non ci sono prodotti di Microsoft Marketplace che supportano il controllo dell'inventario o sono contrassegnati con un InventoryCheck prerequisito.

3. Recuperare la disponibilità per lo SKU. È necessario il valore CatalogItemId della disponibilità durante l'inserimento dell'ordine. È possibile recuperarlo tramite le API seguenti:

   • Ottenere un elenco di disponibilità per uno SKU (per paese/area geografica)
   • Ottenere la disponibilità in base all'ID

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. Concludere l'acquisto, 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.

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

Ottenere un collegamento di attivazione

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

Gestire il ciclo di vita della sottoscrizione

È possibile gestire il ciclo di vita delle sottoscrizioni ai prodotti Microsoft Marketplace usando i metodi seguenti:

• Annullare una sottoscrizione di Microsoft Marketplace
• Abilitare o disabilitare l'autorenew per una sottoscrizione di Microsoft Marketplace

Gestire la quantità di sottoscrizioni

La quantità di una sottoscrizione di Microsoft Marketplace deve essere compresa nei limiti definiti dallo SKU associato. Vedere gli minimumQuantity attributi e maximumQuantity . Per aggiornare la quantità di una sottoscrizione di Microsoft Marketplace, usare il metodo seguente:

• Modificare la quantità di una sottoscrizione

Gestire le fatture e la riconciliazione

È possibile gestire le fatture dei clienti (inclusi gli addebiti per le sottoscrizioni ai prodotti Microsoft Marketplace) usando i metodi seguenti:

• Ottenere le voci relative al consumo di Microsoft Marketplace fatturate
• Ottieni i collegamenti per il preventivo di fattura
• Ottenere le voci di utilizzo di Microsoft Marketplace non fatturate
• Ottenere le voci di riconciliazione non fatturate

Utilizzare un ambiente di prova sandbox

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