Show TOC

 Create Meter Reading Document Result as Bulk

 

To create a new Meter Reading Document with results or new results for an existing Meter Reading Document as a mass process.

Technical Data

Entity Type

Service Operation

Software Component Version

IS-UT 606

Release State

released

Technical Name

MeterReadingDocumentERPResultBulkCreateRequest_In

Namespace

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

Application Component

IS-U

Web Service Definition (Back End)

ISU_MRDRESULTCRTBLKRQ

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 as Bulk inbound service operation is used to create new results for existing meter reading documents or to create a new Meter Reading Document with results as a mass process. The service triggers the uploading of Meter Reading Document results in the back-end using BAPI_MTRREADDOC_UPLOAD.

Features

The following values have to be provided for the bulk message:

  • MessageHeader - UUID

The following values have to be provided for each single message within this inbound operation:

  • Result - actual date and actual time of the meter reading

  • Result - meter reading result value

  • Exactly one of the identification variants for the creation or the finding of the 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 meter reading is initial

  • The identification variant is not provided or is invalid

Forward Error Handling

As of EHP5, the Create Meter Reading Document Result as Bulk operation supports Forward Error Handling (FEH). 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 for 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 = 'MRDRESULTCRTBLKRQ' or define the filter values accordingly.

Message Types

  • Meter Reading Document ERP Result Bulk Create Request

Prerequisites

To use this service operation, the Utilities (IS-U) application component 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 results in IS-U.

Enhancements

The ISU_SE_MRDRESULTCRTBLKRCI_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.