Skip to end of banner
Go to start of banner

Administrator Guide Kazakhstan MPT Connector

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Document History

Version

Changes

Effective Date

1.0

First approved version

3Keys Kazakhstan MPT Add-On release 3.1

01-May-2022

 

1. 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.

2.   Installing and Upgrading

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.

2.1   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)

 

2.2    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

 

3

Installation of 3Keys Kazakhstan MPT Add-On 3.1

4

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

  • /K3TKZ/CUST_MPT_3_1

 

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

 

3.    Maintenance and release strategy

The 3Keys Kazakhstan MPT is following 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 SAP Notes. A cumulated workbench transport with the full 3Keys Kazakhstan MPT Add-On Release Note will be provided 4 times per year (1st Feb, 1st May, 1st Aug, 1st Nov) and includes all changes for the last 3 month.

4.    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) 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.

4.1    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

4.2    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.

4.2.1   Authorization objects for MPT

4.2.1.1   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

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

 

4.2.1.2   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

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

/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

4.2.1.3   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

4.2.2    Further authorizations

4.2.2.1   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.

 

5.    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.

6.    Enhancements of the Solution

Following list of added enhancements:

Enhancement

Description

/K3TKZ/EH_RULE_PROCESSING

Rule processing for MPT Notification

 

 

  • No labels