ISMT Note 2022_01_3
Document History
Version | Changes | Effective Date |
1.0 | First approved version 3Keys ISMT Add-On Note 2022_01_3 | 18-Jan-2022 |
1. Overview
This document describes changes in the 3Keys ISMT connector ABAP part.
2. Description
Improvements for transaction /K3TMT/SN_INFO:
Error “Please specify Object Selection criteria” appears on press Multiple selection button at selection screen if both fields Object code (EPC) and Object code (EPC) -multiple are empty. Empty control logic for object code is corrected.
Implementation error
Improvements for transaction /K3TMT/REP_MONITOR:
New selection screen fields added: Global Location Number, GLN Extension
New fields added into report header ALV grid: Location name
New function “Change ISMT GUID” added into report item ALV grid toolbar to change report ISMT GUID after data correction process at ISMT system. To use this function report header and item must be in error status and document from ISMT system for old ISMT GUID and new ISMT GUID must be identical.
Allow sum for column SGTIN qty at report header ALV grid
Cancel button change status of confirmed report item due to ABAP code error. Logic corrected to ignore confirmed part.
New feature
Improvements for transaction /K3TMT/RCP_MONITOR:
Translation to language RU for selection screen fields skipped – translations added
Function “Display document summary” and “Download document summary” return different JSON file – error in ABAP code
If Configuration ID field is not specified on selection screen no data is displayed
Implementation error.
DISAGGREGATION_DOCUMENT report is not created for empty SGTIN object. Report creation logic was corrected to allow:
Use SGTIN object at DISAGGREGATION_DOCUMENT report
Empty object allowed for DISAGGREGATION_DOCUMENT report. New parameter NTF_ALLOW_EMPTY_AGGR = X added to allow aggregation with empty parent object.
Change rule customizing via transaction /K3TMT/CUST – change mapper class for report DISAGGREGATION_DOCUMENT to new class /K3TMT/CL_UNPACK_ML_MAPPER
New feature.
Support SGTIN object with existing hierarchy output as KITU with children at LP_INTRODUCE_GOODS report. Report LP_INTRODUCE_GOODS structure corrected to support child objects for KITU.
The following customizing needs to be done:
Add new parameter ITM_AGGR_CHECK_TYPE = 1 via transaction /K3TMT/PARAM. (This parameter defines how system analyzed SGTIN object is parent object for other SGTINs: 1 – GTIN attribute ZRU_AGGR_SGTIN expected; 2 – Check current SGTIN has child object at object hierarchy)
Add new attribute ZRU_AGGR_SGTIN into view /STTP/V_PROPNAME via transaction SM30
Fill GTIN attribute ZRU_AGGR_SGTIN = X for GTINs need to be displayed as KITU
Change rule customizing via transaction /K3TMT/CUST – change mapper class for report LP_INTRODUCE_GOODS to new class /K3TMT/CL_INT_G_ML_MAPPER
New feature.
Rule selection from /K3TMT/CONF transaction works incorrectly for event containing objects with different industries due to ABAP code error.
Implementation error.
Sequence check logic corrected to delete objects from sequence check table after report confirmation from ISMT system.
Implementation error.
Necessary structures and customizing for ISMT report FTS_INTRODUCE_DOCUMENT support added. Mapper class example /K3TMT/CL_FTS_INT_MAPPER added but own class implementation required to fill notification fields correctly. Activate BC set /K3TMT/CUST_ISMT_300_2022_01_03 using transaction SCPR20.
New feature.
Documents with ISMT status “IN_PROGRESS” received from ISMT system with program /K3TMT/UD_IN not updated after first download. New logic added to check and update status until document final status. Documents with creation time from week ago to now processed with this status check logic. This overlap value could be redefined with custom value using transaction /K3TMT/PARAM (parameter name UD_IN_PROCESS_OVERLAP, parameter value – overlap value in seconds).
New feature.
True API version 4 support added but will not be implemented automatically – manual activities are required.
Both connector part corrections required connector cloud part and connector ABAP part.
In order to setup correct service paths for communication with ISMT system using True API for all industries revision 600 you should update customizing via SM30.
Steps:
Start transaction SM30.
Enter view name /STTP/V_RSRVPATH , press Maintain.
Make the following changes for entries with all industries, RU System NTF , System Rev 600, REST operations CREATE_DOCUMENT, ZZGET_CISES_AGG_LIST, ZZGET_CISES_INFO, ZZGET_CIS_INFO, ZZGET_DOCUMENTS, ZZGET_DOCUMENT_INFO, ZZGET_RECEIPT_INFO, ZZGET_RECEIPT_LIST, ZZGET_UTD_INFO
(for more convenience you could press Selection->By contents and enter all needed restrictions:
Industry = FS
RU Reporting System = NTF
AND RU System Revision = 600 )
CREATE_DOCUMENT /api/v3/true-api/lk/documents/create?pg=lp
ZZGET_CISES_AGG_LIST /api/v3/true-api/cises/aggregated/list
ZZGET_CISES_INFO /api/v3/true-api/cises/info
ZZGET_CIS_INFO /api/v3/true-api/cises/list
ZZGET_DOCUMENTS /api/v3/true-api/doc/listV2
ZZGET_DOCUMENT_INFO /api/v3/true-api/documents/{document_id}/info
ZZGET_RECEIPT_INFO /api/v3/true-api/receipt/{receiptId}/info
ZZGET_RECEIPT_LIST /api/v4/true-api/receipt/list
ZZGET_UTD_INFO /api/v3/true-api/documents/edo/tpr/ud
Industry = other value (for example TR)
RU Reporting System = NTF
AND RU System Revision = 600 )
CREATE_DOCUMENT /api/v3/true-api/lk/documents/create?pg=tires
Repeat for other industry by setting create?pg= own value for each industry
New feature
3. Solution
Import related to the transport request.
3.1 Correction instruction ATTP 3.0
Transport request | Description / Dependencies |
D14K900218 | 3Keys ISMT Add-On 3.0 Note 2022_01_03 Required transport D14K900188 |
3.2 Correction instruction ATTP 3.1
Transport request | Description / Dependencies |
D13K900026 | 3Keys ISMT Add-On 3.1 Note 2022_01_03 Required transport D13K900008 |
4. Recommendation
Activate BC set /K3TMT/CUST_ISMT_300_2022_01_03 using transaction SCPR20.
Perform manual activities from True API version 4 support part of description section.
Test corrections from description section
5. Source code objects
Short description | Program | Object type | Object name |
Translation for: Data Element Definition | LANG | DTED | /K3TMT/E_ISMT_RCP_NUMBER |
Translation for: Data Element Definition | LANG | DTED | /K3TMT/E_ISMT_RCP_NUMBER_SHORT |
Translation for: Data Element Definition | LANG | DTED | /K3TMT/E_ISMT_RCP_TYPE |
Translation for: Data Element Definition | LANG | DTED | /K3TMT/E_RCPID |
Translation for: Report Source Code | LANG | REPS | /K3TMT/RCP_MONITOR |
Translation for: Report Texts | LANG | REPT | /K3TMT/RCP_MONITOR |
Class Definition (ABAP Objects) | LIMU | CLSD | /K3TMT/CL_DATA_PRVDR_ISMT |
Class Definition (ABAP Objects) | LIMU | CLSD | /K3TMT/CL_EVT_PROP_LIST_READER |
Class Definition (ABAP Objects) | LIMU | CLSD | /K3TMT/CL_ISMT_STATUS |
Class Definition (ABAP Objects) | LIMU | CLSD | /K3TMT/CL_ISMT_UD |
Class Definition (ABAP Objects) | LIMU | CLSD | /K3TMT/CL_REP_CONST |
Class Definition (ABAP Objects) | LIMU | CLSD | /K3TMT/CL_UI_HELPER |
Protected Header (ABAP Objects) | LIMU | CPRO | /K3TMT/CL_DATA_PRVDR_ISMT |
Protected Header (ABAP Objects) | LIMU | CPRO | /K3TMT/CL_ISMT_STATUS |
Protected Header (ABAP Objects) | LIMU | CPRO | /K3TMT/CL_UI_RCP_MON |
Public Header (ABAP Objects) | LIMU | CPUB | /K3TMT/CL_DATA_PRVDR_ISMT |
Public Header (ABAP Objects) | LIMU | CPUB | /K3TMT/CL_EVT_PROP_LIST_READER |
Public Header (ABAP Objects) | LIMU | CPUB | /K3TMT/CL_ISMT_STATUS |
Public Header (ABAP Objects) | LIMU | CPUB | /K3TMT/CL_ISMT_UD |
Public Header (ABAP Objects) | LIMU | CPUB | /K3TMT/CL_REP_CONST |
Public Header (ABAP Objects) | LIMU | CPUB | /K3TMT/CL_UI_HELPER |
Documentation | LIMU | DOCU | NA/K3TMT/COM308 |
Function Module | LIMU | FUNC | /K3TMT/AIF_RCP_IN_GEN |
Function Module | LIMU | FUNC | /K3TMT/AIF_UD_IN_GEN |
Single Message | LIMU | MESS | /K3TMT/COM308 |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_AIF_REP_PARSER EXTRACT_DATA |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_AIF_REP_PARSER PARSE_INTRODUCE_GOODS |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_AIF_REP_PARSER PARSE_UNPACKING |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_DATA_PRVDR_ISMT CONSTRUCTOR |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_DATA_PRVDR_ISMT DETERMINE_DATA_GTIN |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_DATA_PRVDR_ISMT DETERMINE_SYST_SUBJ_BY_EVENT |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_DATA_PRVDR_ISMT GET_SGTIN_AGGREGATED |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_DATA_PRVDR_ISMT POSTPROCESS_DATA |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_DATA_PRVDR_ISMT POSTPROCESS_DATA_ADD_AGGR |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_DATA_PRVDR_ISMT PROCESS_DATA |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_DATA_PRVDR_ISMT PROCESS_HIERARCHY_OBJ |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_DATA_PRVDR_ISMT ZFILTER_HRY_BY_GTIN |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_DATA_PRVDR_ISMT ZGET_SGTIN_AGGREGATED |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_EVT_PROP_LIST_READERGET_CERT_DOCUMENT |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_EVT_PROP_LIST_READERGET_CERT_DOC_DATE |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_EVT_PROP_LIST_READERGET_CERT_DOC_NUMBER |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_ISMT_REPORT CANCEL |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_ISMT_STATUS GET_STATUS_TEXT |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_ISMT_UD CALC_UD_IN_STATUS |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_PROC_MNGR_ISMT CONSTRUCTOR |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_RULES GET_RULES_CONFIG |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_UI_HELPER GET_GTIN_DATA |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_UI_RCP_MON FIELDCATALOG_HDR |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_UI_RCP_MON ON_DISPLAY_DOC_HEADER |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_UI_RCP_MON ON_DOWNLD_DOC_CONTENT |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_UI_RCP_MON ON_DOWNLD_DOC_HEADER |
Method (ABAP Objects) | LIMU | METH | /K3TMT/CL_UI_RCP_MON REFRESH_HEADER |
Report Source Code | LIMU | REPS | /K3TMT/RESPONSE_C01 |
Report Source Code | LIMU | REPS | /K3TMT/SN_INFO_C01 |
Report Source Code | LIMU | REPS | /K3TMT/SN_INFO_SSC |
Table Definition | LIMU | TABD | /K3TMT/S_ALV_HDR_RCP_MONITOR |
Table Definition | LIMU | TABD | /K3TMT/S_FTS_INT |
Table Definition | LIMU | TABD | /K3TMT/S_FTS_INT_AIF |
Table Definition | LIMU | TABD | /K3TMT/S_FTS_INT_DOC |
Table Definition | LIMU | TABD | /K3TMT/S_FTS_INT_DOCS |
Table Definition | LIMU | TABD | /K3TMT/S_FTS_INT_MSG |
Table Definition | LIMU | TABD | /K3TMT/S_FTS_INT_PRODUCT |
Table Definition | LIMU | TABD | /K3TMT/S_INT_G_PRODUCT |
Table Definition | LIMU | TABD | /K3TMT/S_ISMT_RCP |
Table Type Definition | LIMU | TTYD | /K3TMT/T_FTS_INT_PROD_LIST |
Class (ABAP Objects) | R3TR | CLAS | /K3TMT/CL_FTS_INT_MAPPER |
Class (ABAP Objects) | R3TR | CLAS | /K3TMT/CL_INT_G_ML_MAPPER |
Class (ABAP Objects) | R3TR | CLAS | /K3TMT/CL_RR_RU_PROCESS_ATTR |
Class (ABAP Objects) | R3TR | CLAS | /K3TMT/CL_UNPACK_ML_MAPPER |
Domain | R3TR | DOMA | /K3TMT/D_AGGR_CHK_TYPE |
Data Element | R3TR | DTEL | /K3TMT/E_AGGR_CHK_TYPE |
BC Set or Customizing Profile | R3TR | SCP1 | /K3TMT/CUST_ISMT_300_2022_01_03 |
Table | R3TR | TABL | /K3TMT/S_FTS_INT_PRODUCT2 |
Table | R3TR | TABL | /K3TMT/S_FTS_INT_PRODUCT3 |
Table | R3TR | TABL | /K3TMT/S_INT_G_PRODUCT2 |
Table | R3TR | TABL | /K3TMT/S_INT_G_PRODUCT3 |
Table Type | R3TR | TTYP | /K3TMT/T_FTS_INT_PROD_LIST2 |
Table Type | R3TR | TTYP | /K3TMT/T_FTS_INT_PROD_LIST3 |
Table Type | R3TR | TTYP | /K3TMT/T_INT_G_PRODUCT2 |
Table Type | R3TR | TTYP | /K3TMT/T_INT_G_PRODUCT3 |