Versions Compared

Key

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

...

Version

Changes

Effective Date

1.0

First approved version

3Keys Kazakhstan MPT Connector Add-On release 3.1

1301-JunMay-2022

2.0

Release RN_2023_02

01-May-2023

 

Table of Contents


1.    About This Guide

...

  • Refresh: Refresh shown entries based on selection screen values

  • ALV Grid standard buttons to filter, to sort, to search displayed data, changing layout, printing

  • Cancel: The message header with all related messages will be canceled

  • Approval: The message header with all related messages will be checked for sequence, approved, and send

  • Sequence Check: The log of the sequence check for selected message

  • Change Log: The log of actions and field changes for the selected message

  • Navigate: Menu of functions for the selected message includes:

    • Display events: Navigation to the event in ATTP Cockpit

    • Display business transactions:  Navigation to the business transactions in ATTP Cockpit

    • Display reporting events: Navigation to the reporting event in ATTP Cockpit

  • Reset No response: Reset status “No response” for selected reports to get response again

  • Software Version: Display installed Release and Notes for MPT Connector

The click on GTIN or Lot Number will show Popup with calculated quantities.

...

  • ALV Grid standard buttons to filter, to sort, to search displayed data, changing layout, printing

  • Refresh: Refresh messages related to the selected header

  • MPT Message: Menu of functions for the selected message includes:

    • Display Document Summary JSON: Request document summary JSON online from MPT and display to the user

    • Download Document Summary JSON: Request document summary JSON online from MPT and store as file

    • Display Document Details JSON: Request document details JSON online from MPT and display to the user

    • Download Document Details JSON: Request document details JSON online from MPT and store as file

    • Display Msg XML: Request XML online from MPT and display to the user

    • Download Msg XML: Request XML online from MPT and store as file

    • Reset processing status: Remove processing status to request processing status again from ISMT

    • Repeat message sending: Send message again to MPT

    • Get response now: Get response for report immediately

  • Message AIF: Menu of functions for the selected message includes:

    • Display Message XML: Display AIF message

    • Download Message XML: Download AIF message

    • Message AIF: Show AIF transaction

    • Display processing log: Display application log

  • Special functions: extra functions

    • Update Objects MPT status: Update MPT status for message objects

    • Update token: Request new token from MPT system

3.

...

1.    MPT message processing status

The MPT message processing status defined allowed actions for the message in 3Keys Kazakhstan Connector MPT:

  • 01-init: Outbound message created.

  • 05-missing_data: Message processing stop and waiting of user to maintain the missing message data to generate the reporting

  • 07-wait_approval: Message processing stop and waiting for user approval via transaction /K3TKZ/DOC_MONITOR

  • 10-queued: Message is currently in processing by queue or sequence check failed. Wait until queue is processed or other message will be processed, and sequence check will be successful. The user can manually approve the message and skip the sequence check

  • 15-ready_for_send: Message sequence check performed successfully, and message is waiting for sending

  • 20-sent: Message sent to MPT system and waiting of processing status update

  • 30-confirmed: Message successfully confirmed (end status)

  • 40-error: Message processed with error. Message can be resent again.

  • 45-error_missing_data: ATTP reporting error, message data can be corrected by user with function “Maintain missing data” and resent again

  • 50-recalled: message has been recalled by initiator

  • 85-no_response: MPT response error, maximum number of response error counter exceeded, status can be reset with function “Reset no response” and requested again

  • 99-cancelled: Message is canceled by user (end status)

...

4.    Request Serial number information transaction /K3TKZ/MPT_SN_INFO

The Request Serial Number information transaction /K3TKZ/MPT_SN_INFO is used to request information for serial number from MPT (using True API method through 3Keys Kazakhstan connector MPT).

...

If Checkbox Update MPT status is activated SGTIN status is updated in the DB table /K3TKZ/OBJ_STA

...

5.    Create OMS report program /K3TKZ/OMS_REP

The Create OMS report program /K3TMT/OMS_REP is used to create entries at /K3TMT/REP_MONITOR transaction with type OMS report (91) for created reporting events with type BR_CRYPTO_COMM.

...

If reporting event have objects with status “Applied” and other status program creates header and report entry at transaction /K3TKZ/DOC_MONITOR with type OMS report and status “Error”

...

6. Change MPT document attributes program /K3TKZ/DOC_CHANGE

The Change MPT document attributes program transaction /K3TKZ/DOC_CHANGE is used to correct data /K3TKZ/DOC_MONITOR transaction if necessary.

...

After executing the transaction, for each selected document monitor entry program updates attributes based on selection screen values. Change log entry is created.

7. Upload configuration to SAAS transaction /K3TKZ/MPT_API_SAAS

Transaction /K3TKZ/MPT_API_SAAS is used to configure MPT Connector SAAS part.

Predefined RFC connection to connector with empty Path prefix is required. For example, if you have RFC connection “MPT“ for sending notifications with Path prefix, please create new connection “MPT_API“ with the same credentials without Path prefix.

Available actions:

  • Display certificate information: receive certificate information from connector

  • Upload Certificate: upload file and send certificate file to connector (P12 file is expected)

  • Upload Configuration: upload file and send configuration file to connector (YAML file is expected)

For each action authority check is performed with authorisation object /K3TKZ/001 field /K3TKZ/DAC values 53-Display Certificate, 54-Upload Certificate, 55-Upload Configuration.

8. Test MPT API transaction /K3TKZ/MPT_API_TEST

Transaction /K3TKZ/MPT_API_TEST is used to test MPT API.

Predefined RFC connection to connector with empty Path prefix is required.

Available actions:

  • Health Check: test connector status

  • Display certificate information: receive certificate information from connector

  • API Call: execute API call to MPT system

For each action authority check is performed with authorisation object /K3TKZ/001 field /K3TKZ/DAC values 53-Display Certificate, 56-Call API, 57-Health Check.

9. MPT API Audit Log transaction /K3TKZ/MPT_API_LOG

Transaction /K3TKZ/MPT_API_LOG is used to display MPT API Audit Log.

Authority check is performed on transaction run with authorisation object /K3TKZ/001 field /K3TKZ/DAC value 58-Display MPT API Log.

Transaction has selection screen to search specific entries at MPT API Audit Log database table. To restrict log selection log attributes can be specified.

Result data display with ALV grid. Due to technical reasons value of fields REQUEST, RESPONSE, PATH is shortened on display to get detail information double click is supported. To get full list export file option is available.