Ansicht
Dokumentation

BAPI_MTRREADDOC_UPLOAD - Ableseergebnisse hochladen

BAL_S_LOG - Application Log: Log header data   ROGBILLS - Synchronize billing plans  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieses BAPI spielt die in einer der folgenden drei Tabellen übergebenen Ableseergebnisse und entsprechende Zusatzinformationen in IS-U ein:

• METERREADINGRESULTS

• METEREADINGRESCHANGE

• METERREADINGRESUPDATE

Die Beschreibung der einzelnen Tabellenfelder finden Sie in der Dokumentation der Parameter.

Voraussetzung für die Verarbeitung eines hochgeladenen Satzes ist das Vorhandensein eines Zählerstandes oder eines Ablesehinweises.

Um das Hochladen der Ableseergebnisse zu starten, muss einer der drei Parameter gefüllt sein.

Damit unterscheidet man drei Prozesse:

• Erfassen von Ableseergebnissen

Der Parameter bzw. die Tabelle METERREADINGRESULTS enthält die hochgeladenen Sätze der zu erfassenden Ableseergebnisse.

• Ändern von Ableseergebnissen

Der Parameter bzw. die Tabelle METEREADINGRESCHANGE enthält die hochgeladenen Sätze der zu ändernden Ableseergebnisse.

• Aktualisieren von Ableseergebnissen

Der Parameter bzw. die Tabelle METERREADINGRESUPDATE enthält die hochgeladenen Sätze der zu aktualisierenden Ableseergebnisse bzw. der zu erfassenden und zu ändernden Ableseergebnisse.

Erfassen von Ableseergebnissen

Bei der Verarbeitung werden 2 Szenarien unterschieden:

1. Für das hochgeladene Ableseergebnis existiert einentsprechender Ableseauftrag. In diesem Fall erfolgte zuvor ein Download auf ein externes System. Die aus diesem System hochgeladenen Sätze enthalten die interne ID des Ableseauftrags. Die Felder Material, Serialnummer, Zählwerk und Ablesegrund werden nicht beachtet.
2. Für das hochgeladene Ableseergebnis existiert kein Ableseauftrag.

In diesem Fall müssen die Schlüsselfelder einer der folgenden Alternativen zwingend gefüllt sein:

• Serialnummer, Zählwerk, Ablesedatum

Wenn die Serialnummer nicht eindeutig im System ist, so ist zusätzlich die Information des Materials erforderlich.

• Serialnummer, Kennziffer, Ablesedatum

Wenn die Serialnummer nicht eindeutig im System ist, so ist zusätzlich die Materialnummer erforderlich.

• Zählpunkt, Kennziffer, Ablesedatum

Wenn für das hochgeladene Ableseergebnis kein Ableseauftrag existiert, muss in diesem Fall neben den oben definierten Schlüsselfeldern das Feld Ablesezeit(MRTIMEFORBILLING) wie folgt zwingend gefüllt werden: Alle Ableseergebnisse einer Anlage mit dem gleichen Ablesegrund sollen zur gleichen Ablesezeit erfasst werden.

Nur für folgende Ablesegründe ist es möglich, einen Upload ohne vorangegangene Ableseauftragserstellung durchzuführen:

• 01 Turnusablesung

Eine Auftragserstellung für Ablesegrund Turnusist nur möglich, wenn ein entsprechender Terminsatz identifiziert werden kann. Im Customizing der Ablesung können Sie unter Grundeinstellungen-> Steuerungsparameter Ablesedatenbearbeitung festlegen im Feld Karenz zur AblAuftrErst. beim Upload von Turnusergebnissen eine Karenz einstellen, mit der der entsprechende Terminsatz in Abhängigkeit vom Ablesedatum bestimmt werden kann.

Darüber hinaus können Sie beim Upload auch das Sollablesedatum mitgeben. In diesem Fall wird die Karenz nicht berücksichtigt. Es wird direkt auf den entsprechenden Terminsatz zugegriffen.

• 08 Ablesung zum technischen Einbau

Zählerstände zum technischen Einbau können außerhalb der Einbautransaktion hochgeladen werden. Wenn der Einbau anschließend durchgeführt wird, werden diese Zählerstände herangezogen.

• 09 Zwischenablesung ohne Abrechnung

• 13 Ablesung bei Sperrung Anlage

• 18 Wiederinbetriebnahmeablesung

• 19 Anlieferungsablesung

• 02 Zwischenablesung mit Abrechnung

Ändern von Ableseergebnissen

Der hochgeladene Satz ändert die bereits im System bestehenden Ableseergebnisse.

