Ansicht
Dokumentation

CRM_PROVORDERINT_2: Provider-Auftrags- und -Vertrags-API (neu) ( RELNCRM_7E3_XBILL_PRVAPI )

TXBHW - Original Tax Base Amount in Local Currency   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Kurztext

CRM_PROVORDERINT_2: Provider-Auftrags- und -Vertrags-API (neu)

Verwendung

Ab SAP-Erweiterungspaket 3 für SAP CRM 7.0, Business Function Integration von SAP CC und SAP CI mit dem Provider-Auftrag (CRM_PROVORDERINT_2), steht im Application Programming Interface (API) neben den bereits vorhandenen webbasierten Web Client UIs (Interaction Center, Backoffice) eine zusätzliche Option zur Bearbeitung von Daten für Provider-Aufträge und Provider-Verträge zur Verfügung.

Zum Einsatz kommt diese neue Option vor allem in den folgenden Fällen:

• Bei der Auftragserfassung im vorgelagerten System (externes CRM-System, Mobile Client, SAP Web Channel Experience Management)

• Bei der Migration

• Bei automatischen Vertragsänderungen, wie etwa Erweiterungen

• Bei Massenläufen

Das API bietet Operationen, beispielsweise Methoden mit komplexem Interface, die zur Ausführung ihrer Aufgabe nur einen einzigen Aufruf zulassen. Zum Anlegen eines Verkaufsauftrags werden beispielsweise alle Positionsdetails einschließlich der passenden Konfigurationsdaten oder technischen Ressourcen benötigt.

Folgende Aktionen sind möglich:

• Sie können den Provider-Auftrag anlegen und anschließend auf der Benutzungsoberfläche bearbeiten. Diese Funktion ist auch im IC WebClient und im Backoffice verfügbar.

• Sie können den Provider-Auftrag und den Provider-Vertrag in nur einem Schritt anlegen. Diese Funktion ist auch im IC WebClient und im Backoffice verfügbar.

• Sie können einen Provider-Vertrag ohne einen referenzierten Auftrag anlegen. Sie können mehrere Verträge in nur einem Schritt anlegen.

• Sie können die Verträge ändern.

Wenn Sie Provider-Aufträge und -Verträge anlegen oder ändern möchten, können Sie die folgenden Methoden und RFC-Funktionsbausteine verwenden:

• Anlegen eines Provider-Auftrags und -Vertrags mit referenziertem Auftrag

• Methode: CL_CRM_ISX_PROV_ORDER_API_PRXY=>ORDER_CREATE

• RFC-Funktionsbaustein: CRM_ISX_BTX_API_ORDER_CREATE

• Anlegen eines Provider-Vertrags ohne referenzierten Auftrag

• Methode: CL_CRM_ISX_PROV_ORDER_API_PRXY=>CONTRACT_CREATE

• RFC-Funktionsbaustein: CRM_ISX_BTX_API_CONT_CREATE

• Ändern eines Provider-Vertrags

• Methode: CL_CRM_ISX_PROV_ORDER_API_PRXY=>CONTRACT_CHANGE

• RFC-Funktionsbaustein: CRM_ISX_BTX_API_CONT_CHANGE

Die Importstruktur des APIs enthält die Auftragsdaten, die angelegt oder geändert werden sollen und eine Reihe von Kennzeichen, die steuern, wie der Prozess ausgeführt wird oder ob ein Datenbank-Commit ausgeführt werden soll.

Die Exportstruktur des APIs gibt Informationen über die angelegten oder geänderten Objekte zurück, beispielsweise Belegnummern oder Meldungen, die während der Verarbeitung ausgegeben wurden (Fehlermeldungen usw.).

Hinweis
Eine detaillierte Beschreibung der zu verwendenden Parameter finden Sie in der Dokumentation zu Funktionsbausteinen.

Voraussetzungen

Bevor Sie einen Provider-Verkaufsauftrag oder einen Provider-Vertrag anlegen können, müssen Sie folgende Daten im System bearbeiten:

• Zu verwendende Partnerstammdaten

• Verkaufsorganisation
  Legen Sie eine Verkaufsorganisation mit allen erforderlichen Komponenten an (Verkaufsbüro, Verkäufergruppe, Vertriebsweg, Sparte). Der Partner kann hier eine Standardverkaufsorganisation angegeben haben.

• Geschäftsvorgangsart
  Sie können einen Provider-Auftrag oder -Vertrag anlegen, nachdem Sie eine Geschäftsvorgangsart festgelegt haben.

• Produkt
  Preise müssen für die entsprechende Verkaufsorganisation in regelmäßigen Abständen bearbeitet werden. Im Customizing definieren Sie, wie der Preis ermittelt werden soll. So kann die Preisermittlung beispielsweise anhand des Vertragsbeginns erfolgen.
  Sie nehmen die Customizing-Einstellungen für diese Funktion im Customizing für Customer Relationship Management vor unter Grundfunktionen → Preisfindung → Preisfindung einrichten → Konditionsarten anlegen.
  Wählen Sie eine Konditionsart aus, z.B. „Monatliche Gebühr“, und wählen Sie für das Feld „Zugriffsdatum“ den gewünschten Wert aus. Um die Preise im Zusammenhang mit dem Aktivierungsdatum des Vertrags abzurufen, müssen Sie den Eintrag PRVO_ACTIVATION_TIMESTAMP auswählen.

• Customizing-Einstellungen für die technische Ressource
  Wenn die technische Ressource verwendet werden soll, müssen Sie diese Customizing-Einstellungen vornehmen.

• Änderungsprozess
  Sie müssen die erforderlichen Einstellungen für das Bearbeitungs-Framework für Geschäftsvorgänge (Business Transactions Maintenance Framework, BTMF) vornehmen. Sie müssen den relevanten BTMF-Prozess definieren und implementieren. Über einen vom API verwendbaren Prozess muss sichergestellt sein, dass alle benötigten Eingabedaten vom API-Interface bereitgestellt werden. Hierfür steht eine generische Auswahl von Name-Wert-Paaren zur Verfügung. Auf diese Daten kann mit einem globalen Datencontainer (BTMF-Container) aus dem Prozess heraus zugegriffen werden. Die meisten der von SAP standardmäßig ausgelieferten Prozesse verwenden diesen Container nicht, um Prozessdaten abzurufen. Stattdessen beziehen Sie diese Daten von der Benutzungsoberfläche. Als Ausnahme gilt der Prozess 'CANCEL', der Prozessdaten extrahiert (z.B. den Grund oder das Wunschdatum), um einen laufenden Provider-Vertrag aus dem BTMF-Container abzubrechen.

Einschränkungen

Wenn Sie das Provider-API verwenden, müssen Sie folgende Einschränkungen beachten:

• Mehrstufige Konfigurationen werden nicht unterstützt. Dies bedeutet, dass ein konfigurierbares Produkt nicht ein weiteres konfigurierbares Produkt enthalten darf, das im selben Produktmodell definiert wurde.

• Die Verwendung von Attributspositionen wird anhand der in den Verkaufsdaten für das Produkt verfügbaren Attributsproduktrolle ermittelt. Dies geschieht folgendermaßen:

• Wenn als übergeordnete Position Verkaufspaket gewählt wurde, ist die entsprechende Verwendung Verkaufskomponente ('16').

• Wenn als übergeordnete Position Tarif gewählt wurde und das übergeordnete Objekt konfigurierbar und die Position ein Tarif ist, ist die entsprechende Verwendung Konfiguration ('01'). Ansonsten gilt als Verwendung Abhängige Komponente ('18').

• Wenn kein übergeordnetes Objekt vorhanden ist, bleibt die Verwendung leer.

• Es wird davon ausgegangen, dass mit der Verwendung „Konfiguration“ nur Tarife verwendet werden und kein Tarif als abhängige Komponente genutzt wird.

• Wie auf der Benutzungsoberfläche auch, ist die Partnerfunktion SOLD_TO nur auf Kopfebene verfügbar und kann auf Positionsebene nicht separat überschrieben werden.

Erweiterungsspot: CRM_ISX_BTX_API

Der Erweiterungsspot CRM_ISX_BTX_API wird angelegt, damit Kunden das Verhalten von Feldern festlegen können, die nicht durch die standardmäßige API-Struktur bedient werden. Weitere Informationen finden Sie in der BAdI-Beschreibung.

Auswirkungen auf den Datenbestand

Auswirkungen auf die Datenübernahme

Auswirkungen auf die Systemverwaltung

Auswirkungen auf das Customizing

Weitere Informationen

BAL Application Log Documentation   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 9736 Date: 20240523 Time: 180755     sap01-206 ( 143 ms )