Versions Compared

Old Version 2

changes.mady.by.user Denis Zolotarev

Saved on

compared with

New Version Current

changes.mady.by.user Denis Zolotarev

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Document History

Version

Changes

Effective Date

1.0

First approved version

3Keys Kazakhstan MPT Add-On release 3.1

11

01-

Jun-2022

May-2022

2.0

Release RN_2024_01

01-Feb-2024

3.0

Release RN_2024_04

01-Nov-2024

 

Table of Contents
minLevel1
maxLevel7

...

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

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

MPT Connector Java part (SaaS)

 

...

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

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

of

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

MPT

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

1

 

Hint:

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.

5

Installation of 3Keys MPT Connector Java part (on-premises or SaaS)

connection to Kazakhstan MPT system

 

...

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

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.

ATTP 3.4 (STTP300 with support package 04)

Software Component Matrix

Software Unit

Installation Package

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

SAPK-300AGINSTTP

SAPK-30001INSTTP

SAPK-30002INSTTP

SAPK-30003INSTTP

SAPK-30004INSTTP

3Keys Kazakhstan Add-On 3.4

SAPK-304COINK3TKZ

3Keys Kazakhstan MPT Add-On 3.4

SAPK-304COINK3TKZ2

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

1

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

See SAP Note 2203586

2

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

Import both components with transaction SAINT in client 000

3

Installation all available support packages and notes for 3Keys Kazakhstan MPT Add-On 3.4 starting from Release RN_2024_04

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_4

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 is following Add-On follows the release strategy of SAP ATTP. The updates of the Connector will be provided as workbench transports, after a new SAP ATTP release was published. This is the similar approach as with 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 with the full 3Keys Kazakhstan MPT Add-On Release Note will be provided 4 is provided four times per year (1st Feb, 1st May, 1st Aug, 1st Novon February 1st, May 1st, August 1st, and November 1st) and includes all changes for the last 3 month.

...

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 740 (or higher) 750 and the SAP Advanced Track and Trace for Pharmaceuticals 3.0 system with support package 01. 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.

...

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

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

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

/001

/

K3TKZ/DAC

Selected document types

/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

 

4.2.2    Further authorizations

...

/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:

...

  • 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