Interfejsy API rozliczeń taryfowych w witrynie Marketplace — Często zadawane pytania

Najlepiej, aby co godzinę emitować użycie co godzinę, tylko wtedy, gdy w ciągu poprzedniej godziny występuje użycie.

Nie ma takiego ograniczenia. Emituj tylko użycie w miarę jego wystąpienia. Jeśli na przykład musisz przesłać tylko jedną jednostkę użycia na okres istnienia subskrypcji, możesz to zrobić.

W idealnym przypadku zdarzenie użycia jest emitowane co godzinę dla zdarzeń, które wystąpiły w ciągu ostatniej godziny. Oczekuje się jednak opóźnień. Dozwolone maksymalne opóźnienie wynosi 24 godziny, po upływie którego zdarzenia użycia nie zostaną zaakceptowane. Najlepszym rozwiązaniem jest zebranie godzinowego użycia i emisja to jedno zdarzenie na koniec godziny.

Jeśli na przykład zdarzenie użycia występuje o godzinie 13:00 w ciągu dnia, musisz mieć czas do 13:00 następnego dnia, aby emitować zdarzenie użycia skojarzone z tym zdarzeniem. W przypadku, gdy system emitujący użycie nie działa, można go odzyskać, a następnie wysłać zdarzenie użycia dla interwału godzinowego, w którym wystąpiło użycie bez utraty wierności.

Jeśli po rzeczywistym użyciu minęło 24 godziny, nadal można emitować zużyte jednostki z późniejszymi zdarzeniami użycia. Jednak ta praktyka może zaszkodzić wiarygodności raportów zdarzeń rozliczeniowych dla klienta końcowego. Zalecamy unikanie wysyłania emisji miernika raz dziennie/tydzień/miesiąc. Trudniej będzie zrozumieć rzeczywiste użycie przez klienta oraz rozwiązać problemy lub pytania, które mogą być zgłaszane w odniesieniu do zdarzeń użycia.

Innym powodem wysyłania użycia co godzinę jest uniknięcie sytuacji, w których użytkownik anuluje subskrypcję przed wysłaniem zdarzenia emisji dziennej/tygodniowej/miesięcznej.

Tylko jedno zdarzenie użycia jest akceptowane dla interwału jednogodzinnego. Interwał godziny rozpoczyna się od minuty 0 i kończy się w minutach 59. Jeśli co najmniej jedno zdarzenie użycia jest emitowane przez tę samą godzinę, wszelkie kolejne zdarzenia użycia są porzucane jako duplikaty.

Kwota zryczałtowana nie zostanie naliczona, ale użycie nadwyżkowe będzie.

Tak, można zdefiniować wymiar niestandardowy jako jedną jednostkę jednorazowej płatności i emitować go tylko raz dla każdego klienta.

Tak, można go zaimplementować przy użyciu każdego wymiaru niestandardowego reprezentującego jedną warstwę cenową.

Na przykład firma Contoso chce pobierać 0,5 USD za wiadomość e-mail za pierwsze 1000 wiadomości e-mail, 0,4 USD za wiadomość e-mail z zakresu od 1000 do 5000 USD i 0,2 USD na wiadomość e-mail dla powyżej 5000 wiadomości e-mail. Mogą zdefiniować trzy wymiary niestandardowe, które odpowiadają trzem warstwom cenowym poczty e-mail. Emituj jednostki pierwszego wymiaru tak długo, jak liczba wiadomości e-mail pozostaje poniżej 1000, a następnie jednostki drugiego wymiaru, gdy liczba wiadomości e-mail wynosi od 1000 do 5000, a na koniec jednostki trzeciego wymiaru dla powyżej 5000 wiadomości e-mail.

Jeśli niezależnego dostawcy oprogramowania wysyła miernik niestandardowy i otrzymuje błąd, który mógł zostać spowodowany przez problem po stronie firmy Microsoft (zwykle w przypadku podobnych zdarzeń zostały zaakceptowane wcześniej bez błędu), niezależnego dostawcy oprogramowania powinni czekać i ponowić próbę emisji.

Jeśli błąd będzie się powtarzać, prześlij ponownie miernik niestandardowy o następnej godzinie (akumuluj ilość). Kontynuuj ten proces, dopóki nie zostanie odebrana odpowiedź bez błędu.

Każde zdarzenie użycia emitowane na platformie marketplace nie zostanie zaakceptowane po usunięciu subskrypcji SaaS.

Użycie może być emitowane tylko dla subskrypcji w stanie Subskrybuj (a nie dla subskrypcji w PendingFulfillmentStartstanie , Suspendedlub Unsubscribed ).

Jedynym wyjątkiem jest raportowanie użycia przez czas, który był przed anulowaniem subskrypcji SaaS.

Na przykład klient anulował subskrypcję SaaS dzisiaj o godzinie 15:00. Teraz jest 5 pm, wydawca nadal może emitować użycie przez okres od 18:00 wczoraj do 33:00 dzisiaj dla tej subskrypcji SaaS.

Tak, podczas wywoływania interfejsu API listy subskrypcji GET, ponieważ zawiera listę wszystkich subskrypcji SaaS. Pole stanu w odpowiedzi dla każdej subskrypcji SaaS przechwytuje, czy subskrypcja jest aktywna, czy anulowana.

Zdarzenia nadwyżkowe mogą być emitowane w dowolnym momencie dla istniejącej subskrypcji SaaS w stanie Subskrybowane . Wydawca jest odpowiedzialny za emitowanie zdarzeń użycia na podstawie zasad zdefiniowanych w planie rozliczeniowym. Nadwyżka musi być obliczana na podstawie dat zdefiniowanych w okresie subskrypcji SaaS.

Jeśli na przykład wydawca definiuje plan SaaS zawierający 1000 wiadomości e-mail za 100 USD w miesięcznej stawce płaskiej, każda wiadomość e-mail powyżej 1000 USD jest rozliczana za pośrednictwem wymiaru niestandardowego.

Gdy klient kupuje i aktywuje subskrypcję 6 stycznia, 1000 wiadomości e-mail uwzględnionych w stawce płaskiej będą liczone od tego dnia. Jeśli więc do 5 lutego (koniec pierwszego miesiąca subskrypcji) zostanie wysłanych tylko 900 wiadomości e-mail, klient zapłaci stałą stawkę tylko za pierwszy miesiąc tej subskrypcji, a wydawca nie będzie emitowany przez wydawcę od 6 stycznia do 5 lutego. 6 lutego subskrypcja zostanie automatycznie odnowiona, a liczba zostanie uruchomiona ponownie. Jeśli 15 lutego klient osiągnął 1000 wysłanych wiadomości e-mail, pozostałe wiadomości e-mail wysyłane do 5 marca będą naliczane jako nadwyżka (1 USD na wiadomość e-mail) na podstawie zdarzeń użycia nadwyżkowego emitowanych przez wydawcę.

Następne kroki

• Aby uzyskać więcej informacji, zobacz Marketplace metering service APIs (Interfejsy API usługi pomiaru użytkowania witryny Marketplace).