Bei der Verarbeitung werden 2 Szenarien unterschieden:

1. Für das hochgeladene Ableseergebnis existiert ein entsprechender Ablesebeleg mit dem Ableseergebnis. Die hochgeladenen Sätze enthalten die interne ID des Ablesebelegs. Die Felder Material, Serialnummer, Zählwerk, Ablesegrundund Hilfsdatum werden nicht beachtet.
2. Für das hochgeladene Ableseergebnis existiert ein entsprechender Ablesebeleg mit dem Ableseergebnis. Die interne ID des Ablesebelegs ist nicht bekannt und die hochgeladenen Sätze enthalten nicht die interne ID des Ablesebelegs. In diesem Fall müssen die Schlüsselfelder einer der folgenden Alternativen zwingend gefüllt sein, um den zu ändernden Ablesebeleg identifizieren zu können:

• Serialnummer, Zählwerk, Ablesedatum, Hilfsdatum

Wenn die Serialnummer nicht eindeutig im System ist, so ist zusätzlich die Information des Materials erforderlich.

• Serialnummer, Kennziffer, Ablesedatum, Hilfsdatum

Wenn die Serialnummer nicht eindeutig im System ist, so ist zusätzlich die Materialnummer erforderlich.

• Zählpunkt, Kennziffer, Ablesedatum, Hilfsdatum

Das Hilfsdatum für Hintergrundbearbeitung(MRDATEFORIDENTIF) muss für die Identifikation des zu ändernden Ableseergebnisses mitgegeben werden. Dieses Datum entspricht dem Ablesedatum des zu ändernden Ableseergebnisses vor dem Verarbeitungsprozess.

Wenn während des Upload-Prozesses kein zu änderndes Ableseergebnis identifiziert werden kann, werden die Ablesedaten des hochgeladenen Satzes nicht ins System eingespielt.

- Die Ablesezeit darf durch den Upload-Prozess nicht verändert werden.

- Wenn die Ablesedaten für die zu ändernden Einbauablesungen (Ablesegründe 21, 08, 24) nicht über die interne ID des Ablesebelegs hochgeladen werden, muss die Information über den Einbauablesegrund in dem hochgeladenen Satz mitgegeben werden.

Aktualisieren von Ableseergebnissen

Der hochgeladene Satz kann entweder das schon im System bestehende Ableseergebnis ändern oder ein neues Ableseergebnis im System erzeugen bzw. erfassen. Dieser Prozess kann als Kombination aus den beiden vorherigen Prozessen (Erfassen von Ableseergebnissen und Ändern von Ableseergebnissen) betrachtet werden.

Bei der Verarbeitung werden 3 Szenarien unterschieden:

1. Für das hochgeladene Ableseergebnis existiert ein entsprechender Ablesebeleg mit dem Ableseergebnis oder ein entsprechender Ableseauftrag. Die hochgeladenen Sätze enthalten die interne ID des Ablesebelegs. Die Felder Material, Serialnummer, Zählwerk, Ablesegrundund Hilfsdatum werden nicht beachtet. Der hochgeladene Satz ändert das schon im System bestehende Ableseergebnis bzw. erfasst ein Ableseergebnis neu im System.
2. Für das hochgeladene Ableseergebnis existiert ein entsprechender Ablesebeleg mit dem Ableseergebnis. Die interne ID des Ablesebelegs ist nicht bekanntund die hochgeladenen Sätze enthalten nicht die interne ID des Ablesebelegs. In diesem Fall müssen die Schlüsselfelder einer der folgenden Alternativen zwingend gefüllt sein, um den zu ändernden Ablesebeleg identifizieren zu können:

• Serialnummer, Zählwerk, Ablesedatum, Hilfsdatum

Wenn die Serialnumer nicht eindeutig im System ist, so ist zusätzlich die Information des Materials erforderlich.

• Serialnummer, Kennziffer, Ablesedatum, Hilfsdatum

Wenn die Serialnummer nicht eindeutig im System ist, so ist zusätzlich die Materialnummer erforderlich.

• Zählpunkt, Kennziffer, Ablesedatum, Hilfsdatum.

Das Hilfsdatum für Hintergrundbearbeitung(MRDATEFORIDENTIF) muss für die Identifikation des zu ändernden Ableseergebnisses mitgegeben werden. Dieses Datum entspricht dem Ablesedatum des zu ändernden Ableseergebnisses vor dem Verarbeitungsprozess.

- Die Ablesezeit darf durch den Upload-Prozess nicht verändert werden.

