Version

Changes

Effective Date

1.0

First approved version

3Keys Kazakhstan MPT Add-On release 3.1

01-May-2022

Rule

Notification

Z3KKZ_MT

Reg.Rep.Kazakhstan MPT - General rule

Z3KKZ_MT_0004

Reg.Rep.Kazakhstan MPT - Import EAEU notification (IMPORT_TRANSIT)

Z3KKZ_MT_0005

Reg.Rep.Kazakhstan MPT - Act notification (KZ_UPD)

Z3KKZ_MT_IMP

Reg.Rep.Kazakhstan MPT - Import notification (IMPORT)

Z3KKZ_MT_INBOUND_MSG

Reg.Rep.Kazakhstan MPT - Inbound message

Z3KKZ_MT_WRITEOFF

Reg.Rep.Kazakhstan MPT - WriteOff notification (MTTPS_90)

Industry

Identifier

RU System

RU System Revision

REST Operation

REST Path

20

NTF (Notification System)

600

APPROVE_INB_EDI_DOC

/api/v3/true-api/edo-api/incoming-documents/{document_id}/events/approve

20

NTF (Notification System)

600

CREATE_DOC_FORMAL

/api/v3/true-api/edo-api/outgoing-documents/formal

20

NTF (Notification System)

600

CREATE_DOC_IMPORT

/api/v3/true-api/documents/transit/import/third_countries

20

NTF (Notification System)

600

CREATE_DOC_WRITEOFF

/api/v3/true-api/documents/writeOff

20

NTF (Notification System)

600

GET_CISES_INFO

/api/v3/true-api/cises/info

20

NTF (Notification System)

600

GET_DOCUMENTS

/api/v3/true-api/doc/listV2

20

NTF (Notification System)

600

GET_DOCUMENT_INFO

/api/v3/true-api/documents/{document_id}/info

20

NTF (Notification System)

600

GET_INB_EDI_DOC

/api/v3/true-api/edo-api/incoming-documents

20

NTF (Notification System)

600

GET_INB_EDI_DOC_BODY

/api/v3/true-api/edo-api/incoming-documents/{document_id}/base64

20

NTF (Notification System)

600

GET_KEY

/api/v3/true-api/auth/key

20

NTF (Notification System)

600

GET_OUT_EDI_DOC

/api/v3/true-api/edo-api/outgoing-documents

20

NTF (Notification System)

600

SIGN_IN

/api/v3/true-api/auth/simpleSignIn

20

NTF (Notification System)

600

SIGN_INB_EDI_DOC

/api/v3/true-api/edo-api/incoming-documents/{document_id}/events/approve/signature

20

NTF (Notification System)

600

SIGN_OUT_EDI_DOC

/api/v3/true-api/edo-api/outgoing-documents/{document_id}/events/signature

20

NTF (Notification System)

600

WITHDRAW_OUT_EDI_DOC

/api/v3/true-api/edo-api/outgoing-documents/{document_id}/events/withdraw

Property

Description

Mandatory?

ZR_KZ_CTR_CODE

Country of export according to the directory of countries

Y

ZR_KZ_DECL_DOCUMENT

Document type:

DECLARATION -

Declaration of goods;

STATEMENT- Application for release of goods before filing a declaration of goods

Y

ZR_KZ_DECL_NUM

Document registration number

Y

ZR_KZ_DECL_DATE

Document registration  date  in  YYYY-MM-DD format

Y

ZR_KZ_DECL_POS

Declaration item number

Y

ZR_KZ_DECISION_CODE

The code of the decision.  Possible values: 10, 11,

12, 13, 14, 20

Y

ZR_KZ_DECISION_DATE

Date in YYYY-MMDDThh format:mm:ssZ

Y

ZR_KZ_CUSTOMS_CODE

Customs authority  code.  See also Handbook of Customs Codes

Y

ZR_KZ_CERT_DOCUMENT

Information about the document confirming the  conformity of the goods - Document Type

Y

ZR_KZ_CERT_DOC_NUM

Information about the document confirming the  conformity of the goods - Document Number

Y

ZR_KZ_CERT_DOC_DATE

Information about the document confirming the  conformity of the goods - Document Date

Y

ZR_KZ_IMPORTER_ID

Importer tax code

Y

ZR_KZ_IMPORTER_NAME

Importer name

Y

ZR_KZ_PRM_DOC_NUM

Paper Document Number Notice

N

ZR_KZ_PRM_DOC_DATE

Date of paper document Notifications in the format

YYYY-MM-DD

N

ZR_KZ_TNVED_CODE

TNVED - commodity nomenclature of foreign economic activity of the Eurasian Economic Union

Y

Property

Description

Mandatory?

ZR_KZ_CORR_FLAG

Sign of a corrected Notification (new Notification as a correction of the original one)

• True - Corrected (corrected)

• False - Original

 Default = false

N

ZR_KZ_CORR_DOC_ID

GUID of the document to which the  adjustment is sent

Y - if acceptance  or adjustment of the notice

ZR_KZ_REG_DOC_NUM

Registration document  number  of the import notice

Y - if acceptance  or adjustment of the notice

ZR_KZ_REG_DOC_DATE

The date of the registration document, in the dd.mm.yyyy format

Y - if acceptance  or adjustment of the notice

ZR_KZ_SUPPL_CTR_CODE

Country of departure.

• AM - Armenia

• BY - Belarus

• KG - Kyrgyzstan

RU - Russia

Y

ZR_KZ_SUPPL_ID

