Ansicht
Dokumentation
MSAM10_ORDER_CHANGE - PM/CS: Order Change
TXBHW - Original Tax Base Amount in Local Currency rdisp/max_wprun_time - Maximum work process run timeThis documentation is copyright by SAP AG.
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
ATTACHMENTCE_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_ORDERRFUMSV00 - 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 )