SAP ISH_READ_NKTR Function Module for IS-H: Read Insurance Provider Data from IP File NKTR (Opt. Buffered)









ISH_READ_NKTR is a standard ish read nktr SAP function module available within SAP R/3 or S/4 Hana systems, depending on your version and release level. It is used for IS-H: Read Insurance Provider Data from IP File NKTR (Opt. Buffered) processing and below is the pattern details for this FM, 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 ish read nktr FM, simply by entering the name ISH_READ_NKTR into the relevant SAP transaction such as SE37 or SE38.

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



Function ISH_READ_NKTR 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 'ISH_READ_NKTR'"IS-H: Read Insurance Provider Data from IP File NKTR (Opt. Buffered)
  EXPORTING
*  COPY_PARMS_OF_KTART = ' ' "Transfer Insurance Provider Type Parameters
*  SS_SEARCH_FALNR =  "IS-H: Case Number
*  SS_SEARCH_VAL_QUARTER =  "IS-H: Validity Quarter Start Date
*  SS_SEARCH_VKNUM =  "IS-H: Healthcare Smart Card - Health Insurer Number
*  SS_SEARCH_UNTGR =  "IS-H: Insurance Subgroup
*  I_FALNR =  "IS-H: Case Number
*  I_WITH_COPAY = ' ' "
*  KOSTR =  "Insurance Provider that Should Be Read
*  WITH_NGPA = 'X' "Fill NGPA and NADR: X-yes
*  EINRI =  "Institution (if TN18B Is to Be Read)
*  WITH_TN18B = ' ' "Read Institution-Dependent Parameters
*  SS_BUFFER = 'X' "Buffering (Yes/No)
*  SS_SEARCH_USE =  "IS-H: Business Partner - Relationship
*  SS_SEARCH_EINRI =  "IS-H: Institution for Relationship Search
*  SS_SEARCH_FALAR =  "IS-H: Case Type for Relationship Search

 IMPORTING
   NGPA_E =  "Read Work Area of General Business Partner
   NKTR_E =  "Read Work Area of Insurance Provider
   TN18_E =  "Parameters of Corresponding Insurance Provider Type
   TN18B_E =  "Institution-Dependent Parameters
   NADR_E =  "Address Data of Business Partner
   NEW_REL_FOUND =  "Extended Head Office Determination Successful (YES/NO)
   NKTR_KV_E =  "IS-H: Insurance Provider Structure acc. to Federal PPA from PPA Billing System
   ES_BUPA_HCROLES =  "

TABLES
*  SS_RETURN_TAB =  "Messages of Extended Head Office Determination

EXCEPTIONS
   NGPA_NOT_FOUND = 1    NGPA_NO_AUTHORITY = 2    NOT_FOUND = 3    NO_AUTHORITY = 4    MISSING_INSTITUTION = 5    MISSING_PAR_FOR_COPAY = 6
.




Customer Function user exits

Below is a list of CUSTOMER FUNCTION exit user exits that are available within this program and maybe relevant for this FM.
EXIT_SAPLN003_001 IS-H: Create Name String from Business Partner Data

IMPORTING Parameters details for ISH_READ_NKTR

COPY_PARMS_OF_KTART - Transfer Insurance Provider Type Parameters

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

SS_SEARCH_FALNR - IS-H: Case Number

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

SS_SEARCH_VAL_QUARTER - IS-H: Validity Quarter Start Date

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

SS_SEARCH_VKNUM - IS-H: Healthcare Smart Card - Health Insurer Number

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

SS_SEARCH_UNTGR - IS-H: Insurance Subgroup

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

I_FALNR - IS-H: Case Number

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

I_WITH_COPAY -

Data type: NXFELD
Default: ' '
Optional: Yes
Call by Reference: Yes

KOSTR - Insurance Provider that Should Be Read

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

WITH_NGPA - Fill NGPA and NADR: X-yes

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

EINRI - Institution (if TN18B Is to Be Read)

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

WITH_TN18B - Read Institution-Dependent Parameters

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

SS_BUFFER - Buffering (Yes/No)

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

SS_SEARCH_USE - IS-H: Business Partner - Relationship

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

SS_SEARCH_EINRI - IS-H: Institution for Relationship Search

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

SS_SEARCH_FALAR - IS-H: Case Type for Relationship Search

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

EXPORTING Parameters details for ISH_READ_NKTR

NGPA_E - Read Work Area of General Business Partner

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

NKTR_E - Read Work Area of Insurance Provider

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

TN18_E - Parameters of Corresponding Insurance Provider Type

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

TN18B_E - Institution-Dependent Parameters

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

NADR_E - Address Data of Business Partner

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

NEW_REL_FOUND - Extended Head Office Determination Successful (YES/NO)

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

NKTR_KV_E - IS-H: Insurance Provider Structure acc. to Federal PPA from PPA Billing System

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

ES_BUPA_HCROLES -

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

TABLES Parameters details for ISH_READ_NKTR

SS_RETURN_TAB - Messages of Extended Head Office Determination

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

EXCEPTIONS details

NGPA_NOT_FOUND - General Business Partner Was not Found

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

NGPA_NO_AUTHORITY - No Authorization to Read Business Partner (Planned)

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

NOT_FOUND - Insurance Provider Was not Found

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

NO_AUTHORITY - No Authorization to Read Insurance Provider (Planned)

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

MISSING_INSTITUTION - If a Usage Is Transferred, an Institution Must Be Transferred.

