How to use BAPIRETURN in a ZBAPI

Question

Hello friends
I have looked at standard BAPI's like 'BAPI_CUSTOMER_GETLIST' where they use BAPIRETURN or BAPIRETURN1 in the export tab to send back the messages.
Can I use BAPIRETURN or BAPIRETURN1 in the ZBAPI that I have created.
If I can use, what are the things that I should be doing, other than defining it in the EXPORT tab in SE37 transaction. Do I need to add some code for it in the SOURCE code, or will it automatically send related messages.
Any feedback will be highly appreciated.
Thanks
Ram

Answer 1

Return parameter
Description
This parameter contains the messages from the method call.
Value range
Type  ID  Number  Message
E    S&     26   Ranges: Value & in field SIGN is invalid. Allowed
values are I, E.
E    S&     27   Ranges: Value & in field OPTION is invalid
(EQ,NE,GT,GE,LE,LT,BT,NB,CP,NP)
E    F2    718   No customers were found for the selection criteria
E    F2    543   No authorization to display general data for
customer accounts
We collect the return messages in that return parameter and create a log and display them in desktop or sent a email or stored them in application server.
Ex :
        CALL FUNCTION 'BAPI_FIXEDASSET_OVRTAKE_CREATE'
          EXPORTING
            key                 = la_key
            testrun             = l_testrun
            generaldata         = la_generaldata
            generaldatax        = la_generaldatax
            inventory           = la_inventory
            inventoryx          = la_inventoryx
            postinginformation  = la_postinginformation
            postinginformationx = la_postinginformationx
            timedependentdata   = la_timedependentdata
            timedependentdatax  = la_timedependentdatax
            allocations         = la_allocations
            allocationsx        = la_allocationsx
            origin              = la_origin
            originx             = la_originx
          IMPORTING
            assetcreated        = la_assetcreated
          TABLES
            depreciationareas   = li_depreciationareas
            depreciationareasx  = li_depreciationareasx
            cumulatedvalues     = li_cumulatedvalues
            postedvalues        = li_postedvalues
            transactions        = li_transactions
            return              = i_return.
IF NOT i_return[] IS INITIAL.
        CLEAR: wa_return,
               wa_error_file,
               l_message.
        LOOP AT i_return INTO wa_return.
          IF wa_return-type   = 'S'.
            wa_error_file-type = wa_return-type.
            g_no_load = g_no_load + 1.
            IF l_testrun <> 'X'.
              CONCATENATE text-009 la_assetcreated-asset
                  INTO l_message.
              CLEAR: la_assetcreated.
              CALL FUNCTION 'BAPI_TRANSACTION_COMMIT'.
            ELSE.
              l_message = text-064.
            ENDIF.
            EXIT.
          ELSE.
            IF l_message IS INITIAL.
              CONCATENATE l_message wa_return-message INTO l_message.
            ELSE.
              CONCATENATE l_message wa_return-message INTO l_message SEPARATED BY ','.
            ENDIF.
          ENDIF.
          CLEAR: wa_return.
        ENDLOOP.
        MOVE-CORRESPONDING wa_input TO wa_error_file.
        IF wa_error_file-type <> 'S'.
          wa_error_file-type = 'E'.
          g_no_failed = g_no_failed + 1.
        ENDIF.
        wa_error_file-mssg1     = l_message.
        APPEND wa_error_file TO p_error_table.
        CLEAR: wa_error_file, l_message.
      ENDIF.
    ELSE.
      g_no_invalid = g_no_invalid + 1.
    ENDIF.