SAP Function BAPI_RESERVATION_CHANGE - BAPI to Change Individual Reservations

Parameter Reference Type Length Default Optional Text
ATPCHECK BAPI2093_ATPCHECK u 1 X BAPI Communication Structure: Reservation ATP Check
RESERVATION BAPI2093_RES_KEY-RESERV_NO N 10 Number of Reservation/Dependent Requirement
TESTRUN BAPI2093_TEST u 1 X BAPI Communication Structure: Reservation Testrun

Parameter Reference Length Optional Text
EXTENSIONIN BAPIPAREX 990 X Reference Structure for BAPI Parameters EXTENSIONIN/EXTENSIONOUT
RESERVATIONITEMS_CHANGED BAPI2093_RES_ITEM_CHANGE 129 BAPI Communication Structure: Change Reservation Item
RESERVATIONITEMS_CHANGEDX BAPI2093_RES_ITEM_CHANGEX 17 BAPI communication structure: reservation item fields
RESERVATIONITEMS_NEW BAPI2093_RES_ITEM_NEW 304 X BAPI communication structure: reservation item fields
RETURN BAPIRET2 548 Return Parameters

Functionality
You can use this BAPI to change reservations.

Example
With this method, you can change individual reservations or add furtheritems to existing reservations.
You can change the following fields in a reservation item:

  • Storage Location (field STGE_LOC)

  • Batch Number (field BATCH)

  • Quantity in Unit of Entry (field ENTRY_QNT)

  • Requirements Date of Component (field REQ_DATE)

  • Item Text (field ITEM_TEXT)

  • Goods Recipient (field GR_RCPT)

  • Unloading Point (field UNLOAD_PT)

  • Set the 'Quantity is fixed' indicator (field FIXED_QUAN)

  • Set the 'Goods movement for reservation allowed' indicator (field
  • MOVEMENT)
    • Set the 'Item is deleted' indicator (field DELETE_IND)

    • Set the 'Final issue for this reservation' indicator (field
    • WITHDRAWN)

      Notes
      The system checks the following authorization objects with activity 02(change):

      • Reservations: Movement type (M_MRES_BWA)

      • Reservations: Plant (M_MRES_WWA)

      • The reservation to be changed must be transferred to the Reservation
        parameter.
        It is not possible to make changes and insertions simultaneously duringone method call. During a call, you can either only change or onlyinsert items.
        The changed reservation items are transferred to parameterRESERVATIONITEMS_CHANGED, and to identify the item to be changed,you must specify the item number (field RES_ITEM).
        You can identify the fields relevant for change by a marker, in otherwords, fields relevant for change are identified in parameterRESERVATIONITEMS_CHANGEDX by a corresponding marker in thecorresponding component:
        • 'X'

        • This value means that the relevant component has a value relevant forchange in the parameter.
          • ' ' (No value)

          • If there is no value, this means that the relevant component of theparameter does not need to be updated.
            The new reservation items to be added are transferred to parameterRESERVATIONITEMS_NEW. Note that; although it is not possible tomake changes and insertions simultaneously, when you add new items youmust still transfer both parameters RESERVATIONITEMS_CHANGED andRESERVATIONITEMS_CHANGEDX.
            The system returns messages in parameter RETURN. In the parameterdocumentation, you will find the return values and their meanings.
            No transaction control is implemented. After this method has been calledsuccessfully and without errors in the RETURN parameter, the caller musttherefore execute the 'Commit Work' (with the help ofBAPI_TRANSACTION_COMMIT) himself.

            Description
            ATP check.

            Value range
            If this parameter is set, an ATP check is executed when you change thereservation.

            Default
            The default value for this parameter is 'blank', in other words, theATP check is not executed.

            Description
            This parameter specifies the reservation to be changed.

            Description
            Test run

            Value range
            If this parameter is set, all necessary checks will run without changingthe reservation.

            Default
            The default value for this parameter is 'blank', in other words, thereservation is changed.

            Description
            Customer enhancements of the import interface.

            Description
            This parameter contains the item data of the reservation to be changed.

            Description
            This parameter contains the selection list of the reservation items tobe changed.

            Description
            This parameter contains the item data of the reservation items to beadded.

            Description
            This table contains the confirmations from the method call.

            Value range
            Type,,ID,,No.,,Message
            E,,M7,,001,,Check table &: Entry & & & does not exist
            E,,M7,,042,,Batch & & & & does not exist
            E,,M7,,061,,Document does not contain items
            S,,M7,,070,,Document & was changed
            E,,M7,,110,,System error during lock
            E,,M7,,112,,User & is blocking reservation &
            E,,M7,,120,,No authorization for this operation in plant &
            E,,M7,,121,,No authorization for this operation with movement type &
            E/W,,M7,,127,,Material & & & was marked for deletion
            W,,M7,,237,,SLoc & for mat. & plant & batch & does not exist
            W,,M7,,238,,SLoc & for mat. & plant & movement type & does not exist
            E,,M7,,292,,SLoc & does not exist
            E/W,,M7,,501,,Next working day is the &
            E,,M7,,503,,No storage location data for & in & &
            E/W,,M7,,505,,Requirements date & is before current date &
            E,,M7,,511,,Referenced reservation was not created manually
            E,,M7,,520,,Reservation & does not exist
            E,,M7,,522,,Reservation created automatically. Manual change not poss.
            E,,M7,,523,,Date & lies after valid factory calendar
            E,,M7,,524,, Date & lies before valid factory calendar
            E,,M7,,525,,Date & cannot be converted (correct it)
            E,,M7,,526,,Missing factory calendar or error in factory calendar &
            E,,M7,,527,,Automatic reservation not permitted as reference
            E/W,,M7,,542,,Of mat. &, only & & available for &.
            S,,M7,,673,,The reservation can be changed
            W,,M7,,674,,Item & of reservation & is deleted
            E,,M7,,675,,Item & does not exist in reservation &
            E,,M7,,678,,Not possible to add and change res. item at same time.