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 mercato, creare e inviare un ordine per una sottoscrizione del marketplace commerciale 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 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. È 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 Azure 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 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

Gestire la quantità di sottoscrizioni

La quantità di una sottoscrizione di un marketplace commerciale deve essere nei limiti che il suo SKU associato definisce. 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

Gestire le fatture e la riconciliazione

È possibile gestire le fatture cliente (inclusi gli addebiti per le sottoscrizioni ai prodotti del marketplace commerciale) usando i metodi seguenti:

• Ottenere le voci di consumo fatturate su fattura del marketplace commerciale
• Ottieni i collegamenti per il preventivo di fattura
• Ottieni le voci di consumo non fatturate del marketplace commerciale
• Ottenere le voci di riconciliazione non fatturate

Utilizzare un ambiente di prova sandbox

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