SAP Function Modules

comments icon Comments

FMCA_RETURN_READ SAP Function module







FMCA_RETURN_READ is a standard SAP function module available within R/3 SAP systems depending on your version and release level. Below is the pattern details for this FM showing its interface including any import and export parameters, exceptions etc as well as any documentation contributions (Comments) specific to the object.

See here to view full function module documentation and code listing, simply by entering the name FMCA_RETURN_READ into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: FMCA_RETURN
Released Date: Not Released
Processing type: Normal fucntion module
Normal function module settings


Pattern for FM FMCA_RETURN_READ - FMCA RETURN READ 





CALL FUNCTION 'FMCA_RETURN_READ' "
* EXPORTING
*   i_return_id =               " scmg_case_guid
*   i_taxpayer =                " gpart_kk      Taxpayer
*   i_reg_id =                  " vtref_kk      Tax Number
*   i_reg_type = SPACE          " subap_kk      Subapplication in Contract Accounts Receivable and Payable
*   i_account =                 " vkont_kk      Contract Account Number
*   i_period_key =              " persl_kk      Key for Period Assignment
*   i_revtype =                 " abtyp_ps      Revenue Type
*   i_formprocess = 'TAX_RETURN'  " formproc_ps  Form-Based Process
*   i_bypass_buffer = SPACE     " xfeld         Ignore Buffer
*   ix_read_duplicate = 'X'     " xfeld
  IMPORTING
    et_return =                 " fmca_return_t  Table Type for Uploading Tax Returns
    et_forms =                  " fmca_forms_t  Table Type for Uploading Tax Forms
    et_notes =                  " fmca_pobj_note_t  Table Type for Notes with Texts and Attributes
    et_formdata =               " fmca_form_field_data_t
    et_messages =               " tsmesg        Message table message collector
    et_status =                 " fmca_pobj_status_t
    et_fpf_his =                " fmca_fpf_his_t_wd
    et_forms_with_data =        " fmca_form_data_t
  EXCEPTIONS
    RETURN_NOT_FOUND = 1        "
    REGISTRATION_NOT_FOUND = 2  "
    FORM_NOT_FOUND = 3          "               Form not found
    INPUT_ERROR = 4             "
    NO_AUTH = 5                 "               Authorization check failed
    RETURN_NOT_UNIQUE = 6       "
    REGISTRATION_NOT_UNIQUE = 7  "
    ERROR_OCCURRED = 8          "
    .  "  FMCA_RETURN_READ

ABAP code example for Function Module FMCA_RETURN_READ





The ABAP code below is a full code listing to execute function module FMCA_RETURN_READ including all data declarations. The code uses 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 original method of declaring data variables up front. 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).

DATA:
ld_et_return    TYPE FMCA_RETURN_T
,
ld_et_forms    TYPE FMCA_FORMS_T
,
ld_et_notes    TYPE FMCA_POBJ_NOTE_T
,
ld_et_formdata    TYPE FMCA_FORM_FIELD_DATA_T
,
ld_et_messages    TYPE TSMESG
,
ld_et_status    TYPE FMCA_POBJ_STATUS_T
,
ld_et_fpf_his    TYPE FMCA_FPF_HIS_T_WD
,
ld_et_forms_with_data    TYPE FMCA_FORM_DATA_T
.




DATA(ld_i_return_id) = 'Check type of data required'.

DATA(ld_i_taxpayer) = 'Check type of data required'.

DATA(ld_i_reg_id) = 'Check type of data required'.

DATA(ld_i_reg_type) = 'Check type of data required'.

DATA(ld_i_account) = 'Check type of data required'.

DATA(ld_i_period_key) = 'Check type of data required'.

DATA(ld_i_revtype) = 'Check type of data required'.

DATA(ld_i_formprocess) = 'Check type of data required'.

DATA(ld_i_bypass_buffer) = 'Check type of data required'.

DATA(ld_ix_read_duplicate) = 'Check type of data required'.
.

