Administrator Guide Kazakhstan MPT Connector

Owned by Denis Zolotarev
Last updated: Nov 15, 2023 by Pavel Kanskov
8 min read

Document History

Version

Changes

Effective Date

1.0

First approved version

3Keys Kazakhstan MPT Add-On release 3.1

01-May-2022

2.0

Release RN_2024_01

01-Feb-2024

 

About This Guide

This guide is the central starting point for the implementation of the 3Keys Kazakhstan MPT Add-On. It explains how to install, uninstall and implement the 3Keys Kazakhstan MPT Add-On and provides security and operations information. Use the Administrator guide to get an overview of 3Keys Kazakhstan MPT Add-On, its software units, and its scenarios from a technical perspective.

Installation

This section provides information about how to prepare for installation and what to do before and after the installation of 3Keys Kazakhstan MPT Add-On.

ATTP 3.0 (STTP300)

Software Component Matrix

Software Unit

Installation Package

SAP Advanced Track and Trace for Pharmaceuticals 3.0 (STTP300)

SAPK-300AGINSTTP

3Keys Kazakhstan Add-On 3.0

SAPK-300COINK3TKZ

3Keys Kazakhstan MPT Add-On 3.0

SAPK-300COINK3TKZ2

Overall Implementation Sequence

The following table describes the overall installation sequence for the 3Keys Kazakhstan MPT Add-On. This table contains all available software units. However, to implement a specific scenario, you only need a subset of available software units. Some are only required for special processes

Step

Action

Remarks

Step

Action

Remarks

1

Installation of SAP Advanced Track and Trace for Pharmaceuticals 3.0

See SAP Note 2203586

2

Installation of 3Keys Kazakhstan Add-On 3.0 and 3Keys Kazakhstan MPT Add-On 3.0

Import both components with transaction SAINT in client 000

3

Installation all available releases and notes for 3Keys Kazakhstan MPT Add-On 3.0 starting from Release RN_2023_01

https://3keys.atlassian.net/wiki/spaces/kazconnector/pages/1483636772/Kazakhstan+MPT+Releases

Installation Notes only required if the release is not completed in between two releases

4

Activate BC sets offered for 3Keys Kazakhstan Add-On MPT in target client:

  • /K3TKZ/CUST_MPT_3_0

  • /K3TKZ/CUST_MPT_3_0_2022_04_01

  • /K3TKZ/CUST_MPT_3_0_2023_01_02

In case you encounter issues with activation of a BC set please try to activate the BC set multiple times. In most cases the issue will be solved with this.

ATTP 3.1 (STTP300 with support package 01)

Software Component Matrix

Software Unit

Installation Package

SAP Advanced Track and Trace for Pharmaceuticals 3.0 (STTP300) with support package 01

SAPK-300AGINSTTP

SAPK-30001INSTTP

3Keys Kazakhstan Add-On 3.1

SAPK-301COINK3TKZ

3Keys Kazakhstan MPT Add-On 3.1

SAPK-301COINK3TKZ2

Overall Implementation Sequence

The following table describes the overall installation sequence for the 3Keys Kazakhstan MPT Add-On. This table contains all available software units. However, to implement a specific scenario, you only need a subset of available software units. Some are only required for special processes

Step

Action

Remarks

Step

Action

Remarks

1

Installation of SAP Advanced Track and Trace for Pharmaceuticals 3.0 with support package 01

See SAP Note 2203586

2

Installation of 3Keys Kazakhstan Add-On 3.1 and 3Keys Kazakhstan MPT Add-On 3.1

Import both components with transaction SAINT in client 000

3

Installation all available releases and notes for 3Keys Kazakhstan MPT Add-On 3.1 starting from Release RN_2022_03

https://3keys.atlassian.net/wiki/spaces/kazconnector/pages/1483636772/Kazakhstan+MPT+Releases

Installation Notes only required if the release is not completed in between two releases

4

Activate BC sets offered for 3Keys Kazakhstan Add-On MPT in target client:

  • /K3TKZ/CUST_MPT_3_1

  • /K3TKZ/CUST_MPT_3_1_2022_04_01

  • /K3TKZ/CUST_MPT_3_1_2023_01_02

