Document History

About This Guide

This document describes configuration steps that are required, or are optionally possible, to configure 3Keys Kazakhstan EDO CEDM in SAP ATTP system.

Solution overview

SAP ATTP delivers a solution to generate the reporting messages for Kazakhstan EDO CEDM system. The 3Keys Kazakhstan EDO CEDM Add-On automate the communication and message generation/transfer to Kazakhstan EDO CEDM system, visualize the message processing status with monitoring transaction.

Solution scope

In 3Keys Kazakhstan EDOCEDM, the following notifications are supported:

 The list of supported rule types (notifications) is planned to be enhanced in future 3Keys Kazakhstan EDO CEDM releases. Also, you can enhance supported notification by adding custom rule types (See enhancement section).

Constraints, Assumptions, Prerequisites and Dependencies

The Kazakhstan reporting part for EDO CEDM is configured in SAP ATTP.

Setting up the Solution

Connection to Java part

The connector Java part as SaaS solution supports HTTPS communication using web services.

...

The corporate firewall, proxy, gateway, etc. should allow outbound HTTPS connection from ATTP or middleware system to the Connector Java part.

Prerequisites

For setting up an online integration to a Kazakhstan reporting system via EDO CEDM connector Java part, do the following:

·       Create an HTTP Destination to EDO CEDM connector.

·       Create a System (master data).

·       Maintain settings.

Create an HTTP Destination to

...

CEDM connector

To create an HTTP connection to the external server, do the following:

...

Create a new destination as follows:RFC Destination: Maintain a name for the destination (for example EDOCEDM)

• Connection Type: G – HTTP Connection to External Server

• Description: Maintain a description for the destination (for example EDO CEDM via 3Keys Kazakhstan connector)

...

• For example, the URL: https://[URL provided by 3Keys support]/app/edo/api results into:

  • Target Host: [URL provided by 3Keys support] (or server name in case on-premise installation)

  • Service No.: 443

  • Path Prefix: /app/edo/api

Set the HTTP Proxy Options as required in your organizations network

...

• Basic Authentication: true

• Input User and password for EDO CEDM Connector

• Do Not Send Logon Ticket: true

• SSL: active, Anonymous

...

Create the second RFC destination identical to created destination without path prefix (to test True API methods). Maintain a name for the destination (for example EDO CEDM_API).

Create a system for

...

CEDM

To create a system, do the following:

• Call transaction /STTP/COCKPIT

• Navigate to Master Data > Systems and then Choose Display/Edit.

• Choose Create. A popup is displayed. 

• In the popup, define a system name and use following parameters: 

  • System name (for example KAZ_EDOCEDM)

  • System Type: F - Foreign Reporting System

  • Communication Type: 0 – Not Specified

  • RFC Destination: Maintain the destination name created in SM59 with path /app/edo/api

Create a system for

...

CEDM API

To create a system, do the following:

• Call transaction /STTP/COCKPIT

• Navigate to Master Data > Systems and then Choose Display/Edit.

• Choose Create. A popup is displayed. 

• In the popup, define a system name and use following parameters: 

  • System name (for example KAZ_EDOCEDM_API)

  • System Type: F - Foreign Reporting System

  • Communication Type: 0 – Not Specified

  • RFC Destination: Maintain the destination name created in SM59 without path

Technical user and authorization role

One technical user shall be created in ATTP and have authorization to execute web service calls.

Maintain service paths

Check and, if needed, maintain the service paths in the view /STTP/V_RSRVPATH via transaction SM30. Industry 20 is default industry for methods, correct product group depends on industry and added before True API request execution

Event additional properties

The following is a list of expected event properties to compose the notification message. The notification raise error in case the mandatory event properties is not available on the event.

Import from EAEU

Import from 3rd countries

Write off

Report codes transfer from non-resident

Act of acceptance

Act of acceptance Single distributor

New aggregation out of production

Customizing the solution

In general, customizing is performed with following transactions:

• /K3TKZ/EDO_PARAM - Reporting parameters

• /K3TKZ/EDO_CUST - Reporting customizing

• /K3TKZ/EDO_CONF - Reporting configuration

• /K3TKZ/EDO_ATTR_MAP - Reporting attributes mapping

General Customizing

The transaction /K3TKZ/EDO_PARAM contains parameters to influence the 3Keys Kazakhstan EDOCEDM. The settings will require a customizing transport.

Following the recommended minimum set of parameters

Customizing for Reports

Relevant industry

Maintain relevant industry in the transaction /K3TKZ/EDO_CUST under “Relevant industry”.

...

This mapping will be used to identify correct product group (Commodity group) on execution EDO CEDM API request.

Example:

Document type description

Maintain document type description in the transaction /K3TKZ/EDO_CUST under “Document Type”

Mapping attributes

Mapping attributes in the transaction /K3TKZ/EDO_CUST under “Mapping attributes” contains attributes for each report used on notification creation. 3Keys Kazakhstan EDO CEDM connector already contains predefined mapping attributes for delivered rule types:

Product Group