CALL FUNCTION 'FMCA_RETURN_READ'
* EXPORTING
*   i_return_id =                ld_i_return_id
*   i_taxpayer =                 ld_i_taxpayer
*   i_reg_id =                   ld_i_reg_id
*   i_reg_type =                 ld_i_reg_type
*   i_account =                  ld_i_account
*   i_period_key =               ld_i_period_key
*   i_revtype =                  ld_i_revtype
*   i_formprocess =              ld_i_formprocess
*   i_bypass_buffer =            ld_i_bypass_buffer
*   ix_read_duplicate =          ld_ix_read_duplicate
  IMPORTING
    et_return =                  ld_et_return
    et_forms =                   ld_et_forms
    et_notes =                   ld_et_notes
    et_formdata =                ld_et_formdata
    et_messages =                ld_et_messages
    et_status =                  ld_et_status
    et_fpf_his =                 ld_et_fpf_his
    et_forms_with_data =         ld_et_forms_with_data
  EXCEPTIONS
    RETURN_NOT_FOUND =           1
    REGISTRATION_NOT_FOUND =     2
    FORM_NOT_FOUND =             3
    INPUT_ERROR =                4
    NO_AUTH =                    5
    RETURN_NOT_UNIQUE =          6
    REGISTRATION_NOT_UNIQUE =    7
    ERROR_OCCURRED =             8
    .  "  FMCA_RETURN_READ

IF SY-SUBRC EQ 0.
  "All OK
ELSEIF SY-SUBRC EQ 1. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 2. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 3. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 4. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 5. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 6. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 7. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 8. "Exception
  "Add code for exception here
ENDIF.







ABAP code to compare 7.40 inline data declaration with original syntax

The below ABAP code uses the older none in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. It may also be useful if you are using an older version of SAP as some of the newer syntax above, such as the @DATA is not available until 4.70 EHP 8.

DATA:


ld_et_return  TYPE FMCA_RETURN_T ,
ld_i_return_id  TYPE SCMG_CASE_GUID ,
ld_et_forms  TYPE FMCA_FORMS_T ,
ld_i_taxpayer  TYPE GPART_KK ,
ld_et_notes  TYPE FMCA_POBJ_NOTE_T ,
ld_i_reg_id  TYPE VTREF_KK ,
ld_et_formdata  TYPE FMCA_FORM_FIELD_DATA_T ,
ld_i_reg_type  TYPE SUBAP_KK ,
ld_i_account  TYPE VKONT_KK ,
ld_et_messages  TYPE TSMESG ,
ld_i_period_key  TYPE PERSL_KK ,
ld_et_status  TYPE FMCA_POBJ_STATUS_T ,
ld_i_revtype  TYPE ABTYP_PS ,
ld_et_fpf_his  TYPE FMCA_FPF_HIS_T_WD ,
ld_i_formprocess  TYPE FORMPROC_PS ,
ld_et_forms_with_data  TYPE FMCA_FORM_DATA_T ,
ld_i_bypass_buffer  TYPE XFELD ,
ld_ix_read_duplicate  TYPE XFELD .




ld_i_return_id = 'Check type of data required'.
ld_i_taxpayer = 'Check type of data required'.
ld_i_reg_id = 'Check type of data required'.
ld_i_reg_type = 'Check type of data required'.
ld_i_account = 'Check type of data required'.
ld_i_period_key = 'Check type of data required'.
ld_i_revtype = 'Check type of data required'.
ld_i_formprocess = 'Check type of data required'.
ld_i_bypass_buffer = 'Check type of data required'.
ld_ix_read_duplicate = 'Check type of data required'.

Contribute (Add Comments)

Please help keep this info upto date and use the comments section below to add useful hints, tips and information specific to this SAP function. This will then be available for you and other users to easily find by simply searching on the object name FMCA_RETURN_READ or its description.


   
 

FMCA_RETURN_READ - 
FMCA_RETURN_POSTING_CTRL - Get Posting Control for Tax Return
FMCA_RETURN_INV_HIS_CHECK - Check if Invoicing History for Tax Return exist
FMCA_RETURN_INV_DOC_CHECK - Check if Invoicing document for Tax Return exist
FMCA_RETURN_GET_FILED_PERIODS - 
FMCA_RETURN_GETLIST -