In case you encounter issues with activation of a BC set please try to activate the BC set multiple times. In most cases the issue will be solved with this.

ATTP 3.2 (STTP300 with support package 02)

Software Component Matrix

Software Unit

Installation Package

SAP Advanced Track and Trace for Pharmaceuticals 3.0 (STTP300) with support package 02

SAPK-300AGINSTTP

SAPK-30001INSTTP

SAPK-30002INSTTP

3Keys Kazakhstan Add-On 3.2

SAPK-302COINK3TKZ

3Keys Kazakhstan MPT Add-On 3.2

SAPK-302COINK3TKZ2

Overall Implementation Sequence

The following table describes the overall installation sequence for the 3Keys Kazakhstan MPT Add-On. This table contains all available software units. However, to implement a specific scenario, you only need a subset of available software units. Some are only required for special processes

Step

Action

Remarks

Step

Action

Remarks

1

Installation of SAP Advanced Track and Trace for Pharmaceuticals 3.0 with support package 02

See SAP Note 2203586

2

Installation of 3Keys Kazakhstan Add-On 3.2 and 3Keys Kazakhstan MPT Add-On 3.2

Import both components with transaction SAINT in client 000

3

Installation all available releases and notes for 3Keys Kazakhstan MPT Add-On 3.2 starting from Release RN_2023_01

https://3keys.atlassian.net/wiki/spaces/kazconnector/pages/1483636772/Kazakhstan+MPT+Releases

Installation Notes only required if the release is not completed in between two releases

4

Activate BC sets offered for 3Keys Kazakhstan Add-On MPT in target client:

  • /K3TKZ/CUST_MPT_3_2

  • /K3TKZ/CUST_MPT_3_2_2023_01_02

In case you encounter issues with activation of a BC set please try to activate the BC set multiple times. In most cases the issue will be solved with this.

ATTP 3.3 (STTP300 with support package 03)

Software Component Matrix

Software Unit

Installation Package

SAP Advanced Track and Trace for Pharmaceuticals 3.0 (STTP300) with support package 03

SAPK-300AGINSTTP

SAPK-30001INSTTP

SAPK-30002INSTTP

SAPK-30003INSTTP

3Keys Kazakhstan Add-On 3.3

SAPK-303COINK3TKZ

3Keys Kazakhstan MPT Add-On 3.3

SAPK-303COINK3TKZ2

Overall Implementation Sequence

The following table describes the overall installation sequence for the 3Keys Kazakhstan MPT Add-On. This table contains all available software units. However, to implement a specific scenario, you only need a subset of available software units. Some are only required for special processes

Step

Action

Remarks

Step

Action

Remarks

1

Installation of SAP Advanced Track and Trace for Pharmaceuticals 3.0 with support package 03

See SAP Note 2203586

2

Installation of 3Keys Kazakhstan Add-On 3.3 and 3Keys Kazakhstan MPT Add-On 3.3

Import both components with transaction SAINT in client 000

3

Installation all available releases and notes for 3Keys Kazakhstan MPT Add-On 3.3 starting from Release RN_2024_01

https://3keys.atlassian.net/wiki/spaces/kazconnector/pages/1483636772/Kazakhstan+MPT+Releases

Installation Notes only required if the release is not completed in between two releases

4

Activate BC sets offered for 3Keys Kazakhstan Add-On MPT in target client:

  • /K3TKZ/CUST_MPT_3_3

In case you encounter issues with activation of a BC set please try to activate the BC set multiple times. In most cases the issue will be solved with this.

Maintenance and release strategy

The 3Keys Kazakhstan MPT Add-On follows the release strategy of SAP ATTP. The updates of the 3Keys Kazakhstan MPT Add-On are provided as a zip file that includes a workbench transport and a PDF file, similar to SAP Notes. A cumulated workbench transport is provided four times per year (on February 1st, May 1st, August 1st, and November 1st) and includes all changes for the last three months (Release for Kazakhstan MPT Add-On).

Upgrade

This section provides information about how to prepare for upgrade and what to do before and after the upgrade of 3Keys Kazakhstan MPT Add-On.

