Version

Changes

Effective Date

1.0

First approved version

3Keys Kazakhstan CEDM Add-On release 2024_04

01-Nov-2024

Note

Description

Category

2024_04_1

Corrections for 3Keys Kazakhstan CEDM Connector after migration to ATTP 3.4.

New BC Set /K3TKZ/CUST_OMS_3_4 Short Text: 3Keys Kazakhstan CEDM Add-On 3.4 created including all customizing settings.

Software Component K3TKZ3 3Keys Kazakhstan CEDM Add-On Release changed to 304.

This note is a part of software installation file SAPK-304COINK3TKZ3.

New feature

2024_04_2

After implementing Kazakhstan CEDM Release 2024_03 runtime error occurs on execution program /K3TKZ/EDO_RESPONSE in case no document exists for response processing. The reason is ABAP code error.

Error

2024_04_3

According to the CEDM API changes from July 2024 new restriction maximum object number 5000 is implemented for API methods create-doc and info-km. Notification splitting by object number is implemented for all notifications except aggregation.

Default splitting object number is 5000 for all notification types. New 3Keys parameters (transaction /K3TKZ/EDO_PARAM) implemented to change default value if required:

• “SPLIT_MAXOCC_0001” - maximum object number per notification type Act of acceptance Single Distributor (type 0001)

• “SPLIT_MAXOCC_0002” - maximum object number per notification type Import from EAEU (type 0002)

• “SPLIT_MAXOCC_0003” - maximum object number per notification type Import from 3rd countries (type 0003)

• “SPLIT_MAXOCC_0004” - maximum object number per notification type Write Off (type 0004)

• “SPLIT_MAXOCC_0005” - maximum object number per notification type Return into circulation (type 0005)

• “SPLIT_MAXOCC_0010” - maximum object number per notification type Act of acceptance (type 0010)

• “SPLIT_MAXOCC_0011” - maximum object number per notification type Report from non-resident (type 0011)

• “SPLIT_MAXOCC_INFO” - maximum object number for one API request used by transaction /K3TKZ/EDO_SN_INFO

In some cases error “No input data for selection from archive” occurs on retrigger rule Z3KKZ_EDO_CHANGE_HRY. The error reason is ABAP code error.

New feature, error

2024_04_4

CEDM report “Import from 3rd countries” (doc type 0003) changed:

• fields “Certification document type”, “Сertificate document number”, “Сertificate document date” changed to optional

New conditions implemented to run reporting rule for Act of acceptance or Act of acceptance Single Distributor based on Sold-To destination:

• “COND_3K_S_DIS_2” - Single Distributor (relevant rule type Z3KKZ_EDO_0001 Act of acceptance Single Distributor)

• “COND_3K_S_DIS_2_NEG” - Non-Single distributor (relevant rule type Z3KKZ_EDO_0010 Act of acceptance)

To use new conditions it is required to activate BC Set /K3TKZ/CUST_EDO_3_X_2024_04_04 and maintain new conditions manually via transaction /K3TKZ/EDO_CONF node “Rule Configuration” column “Customer condition” for relevant rule types.

New HTTP header parameter “3kdocguid” implemented to simplify CEDM log analysis. Parameter contains ATTP message item guid from table /K3TKZ/EDO_ITM field GUID.

In some cases CEDM API method getDataForSign returns response code 200 and response body “null”. Sending process is stopped due to signature processing error. Sending logic corrected to stop sending process in this scenario and continue with next dispatcher run.

Support of inbound document processing implemented:

• customizing via transaction /K3TKZ/EDO_CUST (node “Relevant Industry” column “Inbound Document Active”)

• customizing via transaction /K3TKZ/EDO_CONF (node “Inbound Filter”, node “Inbound Document processing”)

• program to receive inbound document /K3TKZ/EDO_DOC_IN

• AIF interface /STTC3 ZKZEDO_I10 1 to process inbound Act of acceptance

• AIF interface /STTC3 ZKZEDO_INB 1 to process general inbound document in case of unknown parsing error

• Function modules to process Inbound act via AIF:

  • /K3TKZ/AIF_EDO_IN_ACCEPT Inbound Doc: Accept document, set status Confirmed

  • /K3TKZ/AIF_EDO_IN_CEDM_STATUS Inbound Doc: Set status based on CEDM status

  • /K3TKZ/AIF_EDO_IN_CUST Inbound Doc: AIF processing customizing

  • /K3TKZ/AIF_EDO_IN_GEN Inbound Doc: Start processing

  • /K3TKZ/AIF_EDO_IN_NO_REACTION Inbound Doc: No reaction, set status Confirmed

  • /K3TKZ/AIF_EDO_IN_REP Inbound Doc: Post reporting event

  • /K3TKZ/AIF_EDO_IN_RETURN Inbound Doc: Return processing