Data type:
Optional: No
Call by Reference: Yes

MISSING_PAR_FOR_COPAY -

Data type:
Optional: No
Call by Reference: Yes

Copy and paste ABAP code example for ISH_READ_NKTR 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_ngpa_e  TYPE NGPA, "   
lt_ss_return_tab  TYPE STANDARD TABLE OF BAPIRET2, "   
lv_ngpa_not_found  TYPE BAPIRET2, "   
lv_copy_parms_of_ktart  TYPE NPDOK-XFELD, "   ' '
lv_ss_search_falnr  TYPE NFAL-FALNR, "   
lv_ss_search_val_quarter  TYPE ISH_VAL_QUARTER_BEGIN, "   
lv_ss_search_vknum  TYPE ISH_VK_KNR, "   
lv_ss_search_untgr  TYPE UNTGR, "   
lv_i_falnr  TYPE FALNR, "   
lv_i_with_copay  TYPE NXFELD, "   ' '
lv_kostr  TYPE NKTR-KOSTR, "   
lv_nktr_e  TYPE NKTR, "   
lv_ngpa_no_authority  TYPE NKTR, "   
lv_tn18_e  TYPE TN18, "   
lv_not_found  TYPE TN18, "   
lv_with_ngpa  TYPE NPDOK-XFELD, "   'X'
lv_einri  TYPE TN01-EINRI, "   
lv_tn18b_e  TYPE TN18B, "   
lv_no_authority  TYPE TN18B, "   
lv_nadr_e  TYPE NADR, "   
lv_with_tn18b  TYPE NPDOK-XFELD, "   ' '
lv_missing_institution  TYPE NPDOK, "   
lv_ss_buffer  TYPE NPDOK-XFELD, "   'X'
lv_new_rel_found  TYPE ISH_ON_OFF, "   
lv_missing_par_for_copay  TYPE ISH_ON_OFF, "   
lv_nktr_kv_e  TYPE ISH_NKTR_KV, "   
lv_ss_search_use  TYPE GPREL, "   
lv_es_bupa_hcroles  TYPE RNBUPA_HCROLES, "   
lv_ss_search_einri  TYPE TN01-EINRI, "   
lv_ss_search_falar  TYPE NFAL-FALAR. "   

  CALL FUNCTION 'ISH_READ_NKTR'  "IS-H: Read Insurance Provider Data from IP File NKTR (Opt. Buffered)
    EXPORTING
         COPY_PARMS_OF_KTART = lv_copy_parms_of_ktart
         SS_SEARCH_FALNR = lv_ss_search_falnr
         SS_SEARCH_VAL_QUARTER = lv_ss_search_val_quarter
         SS_SEARCH_VKNUM = lv_ss_search_vknum
         SS_SEARCH_UNTGR = lv_ss_search_untgr
         I_FALNR = lv_i_falnr
         I_WITH_COPAY = lv_i_with_copay
         KOSTR = lv_kostr
         WITH_NGPA = lv_with_ngpa
         EINRI = lv_einri
         WITH_TN18B = lv_with_tn18b
         SS_BUFFER = lv_ss_buffer
         SS_SEARCH_USE = lv_ss_search_use
         SS_SEARCH_EINRI = lv_ss_search_einri
         SS_SEARCH_FALAR = lv_ss_search_falar
    IMPORTING
         NGPA_E = lv_ngpa_e
         NKTR_E = lv_nktr_e
         TN18_E = lv_tn18_e
         TN18B_E = lv_tn18b_e
         NADR_E = lv_nadr_e
         NEW_REL_FOUND = lv_new_rel_found
         NKTR_KV_E = lv_nktr_kv_e
         ES_BUPA_HCROLES = lv_es_bupa_hcroles
    TABLES
         SS_RETURN_TAB = lt_ss_return_tab
    EXCEPTIONS
        NGPA_NOT_FOUND = 1
        NGPA_NO_AUTHORITY = 2
        NOT_FOUND = 3
        NO_AUTHORITY = 4
        MISSING_INSTITUTION = 5
        MISSING_PAR_FOR_COPAY = 6
. " ISH_READ_NKTR




ABAP code using 7.40 inline data declarations to call FM ISH_READ_NKTR

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.

 
 
 
"SELECT single XFELD FROM NPDOK INTO @DATA(ld_copy_parms_of_ktart).
DATA(ld_copy_parms_of_ktart) = ' '.
 
"SELECT single FALNR FROM NFAL INTO @DATA(ld_ss_search_falnr).
 
 
 
 
 
DATA(ld_i_with_copay) = ' '.
 
"SELECT single KOSTR FROM NKTR INTO @DATA(ld_kostr).
 
 
 
 
 
"SELECT single XFELD FROM NPDOK INTO @DATA(ld_with_ngpa).
DATA(ld_with_ngpa) = 'X'.
 
"SELECT single EINRI FROM TN01 INTO @DATA(ld_einri).
 
 
 
 
"SELECT single XFELD FROM NPDOK INTO @DATA(ld_with_tn18b).
DATA(ld_with_tn18b) = ' '.
 
 
"SELECT single XFELD FROM NPDOK INTO @DATA(ld_ss_buffer).
DATA(ld_ss_buffer) = 'X'.
 
 
 
 
 
 
"SELECT single EINRI FROM TN01 INTO @DATA(ld_ss_search_einri).
 
"SELECT single FALAR FROM NFAL INTO @DATA(ld_ss_search_falar).
 


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!