API per la fatturazione a consumo nel Marketplace - Domande frequenti

Dopo che un cliente ha sottoscritto un servizio SaaS, app Azure lication con un piano app gestite o un'app Kubernetes con fatturazione a consumo, si registrerà il consumo per ogni dimensione di fatturazione usata. Se il consumo supera le quantità incluse configurate per il periodo di validità selezionato dal cliente, il servizio genererà eventi di utilizzo per Microsoft.

Per le offerte SaaS, le app gestite e le offerte di app Kubernetes

Con quale frequenza è prevista la generazione di utilizzo?

Si prevede idealmente che l'utilizzo venga generato ogni ora per l'ultima ora solo se nell'ora precedente è stato rilevato un utilizzo.

È previsto un periodo massimo tra una generazione e la successiva?

Non esiste alcuna limitazione di questo tipo. L'utilizzo viene generato solo quando si verifica. Se ad esempio è necessario inviare solo un'unità di utilizzo per la durata della sottoscrizione, è possibile farlo.

Qual è il ritardo massimo tra il momento in cui si verifica un evento e il momento in cui viene generato un evento di utilizzo per Microsoft?

L'evento di utilizzo viene idealmente generato ogni ora per gli eventi che si sono verificati nell'ora precedente. Sono tuttavia previsti ritardi. Il ritardo massimo consentito è di 24 ore. Dopo tale periodo gli eventi di utilizzo non verranno accettati. La procedura consigliata consiste nel raccogliere l'utilizzo orario e generarlo come unico evento alla fine dell'ora.

Se ad esempio un evento di utilizzo si verifica alle 13:00 in un giorno specifico, è necessario generare un evento di utilizzo associato a questo evento entro le 13:00 del giorno successivo. Nel caso in cui il sistema che genera l'utilizzo sia inattivo, è consentito attendere che il sistema esegua il ripristino e invii l'evento di utilizzo per l'intervallo di ore in cui l'utilizzo si è verificato, senza perdita di fedeltà.

Se sono trascorse 24 dall'utilizzo effettivo, è comunque possibile generare le unità consumate con eventi di utilizzo successivi. Tuttavia, questa procedura potrebbe danneggiare la credibilità dei report degli eventi di fatturazione per il cliente finale. È consigliabile evitare di inviare una generazione dei contatori una volta al giorno/settimana/mese. Questo approccio renderà più difficile la comprensione dell'utilizzo effettivo da parte del cliente e la risoluzione di problemi o la risposta a domande in merito agli eventi di utilizzo.

Un altro motivo per inviare l'utilizzo ogni ora consiste nell'evitare situazioni in cui l'utente annulla la sottoscrizione prima che l'autore invii l'evento di generazione giornaliero/settimanale/mensile.

Che cosa succede quando si inviano più eventi di utilizzo nella stessa ora?

Per l'intervallo di un'ora viene accettato solo un evento di utilizzo. L'intervallo orario inizia al minuto 0 e termina al minuto 59. Se vengono generati più eventi di utilizzo per la stessa ora, eventuali eventi di utilizzo successivi vengono rimossi come duplicati.

Che cosa succede quando il cliente annulla l'acquisto entro il periodo consentito dal criterio di annullamento?

Non verrà applicato alcun importo a tariffa fissa, ma verrà applicato l'utilizzo dell'eccedenza.

I piani a consumo personalizzati possono essere usati per pagamenti occasionali?

Sì, è possibile definire una dimensione personalizzata come un'unità di un pagamento occasionale e generarla solo una volta per ogni cliente.

I piani a consumo personalizzati possono essere usati per il modello di prezzo a più livelli?

Sì, è possibile implementare questo approccio con ogni dimensione personalizzata che rappresenta un singolo livello di prezzo.

