Währungsobergrenze

Voraussetzungen

• Aktivieren Sie die Auslöser-Handler für die Geldobergrenze.
• Fügen Sie der Account-Datensatzseite die Komponente "Nutzungsverfolgungs-Lightning-Anwendungsgenerator" hinzu, um alle aktiven Geldobergrenzen für den Account eines Teilnehmers anzuzeigen.

Funktionsweise der Währungsobergrenze

Monetary Cap berechnet Ausgabenbeträge für drei Spesen-Buckets:

• Geschätzte Kosten: Der prognostizierte Geldbetrag, der für eine oder mehrere Aktivitäten ausgegeben werden soll.
• Gebundene Ausgaben: Der Geldbetrag, der für eine oder mehrere Aktivitäten genehmigt wurde.
• Tatsächliche Ausgaben: Der Geldbetrag, der bereits für eine oder mehrere Aktivitäten ausgegeben wurde.

Während ein Ereignis ausgeführt wird, verwendet das System die höheren tatsächlichen Ausgaben im Vergleich zur Summe der geschätzten und übernommenen Ausgaben als laufenden Gesamtwert. Nach Abschluss eines Ereignisses berücksichtigt das System nur die tatsächlichen Ausgaben.

Für jeden Teilnehmeraccount ist eine Ausgabenobergrenze in einem Datensatz vom Typ "Obergrenze für Anbieteraktivitätsziele" definiert. Sobald ein Teilnehmer zu einem Ereignis hinzugefügt wird oder eine Ausgabe erstellt, aktualisiert oder gelöscht wird, berechnet das System die Gesamtsumme der Obergrenze automatisch neu und vergleicht sie mit dieser Obergrenze. Nur Ausgaben, deren Typ mit "In Cap enthalten" markiert ist, werden auf die Obergrenze angerechnet.

Wenn eine Obergrenze überschritten wird, reagiert das System je nach Konfiguration der Obergrenze auf eine von zwei Arten:

• Fehler: Die Aktion wird mit einer Fehlermeldung blockiert, die verhindert, dass der Teilnehmer hinzugefügt oder die Kosten erfasst werden.
• Warnung: Die Aktion ist zulässig, es wird jedoch ein Datensatz für die Diskrepanz "Verwalteter Ereignisteilnehmer" mit einer Warnmeldung erstellt.

Berechnung der Gesamtausgaben

Die Gesamtausgaben werden basierend auf dem Status des verwalteten Ereignisses berechnet.

Wenn das verwaltete Ereignis abgeschlossen ist, d. h. der Status einen abgeschlossenen Zustand darstellt, entsprechen die Gesamtausgaben den tatsächlichen Ausgaben.

Summe = Tatsächlich

Wenn das verwaltete Ereignis nicht abgeschlossen ist, d. h. der Status einen Entwurfsstatus darstellt, sind die Gesamtausgaben das Maximum der tatsächlichen Ausgaben und der geschätzten plus der übernommenen Ausgaben.

Summe = MAX(Ist-Wert, geschätzt + übernommen)

Die Cap-Daten werden im Feld mit den zusätzlichen Informationen der Maßeinheit für das Anbieteraktivitätsziel im JSON-Format gespeichert und in den Feldern "Betrag der übernommenen Ausgaben", "Tatsächlicher Ausgabenbetrag", "Geschätzter Ausgabenbetrag" und "Gesamtausgabenbetrag" zusammengefasst.

Der folgende Code ist ein Beispiel für eine Geldobergrenze.

{"1POXJOO0000002L4AU":{"isFinalValue":true,"isFinal":true,"estimatedMap":
{},"estimated":{},"committedMap":{},"committed": {},"actualMap":
{"1Z6XJ0000000iAjOAI":{"rate": 1.0,"amount":200.0},"1Z6XJ00000001970AA":
{"rate":1.0,"amount": 100.0}},"actual":{"1Z6XJ0000000iAjOAI":
{"rate": 1.0,"amount":200.0},"1Z6XJ00000001970AA":
{"rate": 1.0, "amount":100.077}}}}

Die Obergrenze wird erst berechnet, nachdem sich das verwaltete Ereignis in einem endgültigen Zustand befindet, d. h. geschlossen oder abgeschlossen wurde. Der endgültige Status wird anhand des Felds "Status des abgeschlossenen Ereignisses" in den Einstellungen auf Organisationsebene der Ereignisverwaltung bestimmt. Die Umrechnungskurse werden automatisch anhand der Währung aktualisiert.

Auslöser-Handler

• ExpenseParticipantMonetaryCapsHandler
  • Wenn Spesenteilnehmer erstellt werden, berechnet der Handler die Gesamtausgaben neu. Der Handler blockiert die Erstellung von Spesenteilnehmern, wenn die Geldobergrenze mit "Warnungstyp" als "Fehler" eingerichtet ist und die neue Summe die Geldobergrenze überschreitet. Wenn der Benachrichtigungstyp "Warnung" lautet, lässt der Handler die Erstellung eines Spesenteilnehmers zu, jedoch mit einer Warnung, selbst wenn die Obergrenze für Geldwerte überschritten wird. Es werden nur Teilnehmer gezählt, deren Spesenart als "In Cap enthalten" markiert ist.
  • Wenn der Betrag eines Spesenteilnehmers aktualisiert wird, berechnet der Handler die Gesamtsumme der Obergrenzen anhand des neuen Betrags neu. Wenn "Warnungstyp" der Geldobergrenze auf "Fehler" festgelegt ist, blockiert der Handler Erhöhungen, wodurch die Gesamtsumme über die Obergrenze geschoben würde. Wenn der Benachrichtigungstyp "Warnung" lautet, lässt der Handler zu, dass sich der Betrag erhöht, selbst wenn die Geldgrenze überschritten wird. Reduzierungen sind immer uneingeschränkt zulässig – selbst wenn die aktuelle Summe bereits über der Obergrenze liegt –, da sie die Auslastung reduzieren. Änderungen an einem anderen Feld als dem Betrag lösen überhaupt keine Neuberechnung aus.
  • Wenn ein Spesenteilnehmer gelöscht wird, berechnet der Handler die Gesamtsumme neu, um den gelöschten Betrag zu entfernen. Löschungen sind immer zulässig, da das Entfernen eines Teilnehmers immer die Obergrenze reduziert.
