Show TOC

 Create Meter Reading Document Result

 

To create a new meter reading document with result or new result for an existing meter reading document.

Technical Data

Entity Type

Service Operation

Software Component Version

IS-UT 606

Release State

released

Technical Name

MeterReadingDocumentERPResultCreateRequest_In

Namespace

http://sap.com/xi/IS-U/Global2

Application Component

IS-U

Web Service Definition (Back End)

ISU_MRDRESULTCRTRQ

Category

SAP A2A

Direction

inbound

Mode

asynchronous

Idempotency

not applicable

Change/Update Behavior

not applicable

P2P Communication Enabled

yes

Business Context and Use

The Create Meter Reading Document Result service operation is used to create a new result for an existing Meter Reading Document or to create a new Meter Reading Document with result. The service corresponds to the upload of meter reading results with BAPI_MTRREADDOC_UPLOAD .

Features

This inbound operation processes the message type MeterReadingDocumentERPResultCreateRequest.

The following values have to be provided:

  • Result->Actual Date and time of the meter reading

  • Result->Meter Reading Result Value

  • Exactly one of the identification variants for creating or finding of meter reading document:

    • Meter Reading Document ID

    • Utilities Measurement Task ID and Utilities Object Identification System Code Text

    • Utilities Device ID and Utilities Object Identification System Code Text

    • Utilities Point Of Delivery Party ID and Utilities Object Identification System Code Text

Error Handling

Typical errors are:

  • Actual time of the meter reading or meter reading result value is not provided.

  • Actual date of the meter reading is initial.

  • The identification variant isn’t provided or is invalid.

Forward Error Handling

The Create Meter Reading Document Result operation supports Forward Error Handling (FEH), from EHP5 onwards. The following error categories are used:

  • PRE.AUE : Authorization Error

  • PRE : Processing Error

  • PRE.TEE.LPE : Lock promotion error

For more information about the individual error categories, see the code list for the global data type LogItemCategoryCode .

To activate FEH, implement and activate BAdI ISU_SE_FEH_EXCEPTION: Set parameter XY_IS_FEH_PROCESSING in method IF_EX_ISU_SE_FEH_EXCEPTION~CHECK_FEH_USAGE to 'X' for the related service specified by the parameters X_SERV_BO_NAME ='MRDOC' and X_SERV_OPERATION = 'MRDRESULTCRTRQ' or set the filter values accordingly.

Information for the Post Processing Office (PPO): This service belongs to the component CA-SOA-ESM-ERP-SCE and process MRDOC002.

Message Types

  • Meter Reading Document ERP Result Create Request

Prerequisites

To use this service operation, the application component Utilities (IS-U) should be implemented.

Notes on SAP Implementation

Switch Framework

The Utilities business function set must be activated.

Configuration

This operation is suitable for the Utilities Industry Solutions sector. To use this operation, customers must run the IS-U application component. Note that users should have the correct authorization to create the meter reading result in IS-U.

Enhancements

The ISU_SE_MRDRESULTCRTRCI_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot: ISU_SPOT_SE_MRD. You can use this BAdI to create a customer-specific logic for the inbound and outbound mapping of application data.