- Wenn die Ablesedaten für die zu ändernden Einbauablesungen (Ablesegründe 21, 08, 24) nicht über die interne ID des Ablesebelegs hochgeladen werden, muss die Information über den Einbauablesegrund in dem hochgeladenen Satz mitgegeben werden.

Wenn während des Upload-Prozesses kein zu änderndes Ableseergebnis identifiziert werden kann, wird für das hochgeladene Ableseergebnis ein Ableseauftrag identifiziert bzw. falls noch kein Ableseauftrag vorhanden ist, wird ein Ableseauftrag erzeugt und das Ableseergebnis wird im System erfasst.

1. Für das hochgeladene Ableseergebnis existiert kein Ableseauftrag.

In diesem Fall müssen die Schlüsselfelder einer der folgenden Alternativen zwingend gefüllt sein:

• Serialnummer, Zählwerk, Ablesedatum

Wenn die Serialnummer nicht eindeutig im System ist, so ist zusätzlich die Information des Materials erforderlich.

• Serialnummer, Kennziffer, Ablesedatum

Wenn die Serialnummer nicht eindeutig im System ist, so ist zusätzlich die Materialnummer erforderlich.

• Zählpunkt, Kennziffer, Ablesedatum

Wenn für das hochgeladene Ableseergebnis kein Ableseauftrag existiert, muss in diesem Fall neben den oben definierten Schlüsselfeldern zusätzlich das Feld Ablesezeit (MRTIMEFORBILLING) wie folgend zwingend gefüllt werden: Alle Ableseergebnisse einer Anlage mit dem gleichen Ablesegrund sollen zur gleichen Ablesezeit erfasst werden.

Hochladen von kundeneigenen Feldern

Es besteht die Möglichkeit, kundeneigene Felder hochzuladen (beachten Sie hierzu auch die Kundenerweiterung EDMMR001). Dies erfolgt unter Verwendung der Tabelle EXTENSIONIN. Die kundeneigenen Daten werden nicht zusammen mit den Standarddaten hochgeladen, sondern in einer separaten Tabelle. Diese Tabelle hat den folgenden Aufbau:

• Structure

• Valuepart1 + Valuepart2 + Valuepart3 + Valuepart4

Die Valueparts bestehen aus Strings à 128 Zeichen. Dort sind die Schlüsseldaten und kundeneigenen Daten hinterlegt. Im Feld STRUCTURE muss die Struktur angegeben werden, die über die VALUEPARTS gelegt wird. (Im Fall des BAPI zum Hochladen von Zählerständen gibt es nur ein Segement und damit auch nur eine Struktur.)

Wenn Sie die kurze Materialnummer mit einer maximalen Länge von 18 Zeichen verwenden, handelt sich um die Struktur BAPI_TE_EABL.

Folgende Felder befinden sich in der Struktur BAPI_TE_EABL

• Materialnummer, 18-stellig

• Serialnummer

• Zählwerk

• Ablesegrund

• Ablesedatum

• Ablesebelegnummer

• Kennziffer

• Zählpunktbezeichung

• INCLUDE CI_EABL

Wenn Sie die erweiterte Materialnummer mit einer maximalen Länge von 40 Zeichen verwenden, handelt es sich um die Struktur BAPI_TE_EABL2.

Weitere Informationen zur Materialnummernerweiterung finden Sie im Customizing unter Anwendungsübergreifende Komponenten -> Allgemeine Anwendungsfunktionen --> Feldlängenerweiterung.

Folgende Felder befinden sich in der Struktur BAPI_TE_EABL2:

• Lange Materialnummer, 40-stellig

• Serialnummer

• Zählwerk

• Ablesegrund

• Ablesedatum

• Ablesebelegnummer

• Code zur Identifizierung eines Zählwerks

• Zählpunktbezeichnung

• INCLUDE CI_EABL

Beispiel

Hinweise

Meldungen werden im Parameter RETURN zurückgegeben.

Weiterführende Informationen

Parameter

EDOC_BR_ISU_OSB
EOSBUPLOADDATA
EXTENSIONIN
METEREADINGRESCHANGE
METERREADINGRESULTS
METERREADINGRESUPDATE
RETURN
RETURN_AUX
RETURN_LOG
X_AUTHORITY_MTREAD_CHECK
X_USE_OPEN_LOG

Ausnahmen

Funktionsgruppe

MTRREADDOC

Addresses (Business Address Services)   TXBHW - Original Tax Base Amount in Local Currency  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 16067 Date: 20240523 Time: 163103     sap01-206 ( 216 ms )