Delen via


Marketplace-API's voor facturering naar gebruik - veelgestelde vragen

Zodra een klant zich abonneert op een SaaS-service, azure-toepassing met een abonnement voor beheerde apps of kubernetes-apps met facturering naar gebruik, kunnen ze het verbruik bijhouden voor elke factureringsdimensie die wordt gebruikt. Als het verbruik de opgenomen hoeveelheden overschrijdt die zijn ingesteld voor de termijn die door de klant is geselecteerd, verzendt uw service gebruiksgebeurtenissen naar Microsoft.

Voor SaaS-aanbiedingen, beheerde apps en Kubernetes-app-aanbiedingen

Hoe vaak wordt verwacht dat het gebruik wordt verzonden?

Idealiter wordt verwacht dat u elk uur het gebruik voor het afgelopen uur verzendt, alleen als er gebruik is in het vorige uur.

Is er een maximale periode tussen één emissie en de volgende?

Er is geen dergelijke beperking. Verzendt alleen het gebruik naarmate deze zich voordoet. Als u bijvoorbeeld slechts één gebruikseenheid per levensduur van het abonnement hoeft in te dienen, kunt u dit doen.

Wat is de maximale vertraging tussen de tijd dat een gebeurtenis plaatsvindt en de tijd dat een gebruiks gebeurtenis naar Microsoft wordt verzonden?

In het ideale geval wordt de gebruiksgebeurtenis elk uur verzonden voor gebeurtenissen die in het afgelopen uur hebben plaatsgevonden. Maar vertragingen worden verwacht. De maximaal toegestane vertraging is 24 uur, waarna gebruiksevenementen niet worden geaccepteerd. U kunt het beste elk uur gebruik verzamelen en verzenden als één gebeurtenis aan het einde van het uur. Als een gebruiksevenement bijvoorbeeld om 13:00 uur op een dag plaatsvindt, hebt u tot 13:00 uur op de volgende dag om een gebruiksevenement te verzenden dat aan deze gebeurtenis is gekoppeld. Als het systeem dat het gebruik verzendt niet beschikbaar is, kan het de gebruiksgebeurtenis herstellen en vervolgens verzenden voor het uurinterval waarin het gebruik is opgetreden, zonder verlies van betrouwbaarheid. Als 24 uur na het werkelijke gebruik is verstreken, kunt u de verbruikte eenheden nog steeds verzenden met latere gebruiksevenementen. Maar deze praktijk kan de geloofwaardigheid van de factureringsgebeurtenisrapporten voor de eindklant schaden. We raden u aan om het verzenden van meteruitgifte één keer per dag/week/maand te vermijden. Het is moeilijker om het werkelijke gebruik door een klant te begrijpen en om problemen of vragen op te lossen die kunnen worden gesteld met betrekking tot gebruiksevenementen. Een andere reden om elk uur gebruik te verzenden, is om situaties te voorkomen waarin de gebruiker het abonnement annuleert voordat de uitgever de dagelijkse/wekelijkse/maandelijkse emissie-gebeurtenis verzendt.

Notitie

Een vertraging van 24 uur voor het verzenden van gebruiksgebeurtenissen is ook van toepassing op geconverteerde/bijgewerkte abonnementen. Als een klant het plan upgradet naar een nieuw abonnement, moet het gebruik van het vorige abonnement worden gerapporteerd binnen 24 uur nadat het abonnement is geconverteerd.

Wat gebeurt er wanneer u meer dan één gebruiksevenement in hetzelfde uur verzendt?

Er wordt slechts één gebruiksgebeurtenis geaccepteerd voor het interval van één uur. Het uurinterval begint op minuut 0 en eindigt op minuut 59. Als er meer dan één gebruiksgebeurtenis voor hetzelfde uur wordt verzonden, worden alle volgende gebruiksgebeurtenissen verwijderd als duplicaten.

Wat gebeurt er wanneer de klant de aankoop annuleert binnen de tijd die is toegestaan door het annuleringsbeleid?

Het vaste bedrag wordt niet in rekening gebracht, maar het overschrijdingsgebruik is.

Kunnen aangepaste meterplannen worden gebruikt voor eenmalige betalingen?

Ja, u kunt een aangepaste dimensie definiëren als één eenheid van eenmalige betaling en deze slechts één keer verzenden voor elke klant.

Kunnen aangepaste meterabonnementen worden gebruikt voor gelaagd prijsmodel?