Contoso ad esempio vuole addebitare $ 0,5 per messaggio di posta elettronica per i primi 1000 messaggi, $ 0,4 per messaggio per un numero di messaggi compreso tra 1000 e 5000 e $ 0,2 per messaggio per un numero di messaggi superiore a 5000. È possibile definire tre dimensioni personalizzate che corrispondono ai tre livelli di prezzo per i messaggi di posta elettronica. È possibile generare unità della prima dimensione fintanto che il numero di messaggi di posta elettronica rimane inferiore a 1000, quindi unità della seconda dimensione quando il numero di messaggi è compreso tra 1000 e 5000 e infine unità della terza dimensione per un numero di messaggi superiore a 5000.

Che cosa succede in caso di interruzione del servizio Misurazione del Marketplace?

Se l'ISV invia un contatore personalizzato e riceve un errore, che potrebbe essere stato causato da un problema sul lato Microsoft (in genere nel caso in cui eventi simili siano stati accettati prima senza un errore), l'ISV dovrebbe attendere e ritentare l'emissione.

Se l'errore persiste, inviare di nuovo il contatore personalizzato nell'ora successiva, accumulando la quantità. Continuare questo processo fino alla ricezione di una risposta non di errore.

Solo per offerte SaaS

Che cosa succede quando si genera utilizzo per una sottoscrizione SaaS per cui è già stata annullata la sottoscrizione?

Qualsiasi evento di utilizzo generato nella piattaforma del Marketplace non verrà accettato dopo l'eliminazione di una sottoscrizione SaaS.

L'utilizzo può essere generato solo per le sottoscrizioni con stato Sottoscritto e non per le sottoscrizioni con stato PendingFulfillmentStart, Suspended o Unsubscribed.

L'unica eccezione è costituita dalla segnalazione dell'utilizzo per il periodo precedente all'annullamento della sottoscrizione SaaS.

Il cliente ha ad esempio annullato la sottoscrizione SaaS alle 15:00 di oggi. Sono ora le 17:00 e l'autore può ancora generare utilizzo per il periodo compreso tra le 18:00 di ieri e le 15:00 di oggi per questa sottoscrizione SaaS.

È possibile ottenere un elenco di tutte le sottoscrizioni SaaS, incluse le sottoscrizioni attive e quelle di cui è stata annullata la sottoscrizione?

Sì, quando si chiama l'API GET Subscriptions List, che include un elenco di tutte le sottoscrizioni SaaS. Il campo dello stato nella risposta per ogni sottoscrizione SaaS indica se la sottoscrizione è attiva o se ne è stata annullata la sottoscrizione.

Le date di inizio e di fine del periodo di validità di una sottoscrizione SaaS e della generazione dell'utilizzo dell'eccedenza sono connesse?

Gli eventi di eccedenza possono essere generati in qualsiasi momento per la sottoscrizione SaaS esistente con stato Sottoscritto. L'autore è responsabile della generazione di eventi di utilizzo in base al criterio definito nel piano di fatturazione. L'eccedenza deve essere calcolata in base alle date definite nelle condizioni della sottoscrizione SaaS.

Se ad esempio l'autore definisce un piano SaaS che include 1000 messaggi di posta elettronica per $ 100 con una tariffa fissa mensile, per ogni messaggio oltre i 1000 viene addebitato $ 1 mediante una dimensione personalizzata.

Se il cliente acquista e attiva la sottoscrizione il 6 gennaio, i 1000 messaggi inclusi nella tariffa fissa verranno conteggiati a partire da tale giorno. Se quindi fino al 5 febbraio (fine del primo mese della sottoscrizione) vengono inviati solo 900 messaggi, il cliente pagherà solo la tariffa fissa per il primo mese di questa sottoscrizione e l'autore non genererà eventi di utilizzo di eccedenza tra il 6 gennaio e il 5 febbraio. Il 6 febbraio la sottoscrizione verrà rinnovata automaticamente e il conteggio avrà inizio di nuovo. Se il 15 febbraio il cliente ha raggiunto 1000 messaggi inviati, il resto dei messaggi inviati fino al 5 marzo verrà addebitato come eccedenza ($ 1 per messaggio) in base agli eventi di utilizzo dell'eccedenza generati dall'autore.

Passaggi successivi