Die AWS Partner Central API-Referenz wurde neu strukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der AWS Partner Central API-Referenz.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Mit Leistungsanträgen arbeiten

Ein Leistungsantrag modelliert die Anfrage eines Partners nach einer bestimmten Leistung. Darin werden alle Informationen erfasst, die für die Bewertung und Bearbeitung des Antrags gemäß den leistungsspezifischen Bedingungen erforderlich sind. Der Lebenszyklus des Leistungsantrags durchläuft mehrere Phasen, von der Erstellung des Entwurfs bis zur endgültigen Genehmigung oder Ablehnung.

Leistungsanträge erstellen

Partner initiieren den Prozess zur Beantragung von Leistungen, indem sie mithilfe der CreateBenefitApplication API-Aktion einen Leistungsantrag erstellen. Bei der Erstellung geht der Antrag in den PENDING_SUBMISSION Status über, sodass die Partner vollständige Informationen vorbereiten können, bevor sie ihn zur Prüfung einreichen.

Bei der Erstellung eines Leistungsantrags müssen die Partner Folgendes angeben:

Partner können optional Folgendes bereitstellen:

Die CreateBenefitApplication API führt eine sanfte Validierung durch und überprüft nur grundlegende Feldtypen und Muster. Während der Einreichung erfolgt eine vollständige Validierung der Geschäftslogik, sodass Partner unvollständige Anträge speichern und später zurückkehren können, um sie auszufüllen.

Bewährtes Verfahren: Partner sollten das Schema für Leistungsanträge von verwendenGetBenefit, um genau zu verstehen, welche Informationen vor der Erstellung eines Antrags erforderlich sind. Dadurch wird die Wahrscheinlichkeit verringert, dass die Einreichung aufgrund fehlender oder ungültiger Daten fehlschlägt.

Aktualisierung der Leistungsanträge

Partner können Entwürfe von Leistungsanträgen mithilfe der UpdateBenefitApplication API-Aktion ändern. Auf diese Weise können Partner Informationen verfeinern, Unterlagen hinzufügen oder Fehler vor der Einreichung korrigieren.

Bei der Aktualisierung eines Leistungsantrags müssen die Partner Folgendes angeben:

Partner müssen den vollständigen Leistungsantrag einreichen, auch wenn sich nur bestimmte Felder ändern. Es empfiehlt sich, zunächst die neuesten Antragsdetails abzurufenGetBenefitApplication, indem Sie die erforderlichen Felder ändern und dann die vollständige aktualisierte Payload an UpdateBenefitApplication senden.

Optimistisches Sperren: Das Revisionsfeld stellt sicher, dass Aktualisierungen nur angewendet werden, wenn sich die Anwendung seit dem letzten Abruf nicht geändert hat. Wenn die Revision nicht mit dem aktuellen Datenbankwert übereinstimmt, wird das Update mit einem Konfliktfehler abgelehnt. Dadurch wird verhindert, dass Partner versehentlich Änderungen überschreiben, die von anderen Prozessen oder Systemen vorgenommen wurden.

Aktualisierungen können nur durchgeführt werden, solange sich die Anwendung im PENDING_SUBMISSION Status befindet. Sobald die Anträge eingereicht wurden, werden sie geprüft und können nicht mehr über diese API aktualisiert werden.

Ressourcen mit Leistungsanträgen verknüpfen

Partner können mithilfe der AssociateBenefitApplicationResource API-Aktion Leistungsanträge mit verwandten Ressourcen verknüpfen. Dadurch entstehen wertvolle Verbindungen zwischen Leistungen und dem Geschäftskontext, in dem sie genutzt werden.

Unterstützte Ressourcentypen sind u. a.:

Eine Zuordnung der Ressourcen kann nur vor der Einreichung erfolgen. Sobald ein Leistungsantrag eingereicht wurde (der Status ändert sich aufIN_REVIEW), sind keine weiteren Verknüpfungen mehr zulässig. Partner können jedem Leistungsantrag bis zu 10 Ressourcen zuordnen.

Um die Zuordnung einer Ressource aufzuheben, verwenden Partner die DisassociateBenefitApplicationResource API-Aktion. Wie die Zuordnung kann auch die Trennung nur im PENDING_SUBMISSION Status erfolgen.

Einreichung von Leistungsanträgen

Wenn ein Antrag auf Leistungen vollständig und zur AWS Prüfung bereit ist, reichen die Partner ihn über die SubmitBenefitApplication API-Aktion ein. Die Einreichung löst einen Statusübergang von PENDING_SUBMISSION zu aus IN_REVIEW und leitet den leistungsspezifischen Genehmigungsworkflow ein.

Nach der Einreichung führt die API eine umfassende Validierung durch, die Folgendes umfasst:

Schlägt die Überprüfung fehl, gibt die API eine ValidationException mit detaillierten Fehlercodes und Meldungen zurück, die angeben, welche Felder korrigiert werden müssen. Partner müssen diese Probleme mithilfe von Internet lösen, UpdateBenefitApplication bevor sie erneut versuchen, die Daten einzureichen.

