Schnittstellen für Verkaufsbelege mit LV

Verwendung

Sie können über die Programmierschnittstellen folgende Verkaufsbelege mit einem Leistungsverzeichnis (LV) austauschen:

  • Kundenanfrage

  • Kundenangebot

  • Kundenauftrag

  • Leistungserfassungsblatt (neuer Prozess)

  • Leistungserfassungsblatt (Gut-/Lastschriftsanforderung)

Ein mögliches Szenario wird in der folgenden Abbildung dargestellt:

Funktionsumfang

Ihnen stehen Funktionsbausteine für den Datenaustausch von Verkaufsbelegen zur Verfügung.

Einige Funktionsbausteine sind als Methoden von Business-Objekttypen für Verkaufsbelege mit einem Leistungsverzeichnis realisiert worden. Diese stehen im Business Object Repository (BOR) der Branchenkomponente Engineering & Construction zur Verfügung.

Hinweis Hinweis

Detaillierte Informationen zu den Business-Objekttypen und deren Methoden finden Sie im BAPI Explorer. Sie können den BAPI Explorer über Anfang des Navigationspfads Werkzeuge Navigationsschritt BusinessFramework Navigationsschritt BAPI Explorer Ende des Navigationspfads aufrufen. Der direkte Aufruf erfolgt über die Transaktion BAPI.

Detaillierte Informationen zu den Funktionsbausteinen finden Sie in der Funktionsbibliothek ( Anfang des Navigationspfads Werkzeuge Navigationsschritt ABAP Ende des Navigationspfads - Anfang des Navigationspfads Workbench Navigationsschritt Entwicklung Navigationsschritt Function Builder Ende des Navigationspfads ).

Ende des Hinweises

Ihnen stehen folgende Schnittstellen zur Verfügung:

  • Create

    Mit Create können Sie einen Verkaufsbeleg mit LV anlegen.

  • Change

    Mit Change können Sie gezielt Daten in einem Verkaufsbeleg mit Leistungsverzeichnis ändern.

  • GetDetail

    Mit GetDetail können Sie Daten zu einem Beleg anzeigen. Der Beleg wird über einen Schlüssel identifiziert. Anschließend werden die Daten an das aufrufende Programm zurückgegeben.

  • GetList

    Mit GetList können Sie eine Liste aller im System gesicherten Belege aufrufen (wahlweise eingeschränkt nach bestimmten Suchkriterien). Anschließend werden die Daten zu den Belegen an das aufrufende Programm zurückgegeben. Es werden keine Leistungsdaten übergeben.

  • GetDetailedList

    Mit GetDetailedList können Sie eine Liste mit Belegen erzeugen (wahlweise eingeschränkt nach bestimmten Suchkriterien). Anschließend werden die Daten zu den Belegen an das aufrufende Programm zurückgegeben. Dabei werden auch Leistungsdaten übergeben.

Kundenanfrage mit LV

Die folgenden Methoden lösen die bisher verwendeten Funktionsbausteine ab:

Business-Objekttyp

Aktuelle Methode (BAPI)

Nicht mehr zu verwendender, ursprünglicher Funktionsbaustein

CustomerInquiryBos

CustomerInquiryBos.CreateBos

BS01_INQUIRY_CREATE

CustomerInquiryBos.GetDetailBos

BS01_INQUIRY_GETDETAIL

Kundenangebot mit LV

Die folgenden Methoden lösen die bisher verwendeten Funktionsbausteine ab:

Business-Objekttyp

Aktuelle Methode (BAPI)

Nicht mehr zu verwendender, ursprünglicher Funktionsbaustein

CustomerQuotationBos

CustomerQuotationBos.CreateBos

BS01_QUOTATION_CREATE

CustomerQuotationBos.ChangeBos

BS01_QUOTATION_CHANGE

CustomerQuotationBos.GetDetailBos

BS01_QUOTATION_ GETDETAIL

Folgender Funktionsbaustein steht neben den oben genannten Methoden für das Kundenangebot weiterhin zur Verfügung:

BS01_QUOTATION_GETDETAILEDLIST

Kundenauftrag mit LV

Die folgenden Methoden lösen die bisher verwendeten Funktionsbausteine ab:

Business-Objekttyp

Aktuelle Methode (BAPI)

Nicht mehr zu verwendender, ursprünglicher Funktionsbaustein

SalesOrderBos

SalesOrderBos.CreateBos

BS01_SALESORDER_CREATE

SalesOrderBos.GetDetailBos

BS01_SALESORDER_ GETDETAIL

SalesOrderBos.GetListBos

BS01_ SALESORDER_ GETLIST

Erfassungsblatt

Die folgenden Methoden lösen die bisher verwendeten Funktionsbausteine ab:

Business-Objekttyp

Aktuelle Methode (BAPI)

Nicht mehr zu verwendender, ursprünglicher Funktionsbaustein

DebitMemoRequestBos

DebitMemoRequestBos.CreateBos

BS01_CDMEMOREQUEST_CREATE

DebitMemoRequestBos.GetDetailBos

BS01_CDMEMOREQUEST_ GETDETAIL

DDIC-Strukturen

Die Anwenderdaten werden in Form von Datensätzen ausgetauscht, deren Strukturen im Data Dictionary (DDIC) abgelegt sind.

DDIC-Struktur (Auswahl)

Bedeutung

BAPIVBELN

Verkaufsbelegnummer

BAPISDHD1

Kopfdaten des Verkaufsbeleges

BAPIRET2

Rückgabemeldung

BAPISDITM

Positionsdaten des Verkaufsbeleges

BAPISCHDL

Einteilungsdaten

BAPIPARNR

Partnerrollen für den Belegkopf oder die SD-Position

BAPIESLLC

Daten einer Leistungs-/Gliederungszeile (außer Langtext)

BAPIESLLTX

Langtexte für Leistungszeile/Gliederungsstufe

BAPIPAREX

Kundenerweiterung Import

BAPIBOSCD

Konditionen zur Leistungszeile

BAPIBOSCOST

Kalkulationsposition der Leistungszeile

BAPIBOSCOSTMODEL

Kalkulationsmodell der Leistungszeile

BAPIBOSCOSTMODEL_CHARA_VALUE

Kalkulationsmodellmerkmal der Leistungszeile

SAP-Datenmodell

Die SAP-Datensätze sind entsprechend dem SAP-Datenmodell verknüpft.

Die folgende Tabelle führt die wichtigsten Zuordnungsregeln für die Datensätze auf:

Zuordnung Datensätze

Realisiert mit Feldern

Positionsdaten des Verkaufsbelegs - Leistungsgliederung

SERVICE_NO - PCK_NO

Leistungsgliederung - Leistungszeile

SUBPCK_NO - PCK_NO

Hierarchiestufe - Gliederungsstufe

HI_LINENO - LINE_NO

Datenträgerformat
  • Die Datei ist sequentiell organisiert.

  • Die Datensätze liegen im ASCII-Format vor.

  • Die Datenträger-Satzlänge beträgt 78 Byte.

  • Jeder Datenträger-Datensatz endet mit dem Abschlusszeichen >.

  • Datensätze mit einer Länge von mehr als 78 Zeichen werden auf mehrere Datenträger-Datensätze aufgeteilt. Das Fortsetzungszeichen ist >.

Somit ergibt sich folgende Datensatzbeschreibung:

Symbol

Inhalt

1

Satzart oder Fortsetzungszeichen

2-77

Anwenderdaten

78

Abschlusszeichen