• transaction /K3TKZ/EDO_CHG_RUN to change last run date manually

• new functions “Accept document” and “Reject document” into transaction /K3TKZ/EDO_MONITOR. Functions are available for documents with status “20-Processing”.

• changes for transaction /K3TKZ/EDO_MONITOR to support Inbound document type

• new selection screen fields “Inbound messages”, “Outbound messages” at block “Additional parameters” added into transaction /K3TKZ/EDO_MONITOR

• new rule type “Z3KKZ_EDO_INB_MSG” Inbound message processing created

• support for CEDM API method get document codes added.

New feature

2024_04_5

Price value 0 is allowed for the CEDM messages.

The message processing will be stopped in status 05-Missing data and waiting manual user input in case price cannot be determined.

New GTIN attributes for price per CEDM message type.

• ZKZ_PRICE_0001 (“Act of acceptance Single Distributor” notification)

• ZKZ_PRICE_0002 (“Import from EAEU” notification)

• ZKZ_PRICE_0003 (“Import from 3rd countries” notification)

• ZKZ_PRICE_0004 (“Withdrawal” notification)

• ZKZ_PRICE_0005 (“Return to circulation” notification)

• ZKZ_PRICE_0010 (“Act of acceptance” notification)

The system will determine price from the default GTIN attribute “ZKZ_PRICE” if GTIN attributes for price per CEDM message type is not maintained.

New feature

2024_04_6

CEDM report “Import from EAEU” (doc type 0002) changed:

• fields “Document number”, “Document Date” changed to optional

Transaction /K3TKZ/EDO_MONITOR changed:

• Function “Display document header” from menu “CEDM” at item level improvement - in some cases function is completed with Runtime error due to special characters in JSON response. ABAP code corrected to display JSON without error

• Function “Popup Missing data” for document type “Return into circulation” corrected:

  • Error message “Field catalog not found” is displayed on “Set Costs“ button - error is fixed

  • Fields “Document Name”, “Document Number”, “Document Date” changed to mandatory on missing data screen

• New function “Delete Draft at CEDM” implemented into menu “Special functions” at item level. Function allow to delete Draft in case sending process errors and includes the following steps: Delete document Draft at CEDM system using CEDM API method; Clear document CEDM guid with Change document creation; Cancel document

Transaction /K3TKZ/EDO_CHANGE updated with new function to delete Draft from CEDM with specified Configuration ID, RFC connection name (API service name is expected), Document ID

New feature

Note      

Transport

Prerequisites

Release date

2024_04_1

N/A

2024_04_2

A1DK900731

A1DK900725

02-Aug-2024

2024_04_3

A1DK900737

A1DK900731

09-Aug-2024

2024_04_4

A1DK900745

A1DK900737

24-Sep-2024

2024_04_5

A1DK900753

A1DK900745

15-Oct-2024

2024_04_6

A1DK900759

A1DK900753

22-Oct-2024

Note      

Transport

Prerequisites

Release date

2024_04_1

N/A

2024_04_2

A2DK900827

A2DK900821

02-Aug-2024

2024_04_3

A2DK900835

A2DK900827

09-Aug-2024

2024_04_4

A2DK900852

A2DK900835

24-Sep-2024

2024_04_5

A2DK900865

A2DK900852

15-Oct-2024

2024_04_6

A2DK900869

A2DK900865

22-Oct-2024

Note      

Transport

Prerequisites

Release date

2024_04_1

N/A

2024_04_2

A3DK900400

A3DK900394

02-Aug-2024

2024_04_3

A3DK900404

A3DK900400

09-Aug-2024

2024_04_4

A3DK900414

A3DK900404

24-Sep-2024

2024_04_5

A3DK900426

A3DK900414

15-Oct-2024

2024_04_6

A3DK900430

A3DK900426

22-Oct-2024

Note      

Transport

Prerequisites

Release date

2024_04_1

N/A

2024_04_2

A4DK900348

A4DK900332

02-Aug-2024

2024_04_3

A4DK900362

A4DK900348

09-Aug-2024

2024_04_4

A4DK900446

A4DK900362

24-Sep-2024

2024_04_5

A4DK900478

A4DK900446

15-Oct-2024

2024_04_6

A4DK900490

A4DK900478

22-Oct-2024

Note      

Transport

Prerequisites

Release date

2024_04_1

software delivery SAPK-304COINK3TKZ3

11-Sep-2024

2024_04_2

software delivery SAPK-304COINK3TKZ3

11-Sep-2024

2024_04_3

software delivery SAPK-304COINK3TKZ3

11-Sep-2024

2024_04_4

A5DK900031

software delivery SAPK-304COINK3TKZ3

24-Sep-2024

2024_04_5

A5DK900049

A5DK900031

15-Oct-2024

2024_04_6

A5DK900055

A5DK900049

22-Oct-2024