Anforderung zur Dateiverarbeitung: Leistungsanträge können nicht eingereicht werden, wenn angehängte Dateien noch im PENDING Status sind. Partner müssen warten, bis die Dateiverarbeitung abgeschlossen ist (der Status ändert sich aufSUCCEEDED), bevor sie sie einreichen. Wenn Dateien nicht verarbeitet werden können (StatusFAILED), sollten Partner die korrigierten Versionen hochladen.

Nach erfolgreicher Einreichung:

Partner können den Fortschritt der Einreichung verfolgen, indem sie den Antrag aufrufen und das Feld Phase überwachen, das die aktuelle Genehmigungsphase angibt (z. B. „Geschäftsgenehmigung“, „Technische Genehmigung“, „Finanzielle Genehmigung“).

Verwaltung der eingereichten Anträge

Nach der Einreichung haben Partner nur begrenzte Möglichkeiten, Leistungsanträge zu verwalten. Die API bietet jedoch spezifische Aktionen für gängige Szenarien.

Rückruf von Leistungsanträgen

Wenn ein Partner nach der Einreichung einen Fehler entdeckt oder Änderungen vornehmen muss, kann er den Antrag mithilfe der RecallBenefitApplication API-Aktion zurückrufen. Durch Rückruf wird der Antrag wieder in den PENDING_SUBMISSION Status versetzt, sodass Aktualisierungen und eine erneute Einreichung möglich sind.

Beim Rückruf einer Bewerbung sollten die Partner Folgendes angeben:

Das Feld „Grund“ ermöglicht eine bessere Rückverfolgbarkeit und hilft dabei, häufig auftretende Probleme zu AWS verstehen, die zu Rückrufen führen, sodass future Verbesserungen des Verfahrens zur Beantragung von Leistungen berücksichtigt werden können.

Nach dem Rückruf können die Partner die erforderlichen UpdateBenefitApplication Änderungen vornehmen und sie dann erneut einreichen, wenn sie bereit sind. SubmitBenefitApplication

Änderung von Leistungsanträgen

Bei geringfügigen Korrekturen nach der Einreichung können Partner die AmendBenefitApplication API-Aktion verwenden, um bestimmte Felder zu aktualisieren, ohne die gesamte Anwendung erneut aufrufen zu müssen. Dies ist besonders nützlich, wenn AWS Gutachter während des Überprüfungsprozesses Klarstellungen oder Korrekturen anfordern.

Änderungsanträge verwenden einen Patch-style JSON-Ansatz, bei dem die Partner Folgendes angeben:

Partner können in einem einzigen API-Aufruf bis zu 10 Änderungen einreichen. Für optimistisches Sperren muss jede Änderung eine aktualisierte Revisionsnummer enthalten.

Änderungsanträge sollten für geringfügige Korrekturen verwendet werden. Bei wesentlichen Änderungen sollten die Partner den Antrag RecallBenefitApplication in den Entwurfsstatus zurückversetzen, um ihn umfassend zu aktualisieren.

Stornierung von Leistungsanträgen

Wenn ein Partner eine Leistung nicht mehr benötigt oder seinen Antrag zurückziehen möchte, kann er ihn mithilfe der CancelBenefitApplication API-Aktion stornieren. Durch die Stornierung wird der Antrag in den CANCELED Status versetzt, wodurch der Bewerbungsprozess dauerhaft beendet wird.

Bei der Stornierung einer Bewerbung sollten die Partner Folgendes angeben:

Einmal stornierte Anwendungen können nicht reaktiviert werden. Wenn der Partner später entscheidet, dass er die Leistung benötigt, muss er einen neuen Leistungsantrag stellen.

Zu den häufigsten Kündigungsgründen gehören:

Einzelheiten zum Leistungsantrag anzeigen

Partner können mithilfe der GetBenefitApplication API-Aktion vollständige Informationen zu einem Leistungsantrag abrufen. Dies bietet einen umfassenden Überblick über die Anwendung, einschließlich:

Metadaten der Anwendung:

Informationen zum Status:

Inhalt der Bewerbung:

Informationen zur Prüfung:

Die Codes für die Statusursache sind besonders nützlich, wenn sich eine Anwendung im ACTION_REQUIRED Status befindet. Diese Codes bieten konkrete, umsetzbare Hinweise darauf, was Partner beachten müssen, damit der Antrag bearbeitet werden kann.

Auflistung von Leistungsanträgen

Partner können mithilfe der ListBenefitApplications API-Aktion alle ihre Leistungsanträge einsehen. Dadurch wird eine paginierte Liste von Anwendungsübersichten mit leistungsstarken Filterfunktionen zurückgegeben.

Partner können Anwendungen nach folgenden Kriterien filtern:

Die Antwort auf die Liste enthält wichtige zusammenfassende Informationen wie:

Partner können die Ergebnissortierung mithilfe des Sortierparameters konfigurieren. Dabei stehen Optionen zur Verfügung, um die Ergebnisse nach Erstellungsdatum, Status, Programm oder Leistungs-ID in aufsteigender oder absteigender Reihenfolge zu sortieren.

Erstellung von Dashboards: Die ListBenefitApplications API wurde entwickelt, um die Erstellung von Partner-Dashboards zu unterstützen. Durch das Filtern und Sortieren von Anwendungen können Partner Ansichten wie die folgenden erstellen: