API di fatturazione a consumo del Marketplace - Domande frequenti

Una volta che un cliente sottoscrive un servizio SaaS, un'applicazione di Azure con un piano di app gestite o un'app Kubernetes con fatturazione a consumo, può tenere traccia del consumo per ogni dimensione di fatturazione usata. Se il consumo supera le quantità incluse impostate per il termine selezionato dal cliente, il servizio genera eventi di utilizzo a Microsoft.

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

Con quale frequenza si prevede di generare l'utilizzo?

Idealmente, si prevede di generare l'utilizzo ogni ora per l'ultima ora, solo se è presente un utilizzo nell'ora precedente.

Esiste un periodo massimo tra una emissione e quella successiva?

Non esiste una tale limitazione. Genera solo l'utilizzo quando si verifica. Ad esempio, se è sufficiente inviare un'unità di utilizzo per durata della sottoscrizione, è possibile farlo.

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

Idealmente, l'evento di utilizzo viene generato ogni ora per gli eventi che si sono verificati nell'ultima ora. Ma sono previsti ritardi. Il ritardo massimo consentito è di 24 ore, dopo il quale gli eventi di utilizzo non vengono accettati. La procedura consigliata consiste nel raccogliere l'utilizzo orario e generarlo come evento alla fine dell'ora. Ad esempio, se si verifica un evento di utilizzo alle 13.00 di un giorno, si avrà fino alle 13 del giorno successivo per generare un evento di utilizzo associato a questo evento. Se il sistema che emette l'utilizzo è inattivo, può recuperare e quindi inviare l'evento di utilizzo per l'intervallo di ora in cui si è verificato l'utilizzo, senza perdita di fedeltà. Se passano 24 ore dopo l'utilizzo effettivo, è comunque possibile generare le unità utilizzate 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 emissioni di contatori una volta al giorno/settimana/mese. È più difficile comprendere l'utilizzo effettivo da parte di un cliente e risolvere problemi o domande che potrebbero essere generati in relazione 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'editore invii l'evento di emissione giornaliera/settimanale/mensile.

Nota

Un ritardo di 24 ore per l'invio di eventi di utilizzo è applicabile anche ai piani convertiti/aggiornati. Se un cliente aggiorna il piano a un nuovo piano, l'utilizzo del piano precedente deve essere segnalato entro 24 ore dalla conversione del piano.

Cosa accade quando si inviano più eventi di utilizzo nella stessa ora?

Per l'intervallo di un'ora viene accettato un solo evento di utilizzo. L'intervallo di ora 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 eliminati come duplicati.

Cosa accade quando il cliente annulla l'acquisto entro il tempo consentito dal criterio di annullamento?

L'importo a tariffa fissa non viene addebitato, ma l'utilizzo dell'eccedenza è.

È possibile usare piani contatori personalizzati per i pagamenti monouso?

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

I piani di misurazione personalizzati possono essere usati per il modello tariffario a livelli?

Sì, può essere implementato con ogni dimensione personalizzata che rappresenta un singolo livello di prezzo.

Ad esempio, Contoso vuole pagare $ 0,5 per posta elettronica per i primi 1.000 messaggi di posta elettronica, $ 0,4 per posta elettronica tra 1.000 e 5.000 messaggi di posta elettronica e $ 0,2 per posta elettronica superiore a 5.000 messaggi di posta elettronica. Possono definire tre dimensioni personalizzate che corrispondono ai tre piani tariffari di posta elettronica. Generare unità della prima dimensione finché il numero di messaggi di posta elettronica rimane inferiore a 1.000, quindi unità della seconda dimensione quando il numero di messaggi di posta elettronica è compreso tra 1.000 e 5.000 e infine unità della terza dimensione per oltre 5.000 messaggi di posta elettronica.

Cosa accade se il servizio di misurazione del Marketplace ha un'interruzione?

Se l'ISV (Independent Software Vendor) 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 errori), l'ISV dovrebbe attendere e ritentare l'emissione.

Se l'errore persiste, inviare nuovamente il contatore personalizzato all'ora successiva (accumulare la quantità). Continuare questo processo fino a quando non viene ricevuta una risposta nonerrore.

Solo per le offerte SaaS

Cosa accade quando si genera l'utilizzo per una sottoscrizione SaaS già annullata?

Qualsiasi evento di utilizzo generato nella piattaforma marketplace non viene accettato dopo l'eliminazione di una sottoscrizione SaaS.

L'utilizzo può essere generato solo per le sottoscrizioni nello stato Sottoscritto (e non per le sottoscrizioni in PendingFulfillmentStart, Suspendedo Unsubscribed stato).

L'unica eccezione consiste nel segnalare l'utilizzo per il tempo precedente all'annullamento della sottoscrizione SaaS.

Ad esempio, il cliente ha annullato la sottoscrizione SaaS alle 18:00. Ora è alle 17:00, l'editore può comunque generare l'utilizzo per il periodo tra le 18:00 di ieri e le 13:00 di oggi per questa sottoscrizione SaaS.

È possibile ottenere un elenco di tutte le sottoscrizioni SaaS, incluse le sottoscrizioni attive e annullate?

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

Le date di inizio e di fine del periodo di sottoscrizione SaaS e delle emissioni di utilizzo eccessivo sono connesse?

Gli eventi di eccedenza possono essere generati in qualsiasi momento per la sottoscrizione SaaS esistente in stato sottoscritto. È responsabilità dell'editore generare eventi di utilizzo in base ai criteri definiti nel piano di fatturazione. L'eccedenza deve essere calcolata in base alle date definite nel termine della sottoscrizione SaaS.

Ad esempio, se l'editore definisce un piano SaaS che include 1.000 messaggi di posta elettronica per $ 100 in tariffa fissa mensile, ogni messaggio di posta elettronica superiore a 1.000 viene fatturato $ 1 tramite dimensione personalizzata.

Quando il cliente acquista e attiva l'abbonamento il 6 gennaio, i 1.000 messaggi di posta elettronica inclusi nella tariffa fissa vengono conteggiati a partire da questo giorno. Pertanto, se fino al 5 febbraio (fine del primo mese della sottoscrizione), vengono inviati solo 900 messaggi di posta elettronica, il cliente paga la tariffa fissa solo per il primo mese di questa sottoscrizione e non vengono generati eventi di utilizzo eccessivo dall'editore tra il 6 gennaio e il 5 febbraio. Il 6 febbraio, l'abbonamento viene rinnovato automaticamente e il conteggio viene avviato di nuovo. Se il 15 febbraio, il cliente ha raggiunto 1.000 messaggi di posta elettronica inviati, il resto dei messaggi di posta elettronica inviati fino al 5 marzo viene addebitato come eccedenza ($ 1 per posta elettronica) in base agli eventi di utilizzo dell'eccedenza generati dall'editore.