The 3Keys Kazakhstan MPT Add-On must be upgraded with each new ATTP release. Each software component version of the 3Keys Kazakhstan MPT Add-On includes all changes required to be compatible with a particular ATTP version and service pack. The 3Keys Kazakhstan MPT Add-On installation package has an overwrite flag active and will overwrite all 3Keys Kazakhstan MPT Add-On objects that currently exist in the ATTP system. The BC-Set contains all required customizing settings and will overwrite customizing that currently exist in the ATTP system.

Security Information

This section deals with security topics relevant for the 3Keys Kazakhstan MPT Add-On. The solution is built on an SAP NetWeaver 750 and the SAP Advanced Track and Trace for Pharmaceuticals 3.0 system. Therefore, the corresponding security settings also apply to 3Keys Kazakhstan MPT Add-On.

Other Required Documents for Security

Resource

Where to Find It

SAP NetWeaver Security Guide

Go to the SAP Help Portal at http://help.sap.com/nw and select the appropriate release. The security guide is in the section Security on the product page.

SAP Advanced Track and Trace for Pharmaceuticals Security Guide

Go to the SAP Help Portal at https://help.sap.com/viewer/product/SAP_ADVANCED_TRACK_AND_TRACE_FOR_PHARMACEUTICALS/3.0 The security guide is in the section Security in the Administrator’s guide

Authorization Concept

This section describes the authorizations available in the 3Keys Kazakhstan MPT Add-On.

The 3Keys Kazakhstan MPT Add-On allows you to make specific authorization settings for all business entities of the solution. The following sections provide information about the authorization concept and the authorization objects used.

In general, authorization checks are executed when searching, displaying, or updating data within the repository system.

Authorization objects for MPT

Authorization objects for MPT Document monitor /K3TKZ/001

This authorization object is used to control all MPT report transaction relevant data based on field action

Authorization Field

Authorization Object Settings

/K3TKZ/DAC - Document action

Assign * if role should be able to perform all actions or assign specific actions

01        Display

02        Cancel button

03        Approval

04        Sequence check

05        Get response

06        Send document

07        Reserved

08       Repeat message sending

09        Reset processing status

10        Maintain missing data

11         Reset no response

12        Get response now

13        Change log

14        Navigate to Cockpit object

15        Change MPT status

16 Change MPT GUID

21        Display document summary JSON

22        Download document summary JSON

23        Display document details JSON

24        Download document details JSON

31        Display AIF report JSON

32        Download AIF report JSON

33        Message AIF

34        Display processing log

35        Display AIF response JSON

36        Download AIF response JSON

37        Software version

41 Display AIF XML

42 Download AIF XML

43 Display MPT XML

44 Download MPT XML

45. Update MPT status

46 Withdraw EDI document

47 Update MPT token

48 Approve EDI document

49 Manual correction

51 Receive inbound

52 Create OMS report

53 Display certificate

54 Upload certificate

55 Upload configuration

56 Call API

57 Health check

58 Display API Log

/K3TKZ/DTP - MPT Document Type

Assign * if role should be able to display all MPT document types or assign specific MPT document types, for example:

0001 IMPORT
0002 KZ_INTRODUCE_GOODS
0003 MTTPS_90
0004 IMPORT_TRANSIT
0005 KZ_UPD
0091 OMS_USAGE

Report / Transaction Authorizations

Authorization checks are run for all transactions or reports with configuration character as follows:

Report

Authorization Object

Authorization Field

Authorization Object Settings

/K3TKZ/MPT_DISPATCHER

/K3TKZ/001

/K3TKZ/DAC

06        Send document

/K3TKZ/MPT_RESPONSE

/K3TKZ/001

/K3TKZ/DAC

05        Response

/K3TKZ/MPT_SN_INFO

/K3TKZ/001

/K3TKZ/DAC

15        Change MPT status

/K3TKZ/DOC_MONITOR

/K3TKZ/001

/K3TKZ/DAC

01        Display

02        Cancel button

03        Approval

04        Sequence check

05        Get response

06        Send document

08       Repeat message sending

09        Reset processing status

10        Maintain missing data

11         Reset no response

12        Get response now

13        Change log

14        Navigate to Cockpit object

21        Display document summary JSON

22        Download document summary JSON

23        Display document details JSON

24        Download document details JSON

31        Display AIF report JSON

32        Download AIF report JSON