• MngEventPartMonetaryCapsHandler
  • Wenn einem Ereignis ein neuer Teilnehmer hinzugefügt wird, überprüft der Handler, ob die Obergrenze für die Ausgaben dieses Anbieters bereits erreicht wurde. Wenn die Geldobergrenze mit "Benachrichtigungstyp" als "Fehler" eingerichtet ist, schränkt der Handler die Addition ein. Wenn für die Geldobergrenze "Warnung" als Warnungstyp festgelegt ist, lässt der Handler dies zu, jedoch mit einer Warnung.
  • Wenn der Teilnehmeraccount geändert wird (Account zu Account, Account zu Experte oder Account zu Experte), berechnet der Handler die Obergrenzen für den alten und den neuen Teilnehmer neu. Wenn ein Account mit einem Benutzer getauscht wird, wird die Geldobergrenze nur für den Account reduziert. Der Wechsel zwischen Nicht-Account-Typen (Benutzer, Kontakt) hat keine Auswirkungen.
• MngEventMonetaryCapsHandler
  • Wenn der Status des verwalteten Ereignisses aktualisiert wird, berechnet der Auslöser-Handler die Obergrenze für alle Teilnehmer neu. Wenn der Status nicht zu den qualifizierenden Status gehört (Entwurf oder geschlossen), entfernt der Handler den Speseneintrag und das Ereignis wird nicht mehr verfolgt.
  • Wenn das Startdatum des verwalteten Ereignisses auf außerhalb des Zeitraums des zugeordneten Aktivitätsplans aktualisiert wird, entfernt der Handler den Speseneintrag. Wenn die Ereignisdatumswerte innerhalb des Aktivitätsplanzeitraums liegen, berechnet der Handler die Ausgaben anhand des neuen Zeitraums neu.
  • Wenn das verwaltete Ereignis gelöscht wird, entfernt der Handler alle zugehörigen Beiträge aus der Obergrenze für die Geldmenge.
• ExpenseMonetaryCapsHandler
  • Wenn das Spesendatum aktualisiert wird, berechnet der Handler die Gesamtsumme der Obergrenzen anhand des neuen Datums neu. Wenn das neue Datum außerhalb eines konfigurierten Zeitfensters liegt, werden die Ausgaben nicht mehr auf die Obergrenze angerechnet.
  • Wenn eines der in der Kriterien-JSON des ProviderActivityMeasureType definierten Steuerfelder aktualisiert wird, die Kriterien jedoch weiterhin erfüllt, berechnet der Handler die Obergrenze neu. Wenn eines der in der Kriterien-JSON des ProviderActivityMeasureType definierten Steuerfelder aktualisiert wird, die Kriterien jedoch nicht erfüllt, entfernt der Handler den Beitrag aus der Obergrenze.
  • Wenn eine Ausgabe gelöscht wird, die als "In Cap enthalten" markiert ist, berechnet der Handler die Ausgabe neu und entfernt den Eintrag der Ausgabe. Nur Ausgaben, deren Typ als "In Cap enthalten" markiert ist, werden gezählt.

Batchaufträge

• Berechnen von Ausgaben anhand von Obergrenzen: Wenn Daten per Massenvorgang hochgeladen werden, werden die Ausgaben durch diesen Batchauftrag anhand der neuesten Accountdaten neu berechnet.
• Freigeben von Anbieteraktivitätszielen anhand des Aktivitätsplantyps: Gibt Anbieteraktivitätsziele, die Aktivitätsplänen vom Typ "Obergrenze für die Ereignisverwaltung" zugeordnet sind, für die Regionen frei, die mit einem Account verknüpft sind. Bei Zielen, die anderen Aktivitätsplantypen zugeordnet sind, werden die Ziele im Auftrag entsprechend der Freigabeeinstellung des Aktivitätsplans freigegeben.

Mobile Offline-Synchronisierung

Monetary Caps verarbeitet Verstöße gegen die Offline-Geldobergrenze auf dem Mobilgerät anders als im Web.

Wenn der Vertriebsmitarbeiter im Web versucht, einen Teilnehmer hinzuzufügen, der die Obergrenzen für die Geldmenge überschritten hat oder die Obergrenze erreicht, blockiert das System die Aktion.

Wenn der Vertriebsmitarbeiter auf dem Mobilgerät dieselbe Aktion offline versucht, blockiert das System die Aktion nicht. Der Teilnehmer wird dem anderen Ereignis erfolgreich hinzugefügt, es wird jedoch ein zugehöriger Datensatz vom Typ "Teilnehmer der verwalteten Veranstaltung" erstellt. Wenn das Mobilgerät mit dem Web synchronisiert wird, werden die Daten für das Hauptsystem freigegeben.