Identifier

taxpayer (TIN,

IIN, BIN and

etc.) sender or equivalent

Y

ZR_KZ_SUPPL_NAME

Name of sender

(supplier)

Y

ZR_KZ_CONS_ID

IIN/BIN of the recipient

Y

ZR_KZ_CONS_NAME

Name of the recipient  (buyer)

N

ZR_KZ_PRM_DOC_NUM

Primary document number

N

ZR_KZ_PRM_DOC_DATE

The date of the primary document, in the dd.mm.yyyy format

N

ZR_KZ_EXCISE_DOC_NUM

Excise duty receipt number

Y

ZR_KZ_EXCISE_DOC_DAT

The date of the excise duty payment, in the dd.mm.yyyy format

Y

ZR_KZ_EXCISE_AMOUNT

Excise duty amount.  Number with two   decimal places

Y

ZR_KZ_COMPL_DOC_NUM

Compliance document  number

N

ZR_KZ_COMPL_DOC_DATE

The date of the conformance document, in the dd.mm.yyyy format

N

ZR_KZ_COMPL_DOC_TYPE

Compliance document type

N

Property

Description

Mandatory?

ZR_KZ_REASON

The reason for the withdrawal of  goods from circulation with values:

• 1 - Defect;  

• 2 - Loss;

• 3 - Damage;

• 4 - Destruction;

• 5 - Use for own needs of the  enterprise;

• 6 - Sampling;

• 7 - For medical purposes;

(only for TG Pharma)

• 8 - Free  prescription leave; (only for TG Pharma)

• 9 - Withdrawal from circulation in e-commerce;

• 10 - Return to an individual;

• 11 - Confiscation (reserved - not applicable)

Y

ZR_KZ_PRM_DOC_NAME

Name of the primary document

Y

ZR_KZ_PRM_DOC_NUM

Primary document number

Y

ZR_KZ_PRM_DOC_DATE

The date of the primary document, in dd.mm.yyyy format

Y

ZR_KZ_PARTIC_ID

Participant tax code

Y

ZR_KZ_PARTIC_NAME

Participant name

Y

Property

Description

Mandatory?

ZR_KZ_CORR_FLAG

Sign of a corrected Act (new Act as a correction of the original one)

• True - Corrected (corrected)

• False - Original

 Default = false

N

ZR_KZ_CORR_DOC_ID

GUID of the document to which the  adjustment is sent

Y - if a sign of a corrected Act

(correctionFlag) = true

ZR_KZ_OPER_TYPE

Operation type:

• 1 - Sale;

• 2 - Commission/Agency Trading

Y

ZR_KZ_REG_DOC_NUM

Registration number of the  document to  which the adjustment  is transmitted

Y - if a sign of a corrected Act

(correctionFlag) = true

ZR_KZ_REG_DOC_DATE

Date of registration of the  document to which the adjustment is transferred

Y - if a sign of a corrected Act

(correctionFlag) = true

ZR_KZ_PRM_DOC_NUM

Primary document number

N

ZR_KZ_PRM_DOC_DATE

The date of the primary document, in the dd.mm.yyyy format

N

ZR_KZ_SUPPL_ID

IIN/BIN of the sender (supplier)

Y

ZR_KZ_SUPPL_NAME

Name of sender (supplier)

N

ZR_KZ_CONS_ID

IIN/BIN of the recipient (buyer)

Y

ZR_KZ_CONS_NAME

Name of the recipient  (buyer)

N

Name

Description, Values

MPT_SYSTEM

System name at master data for online integration

Example: MPT

MON_NAVIG_ACTIVE

Navigation to ATTP Cockpit is active for transaction /K3TKZ/DOC_MONITOR

X - active

Name

Value

MPT_SYSTEM

Example: MPT

Field

Description, Values

Industry

Industry relevant for connector operations

Product group

Product group at MPT system

Text

Free text used to describe industry

Inbound document active

Flag to activate inbound document processing

Industry

Product group

Text

20

Pharma

Pharmaceuticals

Field

Description, Values

Doc Type

Internal document type (values are predefined).

Example:

• 0001 Import from 3rd countries (IMPORT)

• 0002 Introduce goods (KZ_INTRODUCE_GOODS)

• 0003 Withdrawal from circulation (MTTPS_90)

• 0004 Import from EAEU (IMPORT_TRANSIT)

• 0005 Act of acceptance (KZ_UPD)

• 0091 Code Usage for OMS (OMS_USAGE)

Document Type Description

Text to be displayed at Report Monitor for document type

MPT Document Type

TRUE API document type

Field

Description, Values

Rule Type

Rule execution type 

Notification Type

Notification type

NS

AIF namespace.

Value is common for 3Keys MPT connector: /STTC3

Interface

AIF interface.

Unique for each rule type, example: ZKZMPT_IMP

Version

AIF interface version.

3Keys Kazakhstan MPT connector value: 1

Raw Data Structure

AIF request/response structure for notification data

Example: /K3TKZ/S_MPT_IMP_AIF

SAP Data Structure

SAP structure for notification data

Example: /K3TKZ/S_MPT_IMP_MSG

MPT Document Type

Internal document type

Example: 1

Mapper class

Mapper class to fill notification with data

Example: /K3TKZ/CL_IMPORT_MAPPER

REST Operation

REST service operation used to determine service path

Example: CREATE_DOC_IMPORT

Field

Description, Values

Product group

Product group from True API documentation

Example: pharma

Text

Description (used at search help)

Example: Pharma