Show TOC

Change Based on Utilities Device Smart Meter Cancellation Confirmation as Bulk Locate this document in the navigation structure

 

To receive a confirmation about the cancellation of utilities device smart meter as bulk.

Technical Data

Entity Type

Service Operation

Software Component Version

IS-UT 606

Release State

released

Technical Name

UtilitiesDeviceERPSmartMeterCancellationBulkConfirmation_In

Namespace

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

Application Component

IS-U

Web Service Definition (Back End)

ISU_DEVICESMCNCBLKCO

Category

SAP A2A

Direction

inbound

Mode

asynchronous

Idempotency

not applicable

Change/Update Behavior

not applicable

P2P Communication Enabled

yes

Business Context and Use

The Change Based on Utilities Device Smart Meter Cancellation Confirmation as Bulk service operation is used to return confirmations regarding the successful deletion of devices (smart meters) from an external system, such as a Master Data Unification and Synchronization (MDUS) system.

Features

This inbound service  is used to confirm the cancellation of devices from an advanced metering system (AMS) as a mass process.

The following values will be provided for each object (Utilities device) within this inbound operation:

  • MessageHeader: UUID

  • MessageHeader: ReferenceUUID

  • UtilitiesDeviceID

  • The log, which describes the cancellation status of the device.

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

  • MessageHeader: UUID

  • MessageHeader: ReferenceUUID

  • The log, which describes the status of the cancellation of all devices.

The advanced metering system sends a cancellation confirmation of devices.

Error Handling

Typical errors include:

  • General processing and mapping errors such as missing log

  • MessageHeader: UUID or MessageHeader: ReferenceUUID are not provided

  • UtilitiesDeviceID is initial, missing authorization to receive the inbound confirmation

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

Forward Error Handling

The Change Based on Utilities Device Smart Meter Cancellation Confirmation as Bulk operation supports Forward Error Handling (FEH). The following error categories are used:

  • PRE.AUE: Authorization Error

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

Message Types

  • Utilities Device ERP Smart Meter Cancellation Bulk Confirmation

Notes on SAP Implementation

To use this service operation, the application component Utilities (IS-U) should be implemented and the Utilities business function set must be activated. Users should have an unrestricted 'inbound confirmation' authorization ( EAMI_CO_IN ) in IS-U.

Enhancements

The ISU_SE_DEVICESMCNCBLKRCO_ASYN Business Add-In (BAdI) is available for this operation. This BAdI definition is found in the enhancement spot: ISU_SPOT_SE_DEVICE. This BAdI allows customer-specific logic for inbound mapping of application data. The implementations are sorted according to the field layer of a BAdI implementation, for example, SAP standard, partner, or customer.