Ja, deze kan worden geïmplementeerd met elke aangepaste dimensie die één prijscategorie vertegenwoordigt.

Contoso wil bijvoorbeeld $ 0,5 per e-mail in rekening brengen voor de eerste 1000 e-mailberichten, $ 0,4 per e-mail tussen 1.000 en 5.000 e-mails en $ 0,2 per e-mail voor meer dan 5000 e-mailberichten. Ze kunnen drie aangepaste dimensies definiëren die overeenkomen met de drie prijscategorieën voor e-mail. Verzend eenheden van de eerste dimensie zolang het aantal e-mailberichten onder de 1000 blijft, vervolgens eenheden van de tweede dimensie wanneer het aantal e-mailberichten tussen 1.000 en 5.000 ligt en ten slotte eenheden van de derde dimensie voor meer dan 5000 e-mailberichten.

Wat gebeurt er als de Marketplace-meterservice een storing heeft?

Als de onafhankelijke softwareleverancier (ISV) een aangepaste meter verzendt en een fout ontvangt die mogelijk is veroorzaakt door een probleem aan de zijde van Microsoft (meestal in het geval dat soortgelijke gebeurtenissen eerder zijn geaccepteerd zonder een fout), moet de ISV wachten en de emissie opnieuw proberen.

Als de fout zich blijft voordoen, dient u die aangepaste meter het volgende uur opnieuw in (de hoeveelheid verzamelen). Ga door met dit proces totdat een nonerror-antwoord is ontvangen.

Alleen voor SaaS-aanbiedingen

Wat gebeurt er wanneer u het gebruik verzendt voor een SaaS-abonnement dat al is afgemeld?

Elke gebruiks gebeurtenis die naar het Marketplace-platform wordt verzonden, wordt niet geaccepteerd nadat een SaaS-abonnement is verwijderd.

Gebruik kan alleen worden verzonden voor abonnementen met de status Geabonneerd (en niet voor abonnementen in PendingFulfillmentStart, Suspendedof Unsubscribed status).

De enige uitzondering is het rapporteren van gebruik voor het moment dat het SaaS-abonnement werd geannuleerd.

De klant heeft bijvoorbeeld vandaag om 13:00 uur het SaaS-abonnement geannuleerd. Nu is het 17:00 uur, de uitgever kan nog steeds gebruik verzenden voor de periode tussen 18:00 en 18:00 uur vandaag voor dit SaaS-abonnement.

Kunt u een lijst krijgen met alle SaaS-abonnementen, inclusief actieve en afgemelde abonnementen?

Ja, wanneer u de API voor GET-abonnementenlijst aanroept omdat deze een lijst bevat met alle SaaS-abonnementen. Het statusveld in het antwoord voor elk SaaS-abonnement legt vast of het abonnement actief of afgemeld is.

Zijn de begin- en einddatums van de saaS-abonnementsperiode en overschrijdingsgebruiksemissie verbonden?

Overschrijdingsgebeurtenissen kunnen op elk moment worden verzonden voor een bestaand SaaS-abonnement in geabonneerde status. Het is de verantwoordelijkheid van de uitgever om gebruiksevenementen te verzenden op basis van het beleid dat is gedefinieerd in het factureringsplan. De overschrijding moet worden berekend op basis van de datums die zijn gedefinieerd in de termijn van het SaaS-abonnement.

Als de uitgever bijvoorbeeld een SaaS-abonnement definieert dat 1000 e-mailberichten voor $ 100 per maand bevat, wordt elke e-mail boven de 1000 $ gefactureerd via een aangepaste dimensie.

Wanneer de klant het abonnement op 6 januari koopt en activeert, worden de 1000 e-mailberichten die zijn opgenomen in het vaste tarief, meegeteld vanaf deze dag. Dus als tot 5 februari (einde van de eerste maand van het abonnement) slechts 900 e-mailberichten worden verzonden, betaalt de klant het vaste tarief alleen voor de eerste maand van dit abonnement en worden er tussen 6 en 5 februari geen overschrijdingsgebeurtenissen verzonden door de uitgever. Op 6 februari wordt het abonnement automatisch verlengd en wordt het aantal opnieuw gestart. Als de klant op 15 februari 1000 e-mailberichten heeft ontvangen, worden de rest van de e-mailberichten die tot 5 maart zijn verzonden, in rekening gebracht als overschrijding ($ 1 per e-mail) op basis van de overschrijdingsgebeurtenissen die door de uitgever worden verzonden.