Product group in the transaction /K3TKZ/EDO_CUST under “Product group” contains possible values for product groups at EDO CEDM system. 3Keys Kazakhstan EDO CEDM already contains product groups, maintain additional values in case new product group added:

...

CEDM Status send from,

...

CEDM Status send to

EDO CEDM status customizing in the transaction /K3TKZ/EDO_CUST under “EDO “CEDM Status send from” contains possible status values for message sequence check before sending to EDO CEDM system. Node “EDO “CEDM Status change to” contains new status value to be set after receiving successful response for notification. 3Keys Kazakhstan EDO CEDM already contains EDO CEDM status, maintain values in case other status processing logic is required

Reporting message attributes

Participant tax code fields could be filled with value from source or destination fields of the EPCIS event or business transaction in the transaction /K3TKZ/EDO_ATTR_MAP .

The following location data source is supported:

...

The list is not final and planned to be enhanced for the future developed reporting message types

Rule processing

The common rule processing scheme:

...

The rule type Z3KKZ_EDO shall be assigned in the transaction /STTP/CUST_RULES to business steps / location groups related for the EDO CEDM Kazakhstan reporting 

The rule type Z3KKZ_EDO allows to use additional customizing parameters to determine the rule to be executed, determine the approval parameters, and helps with sequence check. In case event triggered rule contains more than one industry rule type Z3KKZ_EDO split objects into several reporting events group by industry.

...

...

Class-based rule condition is maintained via transaction /K3TKZ/EDO_CUST node “Rule condition” and based on class method /K3TKZ/CL_EDO_RULES=>GET_RULE_CONDITION_CLASS. Method is used to get class name from table /K3TKZ/C_EDOCOND, custom class could be assigned as condition processor. Class method /K3TKZ/IF_EDO_3K_RULE_COND~EXECUTE is called. (Rule processing will stop check if result is skip rule). 

Message approval

By default every report is ready for sending. If the explicit waiting of user approval is required activate User Approval check box in the transaction /K3TKZ/EDO_CONF under “Configuration ID” 

Sequence check

The sequence check is active for all outbound notification to EDO CEDM system. The sequence check is triggered during the message approval, check sequence function, sending notification to EDO CEDM via report /K3TKZ/EDO_DISPATCHER.

...

1. Call BADI /K3TKZ/BADI_EDO_SEQ_CHECK method BEFORE_CHECK

2. Check objects EDO CEDM status (status found). The EDO CEDM status tracked for every SGTIN in the table /K3TKZ/EDO_STA. The SSCC EDO CEDM status determined based on the first found SGTIN in the current hierarchy

3. Processing status: there is no report with the same objects in status “Send”

4. Check predecessor: there is no report with the same objects earlier than the current message

5. Call BADI /K3TKZ/BADI_EDO_SEQ_CHECK method AFTER_CHECK

The EDO CEDM status could be updated with transaction /K3TKZ/EDO_SN_INFO or program /K3TKZ/EDO_OMS_REP (if SGTIN was send to OMS with BR_CRYPTO_COMM event).

The sequence check can be skipped/ignored by user in the transaction /K3TKZ/EDO_MONITOR with button Approval

Configuration ID determination

The Configuration ID represents the user / certificate for login to the EDO CEDM system and electronic signature of the message in the connector Java part configuration file. 

...

Price determination

According to the EDO CEDM system documentation some document types need to maintain price data as separate step of the document sending process.

...

If required it is possible to redefine price data using BADI /K3TKZ/BADI_EDO_CHG_AFTER_MAP or or /K3TKZ/BADI_EDO_CHG_AFTER_CHK.

Price data is relevant for reporting notifications Act of acceptance, Act of acceptance Single distributor, Import from EAES, Import from third countries, Return into circlulation, Write Off.

Price information for reporting notification is optional. Reporting notification is created without price specification steps by default and could be activated using parameter via transaction /K3TKZ/BADI_EDO_CHG_AFTER_CHK.Price data is relevant for reporting notifications Act of acceptance, Act of acceptance Single distributor, Import from EAES, Import from third countries, Write Off.PARAM value X (for example parameter PRICE_RELEV_0001)

Background jobs for report processing

Report sending

The report /K3TKZ/EDO_DISPATCHER (could be planned as background job or run manually via transaction /K3TKZ/EDO_DISP) collects created reports with status “Sequence check” and “Ready for sending”, perform sequence check and send report to EDO CEDM system and update data:

• Report header / item

• Reporting event 

...

The report run results are stored as application log transaction SLG1, Object  /STTP/, Sub object REP, External ID /K3TKZ/EDO_SEND

Response processing

The report /K3TKZ/EDO_RESPONSE (could be planned as background job or run manually via transaction /K3TKZ/EDO_RESPONSE) collects send reports with status “Send”, receives report status from EDO CEDM system and updates data:

• Report header / item

...

The report run results are stored as application log transaction SLG1, Object  /STTP/, Sub object REP, External ID /K3TKZ/EDO_RESPONSE

OMS report processing

