MaterialReservation

The Business Object Material reservation is a request to a plant
to keep ready a quantity of materials at certain points in time.

Structure

The reservation consists of several items that contain the reserved materials.

Available Methods

• CreateFromData : Create reservation [ BAPI_RESERVATION_CREATE ] (Obsolete in 46C)
  
• CreateFromData1 : BAPI to create individual reservations [ BAPI_RESERVATION_CREATE1 ]
  
• Delete : BAPI to delete individual reservations [ BAPI_RESERVATION_DELETE ]
  
• GetDetail : Display reservation [ BAPI_RESERVATION_GETDETAIL ]
  
• GetItems : List reservations [ BAPI_RESERVATION_GETITEMS ]
  

CreateFromData

This method enables you to create reservations.

Notes

The following authorization objects are checked with activity 01 (Create):

The header data of the reservation is passed on in the parameter ReservationHeader. At least the following data is necessary:

The item data is passed on in the table ReservationItems. At least the following data is necessary:

The reservation number is returned in the parameter Reservation.

Messages are returned in the parameter return. The parameterdocumentation shows the return codes and their meanings.

Further Information

The method can only carry out your function if no error messages weregenerated in the "Return" table. This is the case if the header data and all the items were processed successfully.

Transaction control is not implemented. The calling program therefore
has to execute the 'Commit Work' itself after this method has beensuccessfully invoked (i.e. if no errors were reported in the Return parameter).

CreateFromData1

Create reservation

Example

You can use this method to create individual reservations.

Notes

The following authorization objects are checked with the activity 01 (create):

Reservations: movement type

Reservations: plant

The system transfers the header data of the reservation in theReservationHeader parameter. The following data is required for this:

- movement type (Field MOVE_TYPE)

- the account assignment object (for example, the cost center in the
COSTCENTER field) if the movement type requires an account assignment

The system transfers the item data in the ReservationItems table. The following data is required for this:

- plant (PLANT field)

- material number (MATERIAL field)

- requirement date (REQ_DATE field) if no base date ( RES_DATE field) has been entered in the header data

The reservation number is returned in the parameter 'Reservation'.

Messages are returned in the parameter 'Return'. The documentation for
this parameter contains the return values and their meanings.

No transaction control is implemented. The caller therefore has to carry out the 'Commit Work' (for example, using theBAPI_TRANSACTION_COMMIT) after this method has been called up successfully; that is, if no errors were displayed in the parameter
Return'.

Delete

Delete reservation

Example

You can use this method to delete individual reservations.

Notes

The system checks the following authorization objects with the activity 06 (delete):

- M_MRES_BWA Reservations: movement type

- M_MRES_WWA Reservations: plant

The number of the reservation that is to be deleted must be transferred in the RESERVATION parameter

The TESTRUN parameter can also be set. This has the effect that thesystem carries out all the checks but without creating the reservation.

Messages are returned in the parameter 'Return'. The documentation forthis parameter contains the return values and their meanings.

Further Information

The method can only carry out its function if no error messages were created in the parameter 'Return'.

No transaction control is implemented. The caller therefore has to carry out the 'Commit Work' (for example, using theBAPI_TRANSACTION_COMMIT) after this method has been called up successfully; that is, if no errors were displayed in the parameter'Return'.

GetDetail

This method enables you to list detailed data pertaining to a reservation.

Notes

The following authorization objects are checked with activity 03 (Display):

The header and item data for the reservation number that is passed on is returned in the tables ReservationHeader and ReservationItems respectively.

Messages are returned in the parameter return. The parameter
documentation shows the return codes and their meanings.

Further Information

The method can only carry out your function if no error messages weregenerated in the "Return" table. This is the case if the header data and all the items were processed successfully.

Transaction control is not implemented. The calling program thereforehas to execute the 'Commit Work' itself after this method has beensuccessfully invoked (i.e. if no errors were reported in the Return parameter).

GetItems

This method allows you to list reservations. You pass on the desiredselection criteria (e.g. requirement date, plant, goods recipient) inthe import parameters. For further information, refer to the relevant parameter documentation.

Notes

The following authorization objects are checked with the activity 03 (Display):

If errors occur during processing and the reservation cannot be saved, the relevant error messages are returned in the table
Return. Information messages are also logged in this table.

Further Information

The method can only carry out your function if no error messages weregenerated in the "Return" table. This is the case if the header data and all the items were processed successfully.

Transaction control is not implemented. The calling program thereforehas to execute the 'Commit Work' itself after this method has beensuccessfully invoked (i.e. if no errors were reported in the Return parameter).