SAP FMCA_RETURN_UPDATE Function Module for









FMCA_RETURN_UPDATE is a standard fmca return update SAP function module available within SAP R/3 or S/4 Hana systems, depending on your version and release level. It is used to perform a specific ABAP function and below is the pattern details, showing its interface including any import and export parameters, exceptions etc. there is also a full "cut and paste" ABAP pattern code example, along with implementation ABAP coding, documentation and contribution comments specific to this or related objects.


See here to view full function module documentation and code listing for fmca return update FM, simply by entering the name FMCA_RETURN_UPDATE into the relevant SAP transaction such as SE37 or SE38.

Function Group: FMCA_RETURN
Program Name: SAPLFMCA_RETURN
Main Program: SAPLFMCA_RETURN
Appliation area:
Release date: N/A
Mode(Normal, Remote etc): Normal Function Module
Update:



Function FMCA_RETURN_UPDATE pattern details

In-order to call this FM within your sap programs, simply using the below ABAP pattern details to trigger the function call...or see the full ABAP code listing at the end of this article. You can simply cut and paste this code into your ABAP progrom as it is, including variable declarations.
CALL FUNCTION 'FMCA_RETURN_UPDATE'"
EXPORTING
IT_RETURNS = "Table Type for Uploading Tax Returns
* IX_STATUS_UPD_OLNY = ' ' "Checkbox
* IT_FORMS = "Table Type for Uploading Tax Forms
* IT_FORMDATA = "Table type for form field data
* IT_NOTES = "Table Type for Notes with Texts and Attributes
* IT_STATUSES = "Table Type for Change to Object Status
* I_COMMIT = 'X' "
* I_CALLER = 'FMCA_WDY_RETURN' "Current Transaction Code
* IV_ONLY_STATUS = ' ' "
* IX_AUTHORITY_CHECK = ' ' "Checkbox

IMPORTING
ET_MESSAGES = "OBSOLETE
ET_RETURN_GUIDS = "
ET_FMCA_FORM_BUNDLE_ID = "
ES_FMCA_FORM_BUNDLE_ID = "

EXCEPTIONS
RETURN_NOT_FOUND = 1 POBJ_UPDATE_ERROR = 10 STATUS_UPDATE_ERROR = 11 INPUT_INVALID = 12 STATUS_NOT_ALLOWED = 13 STATUS_ACTIVITY_NOT_ALLOWED = 14 NO_AUTHORIZATION = 15 FORM_NOT_FOUND = 2 NOTE_NOT_FOUND = 3 RETURN_UPDATE_ERROR = 4 FORM_UPDATE_ERROR = 5 NOTE_UPDATE_ERROR = 6 POBJ_CREATION_FAILED = 7 XML_ERROR = 8 CONTAINER_ERROR = 9
.



IMPORTING Parameters details for FMCA_RETURN_UPDATE

IT_RETURNS - Table Type for Uploading Tax Returns

Data type: FMCA_RETURN_T
Optional: No
Call by Reference: No ( called with pass by value option)

IX_STATUS_UPD_OLNY - Checkbox

Data type: XFELD
Default: SPACE
Optional: Yes
Call by Reference: Yes

IT_FORMS - Table Type for Uploading Tax Forms

Data type: FMCA_FORMS_T
Optional: Yes
Call by Reference: No ( called with pass by value option)

IT_FORMDATA - Table type for form field data

Data type: FMCA_FORM_FIELD_DATA_T
Optional: Yes
Call by Reference: No ( called with pass by value option)

IT_NOTES - Table Type for Notes with Texts and Attributes

Data type: FMCA_POBJ_NOTE_T
Optional: Yes
Call by Reference: Yes

IT_STATUSES - Table Type for Change to Object Status

Data type: FMCA_STATUS_CHANGE_T
Optional: Yes
Call by Reference: Yes

I_COMMIT -

Data type: XFELD
Default: 'X'
Optional: No
Call by Reference: No ( called with pass by value option)

I_CALLER - Current Transaction Code

Data type: SY-TCODE
Default: 'FMCA_WDY_RETURN'
Optional: No
Call by Reference: Yes

IV_ONLY_STATUS -

Data type: XFELD
Default: SPACE
Optional: Yes
Call by Reference: Yes

IX_AUTHORITY_CHECK - Checkbox

Data type: XFELD
Default: SPACE
Optional: Yes
Call by Reference: Yes

EXPORTING Parameters details for FMCA_RETURN_UPDATE

ET_MESSAGES - OBSOLETE

Data type: BAPIRET2_T
Optional: No
Call by Reference: No ( called with pass by value option)

ET_RETURN_GUIDS -

Data type: FMCA_RETURN_GUID_T
Optional: No
Call by Reference: No ( called with pass by value option)

ET_FMCA_FORM_BUNDLE_ID -

Data type: FMCA_FORM_BUNDLE_ID_TAB
Optional: No
Call by Reference: No ( called with pass by value option)

ES_FMCA_FORM_BUNDLE_ID -

Data type: FMCA_FORM_BUNDLE_ID
Optional: No
Call by Reference: Yes

EXCEPTIONS details

RETURN_NOT_FOUND -

Data type:
Optional: No
Call by Reference: Yes

POBJ_UPDATE_ERROR -

Data type:
Optional: No
Call by Reference: Yes

STATUS_UPDATE_ERROR - Error When Changing the Status

Data type:
Optional: No
Call by Reference: Yes

INPUT_INVALID -

Data type:
Optional: No
Call by Reference: Yes

STATUS_NOT_ALLOWED -

Data type:
Optional: No
Call by Reference: Yes

STATUS_ACTIVITY_NOT_ALLOWED -

Data type:
Optional: No
Call by Reference: Yes

NO_AUTHORIZATION -