The report /K3TKZ/EDO_OMS_REP (could be planned as background job or run manually) collects events with processed BR_CRYPTO_COMM reporting events, checks status at EDO CEDM system for specific number (subset) of SGTINs and updates data:

...

The report run results are stored as application log transaction SLG1, Object  /STTP/, Sub object REP, External ID /K3TKZ/EDO_OMS_REPORT

Enhancements of the Solution

The 3Keys Kazakhstan EDO CEDM connector solution is designed as to be possibly enhance based on customizing and code enhancements. Code enhancements are realized through BAdI implementations.

Enhancing rule determination

3Keys rule configuration includes a possibility to further refine the selection criteria for a rule to be executed. This can be accomplished by using one of the following options:

...

Change report content

The report JSON generated by ATTP standard may not fit to the business requirements. Following options for the report JSON changing are available:

Create custom mapping logic

To compose report data, it is possible to use own logic by creating new rule type with own rule type execution class by implementing interface /K3TKZ/IF_EDO_3K_RULE_MAPPING (method EXECUTE).

...

To assign custom execution class use transaction /K3TKZ/EDO_CUST, node “Mapping Attributes”, column “Mapper Class”.

Change existing mapping logic

To compose report data it is possible to change existing rule type logic by using mapping class redefinition. It is necessary to create own class as child class of /K3TKZ/CL_EDO_0011_MAPPER Collect notification data (or copy of this class) and assign this new class to relevant rule type via transaction /K3TKZ/EDO_CUST, node “Mapping Attributes”, column “Mapper class”.

Change check logic after mapping

Badi /K3TKZ/BADI_EDO_CHG_AFTER_CHK shall be implemented for the rule type and own processing logic needs to be implemented.

Change report after mapping

Badi /K3TKZ/BADI_EDO_CHG_AFTER_MAP shall be implemented for the rule type and own processing logic needs to be implemented.

New custom

...

CEDM report type

The new EDO CEDM reporting type not existing in the 3Keys Kazakhstan Connector EDO CEDM can be created with following steps:

• Create new rule type via transaction /STTP/CUST_RULE_TYPE - Define Rule types

• Create new notification type via transaction /STTP/REP_NOTIF_TYPE - Define Reporting Notification Types

• Create ABAP structures for AIF (use structure /K3TKZ/S_EDO_IMPNRES_AIF as example)

• Create AIF customizing via transaction /AIF/CUST (Namespace /STTC3):

  • Define interface

  • Specify interface engine

  • Define structure mapping

• Create customizing for mapping report content via transaction /K3TKZ/EDO_CUST (“Mapping attributes” node)

• Add logic to extract report data implementing BADI /K3TKZ/BADI_EDO_PARSE

• Create customizing for new rule via transaction /STTP/CUST_RULES (3Keys General rule)

• Create customizing for new rule via transaction /K3TKZ/EDO_CONF (“Rule configuration” node)

• Create logic to parse data by implementing Badi /K3TKZ/BADI_EDO_PARSE

New industry

The new industry not supported by SAP ATTP standard can be created with following steps:

1. Create fixed value append for domain /STTP/D_INDUSTRY (for example ZP – Perfume). Skip this step if industry is supported by 3Keys Kazakhstan Connector for EDOCEDM.

2. Specify relevant industry for reporting (transaction /K3TKZ/EDO_CUST, node “Relevant Industry”) 

3. Add new REST path for created industry (transaction SM30 view /STTP/V_RSRVPATH)

4. Add general customizing parameter RR_RU_NTF_REV for industry using transaction /STTP/CUSTGEN

Create new

...

CEDM API function

The new EDO CEDM API method not existing in the 3Keys Connector EDO CEDM can be created with following steps

1. If base class for API processing does not exist create child class of /K3TKZ/CL_EDO_API_REQ as custom class ZCL_EDO_API_REQ

2. Create method GET_INSTANCE_ATT as copy of GET_INSTANCE at custom class ZCL_EDO_API_REQ

3. Create new constant for rest operation (use constant /K3TKZ/CL_EDO_REST_CONST=>GCS_REST_OPERATION-NOTIFICATION-EDO-GET_CISES_INFO as example)

4. Add new REST path for created REST operation (transaction SM30 view /STTP/V_RSRVPATH)

5. Create processor class (use class /K3TKZ/CL_EDO_API_INFO_KM Get Codes Information as example), for example ZCL_EDO_API_INFO_KM Get Codes Information 2

6. Add processor (class ZCL_EDO_API_INFO_KM) instance creation logic into method GET_INSTANCE_ATT (based on rest operation) of base class ZCL_EDO_API_REQ

7. Implement new created API processing class ZCL_EDO_API_REQ call into custom code

8. Create child / copy /K3TKZ/CL_EDO_REST_CLIENT and implement into ZCL_EDO_API_INFO_KM

Enhancement spot /K3TKZ/ES_EDO

Enhancement for navigation to ATTP cockpit

Add general customizing parameter /K3TKZ/COCKPIT_NAVIG (usage scope Customizing) to enable navigation to ATTP Cockpit from transaction /K3TKZ/EDO_MONITOR using transaction /STTP/CUSTGEN

...