Ansicht
Dokumentation

MSAM10_ORDER_CHANGE - PM/CS: Order Change

MSAM10_ORDER_CHANGE - PM/CS: Order Change

TXBHW - Original Tax Base Amount in Local Currency   rdisp/max_wprun_time - Maximum work process run time  
This documentation is copyright by SAP AG.
SAP E-Book

Short Text

MSAM Order Change

You can use this method to change or update a service or maintenance order. You can change header fields such as reference objects, dates, short text. Additionally you can add operations, operation longtext for newly added operations and maintain user status for header and operations.

Notes

Errors and other messages are incorporated in the RETURN table.

Technical Notes

To change a maintenance or service order, the following parameters are mandatory:

  • ORDER_HEADER-ORDERID

  • ORDER_HEADER-START_DATE

  • ORDER_HEADER_END_DATE

Reference objects must also be provided, blank values will be considered as a change request.

  • To add operations, the following parameters are mandatory:
  • ORDER_OPERATION-ACTIVITY

  • ORDER_OPERATION-CONTROL_KEY

  • ORDER_OPERATION-WORK_CNTR

  • ORDER_OPERATION-PLANT

  • ORDER_OPERATION-ADD_FLAG. This should be marked 'X'.

  • To maintain the longtext, the ORDER_LONGTEXT-OBJTYPE parameter is mandatory
This must have the input values AVOT
  • To maintain the longtext for operation, the parameter ORDER_LONGTEXT-OBJTYPE is mandatory.
  • To maintain user status for order header and order operation, the following parameters are mandatory:
  • ORDER_USER_STATUS-OBJNR

  • ORDER_USER_STATUS-STATUS

Customer Enhancements

The BAPI wrapper customer enhancement concept allows customers to use additional data that was not planned for the interface. The ExtensionIn parameter acts as a data container where the additional values are transferred during import.

In addition to the extension parameters at the interface, there are BAdIs (Business Add-Ins) in the method. These BAdIs can be used to check the data that is transferred to the method by the customer, and perform additional processing activities.

If the ISU is enabled in the backend, then the BAdIs existing in the applicable ISU function module(s) are called for the creation of new meter reading notes, meter reading results, meter installations /replacements /removals, payments and disconnection confirmations.

Available BAdIs:

BADI_EAM_MSAM_ORDER - Customer BAdI for Order Object

Example

Notes

Utilities-related processes can be successfully invoked only if the ISU is enabled in the backend, otherwise the ISU functionally will not be executed.

Special upload-only tables exist for the execution of the Utilities processes. The entries within these tables are considered creation requests and, with the exception of the meter replacement / removal, cannot affect any change on existing data (that is, it is not possible to change or delete any existing meter reading notes, meter reading results, payments, or disconnection confirmations).

ISU Process Table Name
Meter Reading Notes* NOTIF_ISU_MTR_RDNG_NOTE
Meter Reading Results NOTIF_ISU_MR_RESULT
Meter Installations / Replacements / Removals NOTIF_ISU_MTR_REPL
NOTIF_ISU_MTR_REPL_DEVICE
NOTIF_ISU_MTR_REPL_REGISTER
NOTIF_ISU_MTR_REPL_TRANSFORMER
Payments NOTIF_ISU_PAYMENT
Disconnection Confirmations NOTIF_ISU_DISC_CONF

*The meter reading notes also contains any records that were downloaded (but are unchanged).

Further Information

BAdIs available for ISU only:

  • BADI_ISU_MSAM_MR_NOTE - MSAM: ISU Customer BAdI for Meter Reading Note
  • BADI_ISU_MSAM_MR_RESULT,, - MSAM: ISU Customer BAdI for Meter Reading Result
  • BADI_ISU_MSAM_METER_REPL - MSAM: ISU Customer BAdI for Meter Installation / Replacement / Removal
  • BADI_ISU_MSAM_PAYMENT - MSAM: ISU Customer BAdI for Payment
  • BADI_ISU_MSAM_DISC -,,MSAM: ISU Customer BAdI for Disconnection Confirmation

The following parameters of the function module are not supported in the SAP standard functionality:

  • USER
  • ORDER_COMPONENT
  • ORDER_OBJECTLIST
  • ORDER_PARTNER





Parameters

ATTACHMENT
CE_EXTENSION
MSAM10_ORD_MEAS_POINTS
ORDER_COMPONENT
ORDER_DISC_CONF
ORDER_HEADER
ORDER_LONGTEXT
ORDER_METER_REPLACEMENT
ORDER_MR_DEVICE
ORDER_MR_NOTE
ORDER_MR_REGISTER
ORDER_MR_RESULT
ORDER_MR_TRANSFORMER
ORDER_OBJECTLIST
ORDER_OPERATION
ORDER_PARTNER
ORDER_PAYMENT
ORDER_USER_STATUS
RETURN
USER
WSAP_EXTENSION

Exceptions

Function Group

MSAM_MOREP_ORDER

RFUMSV00 - Advance Return for Tax on Sales/Purchases   General Data in Customer Master  
This documentation is copyright by SAP AG.

Length: 6363 Date: 20240604 Time: 060002     sap01-206 ( 53 ms )