33        Message AIF

34        Display processing log

35        Display AIF response JSON

36        Download AIF response JSON

37        Software version

41 Display AIF XML

42 Download AIF XML

43 Display MPT XML

44 Download MPT XML

45 Update MPT status

46 Withdraw EDI document

47 Update MPT token

48 Approve EDI document

/K3TKZ/MPT_DOC_IN

/K3TKZ/001

/K3TKZ/DAC

51 Receive inbound

/K3TKZ/DOC_CHANGE

/K3TKZ/001

/K3TKZ/DAC

49        Manual correction

/K3TKZ/OMS_REP

/K3TKZ/001

/K3TKZ/DAC

52        Create OMS report

/K3TKZ/MPT_API_SAAS

/K3TKZ/001

/K3TKZ/DAC

53 Display certificate

54 Upload certificate

55 Upload configuration

/K3TKZ/MPT_API_TEST

/K3TKZ/001

/K3TKZ/DAC

53 Display certificate

56 Call API

57 Health check

/K3TKZ/MPT_API_LOG

/K3TKZ/001

/K3TKZ/DAC

58        Display API Log

Authorization Object for Interface Processing /AIF/PROC

This authorization object is used to check the user’s authorization for processing a data message to MPT system. For each MPT message a corresponding AIF interface is defined

Authorization Field

Authorization Object Settings

ACTVT - Activity

60        Import

/AIF/NS - Namespace

/STTC3

/AIF/IF - Interface Name

Assign * if role should be able to process all interfaces or assign specific interface

ZKZMPT_004    KZ Message Introduce EAEU 

ZKZMPT_005    KZ Message Act 

ZKZMPT_DOC    KZ MPT Document 

ZKZMPT_I01    KZ Message Inbound Act 

ZKZMPT_I02    KZ Message Inbound Import EAEU 

ZKZMPT_I03    KZ Message Inbound Divergences

ZKZMPT_IMP     KZ Message Import

ZKZMPT_WOF    KZ Message Write Off

/AIF/IFVER - Interface Version

Assign * if role should be able to process all interface versions

Further authorizations

Authorizations for Maintenance Views

In addition to the authorization object, an authorization group has been assigned to each maintenance view / underlying views of view clusters according to the delivery class:

  • Delivery class = E / C: Authorization Group = ATTC

  • Delivery class = A: Authorization Group = ATTO

  • Delivery class = S: No Authorization Group.

Uninstalling

You can use the SAP Add-On Installation Tool to uninstall add-ons. However, the uninstallation is possible only if the following prerequisites are met for individual add-on components:

  • You have imported the latest SAINT update (at least SPAM Version 75).

Procedure:

  • Call the SAP Add-On Installation Tool with the transaction code SAINT in client 000.

  • Choose the "Uninstallable Components" tab and select the add-on component version K3TKZ2 from the list

  • To start the uninstallation process, choose "Start".

  • A confirmation prompt alerts you to possible dangers of the uninstallation and refers to this add-on-specific SAP Note with important information. Be sure to read this SAP Note and follow its instructions.

  • Define the start options.

  • Once you have read this SAP Note and followed its instructions, choose "Continue" to start the uninstallation with the chosen start options. To cancel the uninstallation, choose "Cancel".

  • After you start the uninstall process, the Add-On Installation Tool runs a predefined sequence of phases. Should an error occur in any of these phases, the uninstall process is stopped and the error is described to the extent possible. Once you have corrected the problem, you can choose "Continue" to continue the uninstallation.

  • At first, the Add-On Installation Tool performs preparation steps and check steps. If errors cannot be corrected in these phases, you can choose "Back" to stop and reset the uninstallation. In later phases, if changes and deletions have already been made in the system, a reset is no longer possible, and the system displays a relevant error message. In this case, the errors must be rectified, and the uninstallation must be completed.

  • Following the successful uninstallation of the add-on, you can choose "Logs" to display the implementation logs.

  • To complete the uninstallation, choose "Exit".

  • Repeat the steps above for component version K3TKZ.

Enhancements of the Solution

Following list of added enhancements:

Enhancement

Description

/K3TKZ/EH_RULE_PROCESSING

Rule processing for MPT Notification

 

Â