Data type:
Optional: No
Call by Reference: Yes

FORM_NOT_FOUND - Form not found

Data type:
Optional: No
Call by Reference: Yes

NOTE_NOT_FOUND -

Data type:
Optional: No
Call by Reference: Yes

RETURN_UPDATE_ERROR -

Data type:
Optional: No
Call by Reference: Yes

FORM_UPDATE_ERROR -

Data type:
Optional: No
Call by Reference: Yes

NOTE_UPDATE_ERROR -

Data type:
Optional: No
Call by Reference: Yes

POBJ_CREATION_FAILED -

Data type:
Optional: No
Call by Reference: Yes

XML_ERROR -

Data type:
Optional: No
Call by Reference: Yes

CONTAINER_ERROR -

Data type:
Optional: No
Call by Reference: Yes

Copy and paste ABAP code example for FMCA_RETURN_UPDATE Function Module

The ABAP code below is a full code listing to execute function module POPUP_TO_CONFIRM including all data declarations. The code uses the original data declarations rather than the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the newer method of declaring data variables on the fly. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8), which i why i have stuck to the origianl for this example.

DATA:
lv_it_returns  TYPE FMCA_RETURN_T, "   
lv_et_messages  TYPE BAPIRET2_T, "   
lv_return_not_found  TYPE BAPIRET2_T, "   
lv_pobj_update_error  TYPE BAPIRET2_T, "   
lv_ix_status_upd_olny  TYPE XFELD, "   SPACE
lv_status_update_error  TYPE XFELD, "   
lv_input_invalid  TYPE XFELD, "   
lv_status_not_allowed  TYPE XFELD, "   
lv_status_activity_not_allowed  TYPE XFELD, "   
lv_no_authorization  TYPE XFELD, "   
lv_it_forms  TYPE FMCA_FORMS_T, "   
lv_form_not_found  TYPE FMCA_FORMS_T, "   
lv_et_return_guids  TYPE FMCA_RETURN_GUID_T, "   
lv_it_formdata  TYPE FMCA_FORM_FIELD_DATA_T, "   
lv_note_not_found  TYPE FMCA_FORM_FIELD_DATA_T, "   
lv_et_fmca_form_bundle_id  TYPE FMCA_FORM_BUNDLE_ID_TAB, "   
lv_it_notes  TYPE FMCA_POBJ_NOTE_T, "   
lv_return_update_error  TYPE FMCA_POBJ_NOTE_T, "   
lv_es_fmca_form_bundle_id  TYPE FMCA_FORM_BUNDLE_ID, "   
lv_it_statuses  TYPE FMCA_STATUS_CHANGE_T, "   
lv_form_update_error  TYPE FMCA_STATUS_CHANGE_T, "   
lv_i_commit  TYPE XFELD, "   'X'
lv_note_update_error  TYPE XFELD, "   
lv_i_caller  TYPE SY-TCODE, "   'FMCA_WDY_RETURN'
lv_pobj_creation_failed  TYPE SY, "   
lv_xml_error  TYPE SY, "   
lv_iv_only_status  TYPE XFELD, "   SPACE
lv_container_error  TYPE XFELD, "   
lv_ix_authority_check  TYPE XFELD. "   SPACE

  CALL FUNCTION 'FMCA_RETURN_UPDATE'  "
    EXPORTING
         IT_RETURNS = lv_it_returns
         IX_STATUS_UPD_OLNY = lv_ix_status_upd_olny
         IT_FORMS = lv_it_forms
         IT_FORMDATA = lv_it_formdata
         IT_NOTES = lv_it_notes
         IT_STATUSES = lv_it_statuses
         I_COMMIT = lv_i_commit
         I_CALLER = lv_i_caller
         IV_ONLY_STATUS = lv_iv_only_status
         IX_AUTHORITY_CHECK = lv_ix_authority_check
    IMPORTING
         ET_MESSAGES = lv_et_messages
         ET_RETURN_GUIDS = lv_et_return_guids
         ET_FMCA_FORM_BUNDLE_ID = lv_et_fmca_form_bundle_id
         ES_FMCA_FORM_BUNDLE_ID = lv_es_fmca_form_bundle_id
    EXCEPTIONS
        RETURN_NOT_FOUND = 1
        POBJ_UPDATE_ERROR = 10
        STATUS_UPDATE_ERROR = 11
        INPUT_INVALID = 12
        STATUS_NOT_ALLOWED = 13
        STATUS_ACTIVITY_NOT_ALLOWED = 14
        NO_AUTHORIZATION = 15
        FORM_NOT_FOUND = 2
        NOTE_NOT_FOUND = 3
        RETURN_UPDATE_ERROR = 4
        FORM_UPDATE_ERROR = 5
        NOTE_UPDATE_ERROR = 6
        POBJ_CREATION_FAILED = 7
        XML_ERROR = 8
        CONTAINER_ERROR = 9
. " FMCA_RETURN_UPDATE




ABAP code using 7.40 inline data declarations to call FM FMCA_RETURN_UPDATE

The below ABAP code uses the newer in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. Please note some of the newer syntax below, such as the @DATA is not available until 4.70 EHP 8.

 
 
 
 
DATA(ld_ix_status_upd_olny) = ' '.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
DATA(ld_i_commit) = 'X'.
 
 
"SELECT single TCODE FROM SY INTO @DATA(ld_i_caller).
DATA(ld_i_caller) = 'FMCA_WDY_RETURN'.
 
 
 
DATA(ld_iv_only_status) = ' '.
 
 
DATA(ld_ix_authority_check) = ' '.
 


Search for further information about these or an SAP related objects



Comments on this SAP object

What made you want to lookup this SAP object? Please tell us what you were looking for and anything you would like to be included on this page!