Ansicht
Dokumentation

FS_API_BPID001_GETLIST - Weitere Partnernummern eines Geschäftspartners lesen

Addresses (Business Address Services)   ABAP Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Der Funktionsbaustein FS_API_BPOID001_GETLIST besorgt für einen Geschäftspartner alle im SAP-System gespeicherten externen Identifikationsnummern. Bei Personen können dies die Führerscheinnummer und die Rentenversichungsnummer sein. Für ein Unternehmen kann der Baustein beispielsweise den Konzernschlüssel und die Mehrwertsteuer-Identnummer ausgeben.

Der Baustein nutzt zwei Arten von Importparametern, um den Geschäftspartner zu identifizieren, für den er die externen Identifikationsnummern zur Verfügung stellen soll. Zum einen kann der Baustein die internen Partneridentifikationen des SAP-Systems, Partnernummer und PartnerGUID, auswerten. Zum anderen kann eine externe Partneridentifikation, also entweder eine externe Identifikationsnummer oder ein externer Identifikationstyp, verwendet werden. Ist der Partner nicht vorhanden oder nicht eindeutig zu identifizieren wird eine Fehlermeldung ausgegeben.

Wird die externe Identifikationsnummer oder der externe Identifikationstyp als Eingangsparameter verwendet, so wird zusätzlich zur Ergebnisliste mit den externen Funktionsnummern die vom Funktionsbaustein aus den Eingangsparametern ermittelte SAP-interne Partnernummer ausgegeben. Damit kann der Verwender dieses Funktionsbausteins feststellen, für welchen Geschäftspartner er letzlich die externen Identifikationsnummern bekommen hat und ob dies der von ihm gewünschte Geschätspartner ist.

Neben der Ergebnisliste der externen Identifikationsnummern und ggf. der internen Partnernummer gibt der Baustein bei Bedarf eine Fehlerliste aus.

Beispiel

Hinweise

Hierachie der Importparameter:

1.,,Externe Identifikationsnummer

2.,,Externer Identifikationstyp

3.,,Interne Partnernummer

4.,,Interne PartnerGUID

Der Baustein durchsucht die Liste der Importparameter in dieser Reihenfolge und gibt die Identifikationsnummern für den ersten Parameter aus, den er findet. Existiert z. B. nur eine interne Partnernummer und eine interne PartnerGUID, so wird die interne Partnernummer ausgewertet, nicht aber die interne Partner GUID.

Der externe Identifikationstyp wird normalerweise eindeutig einem Partner zugeordnet, auch wenn der Begriff "Typ" dies nicht unbedingt vermuten lässt. In diesem Fall wird der Identifikationstyp wie eine Identifikationsnummer behandelt; alle externen Identifikationsnummern werden in die Ausgabeliste gestellt.

Es gibt aber natürlich auch Fälle, wo der Identifikationstyp nicht direkt einem Partner zugeordnet ist, in diesen Fällen wird keine Ausgabeliste erzeugt. Statt dessen wird der Fehler gemeldet, es sei kein eindeutiger Partner vorhanden.

Der Identifikationstyp ist dann eindeutig einem Partner zugeordnet, wenn in der Tabelle TBPID die Felder MULTIPLE und UNEQU initial sind.

Von den Parametern der Steuerungsstruktur IS_GENERAL werden in diesem Baustein nur die Schalter AUTHORITHY und CHANGE_DOCU verwendet. Bei gesetzem Schalter AUTHORITHY wird die Berechtigungsprüfung durchgeführt. Bei gesetzem Schalter CHANGE_DOCU werden Änderungsbelege erstellt.

Weiterführende Informationen

Parameter

ET_BPID001
ET_RETURN
EV_PARTNER
IS_GENERAL
IV_IDNR
IV_IDTYPE
IV_PARTNER
IV_PARTNER_GUID

Ausnahmen

Funktionsgruppe

FS_API

BAL_S_LOG - Application Log: Log header data   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 3773 Date: 20240523 Time: 044226     sap01-206 ( 92 ms )