Document History
Version | Changes | Effective Date |
1.0 | First approved version 3Keys Uzbekistan Add-On release 3.1 | 01-Apr-2022 |
2.0 | Release RN_2023_03 |
06-Jul-2023
01-Aug-2023 | ||
3.0 | Release RN_2023_04 | 01-Nov-2023 |
4.0 | Release RN_2024_04 | 01-Nov-2024 |
| Table of Contents |
|---|
1. About This Guide
...
In 3Keys Uzbekistan Add-On OMS, the following notifications are supported:
Rule | Notification |
BR_CRYPTO_COMM | Bus. Rule: Commissioning for Crypto Codes |
BR_CRYPTO_DECOMM | Bus. Rule: Decommissioning for Crypto Codes |
Z3KUZ_OMS_AGGR | Aggregation report to OMS |
Z3KKZ_OMS_AGGR_MPCK | Aggregation report to OMS based on object event in ATTP |
3. Constraints, Assumptions, Prerequisites and Dependencies
...
o For example, the URL https://omscloud.aslbelgisi.uz (or https://omscloudicom-legacy-api.stage.aslbelgisi.uz - test system) results into:
...
URL Type: Choose one of the following URL types:
URL Type | Description |
UZ_10_OMS | OMS URL Type (Pharmaceuticals UZ) |
Logical Port Name: Maintain the destination name created in SM59.
...
The profile relevant country UZ, flag Crypto Code Relevant shall be set on GTIN level.
...
.
...
The following product properties
The production line property RR_RU_PRODLINE_ID could be set to send the same aggregation with new report with updated request content.
4.7 Additional attributes / Product properties
The following product properties for can be maintained for trade items for sending crypto code order request to OMS system.
Property | Description | Value |
ZUZ_OMS_RMT | Release method type (optional parameter) The default value IMPORT is used in case product property is not maintained | IMPORT - in case of import to Uzbekistan PRODUCTION – in case of manufacturing in Uzbekistan |
GTIN_INDUSTRY | GTIN industry | 10 - Pharma Uzbekistan |
BR_OWNER_GLN | Business partner GLN with company registration types maintained |
|
RR_CRYPTO_RELEV | GTIN is relevant for Crypto Codes | X |
4.8 Company registration types
The following company registration types can be used by business partners for sending aggregation report to OMS system. Maintain following company registration types
Property | Description | Value |
ZUZ_OMSRMT | Release method type (optional) The default value IMPORT is used in case product property is not maintained | IMPORT - in case of import to Uzbekistan PRODUCTION – in case of manufacturing in Uzbekistan |
ZUZ_PARTIC | Ident. Number of Taxpayer UZ OMS (mandatory) |
|
4.9 Customizing the solution
...
Maintain the service paths in the view /STTP/V_RSRVPATH via transaction SM30.
Industry Identifier | RU System | RU System Revision | REST Operation | REST Path |
10 (Pharma UZ) | OMS (Order Management System) | 283 | GET_AGG_INFO | /api/v2/pharma/aggregation/info |
10 (Pharma UZ) | OMS (Order Management System) | 283 | GET_CONNECTION_ID | /api/v2/integration/connection |
10 (Pharma UZ) | OMS (Order Management System) | 283 | GET_EMISSION_ORDERS | /api/v2/pharma/orders |
10 (Pharma UZ) | OMS (Order Management System) | 283 | GET_OMS_VERSION | /api/v2/pharma/version
|
10 (Pharma UZ) | OMS (Order Management System) | 283 | GET_REPORT_STATUS | /api/v2/pharma/report/info |
10 (Pharma UZ) | OMS (Order Management System) | 283 | PING | /api/v2/pharma/ping |
10 (Pharma UZ) | OMS (Order Management System) | 283 | SEND_AGGREGATION | /api/v2/pharma/aggregation |
10 (Pharma UZ) | OMS (Order Management System) | 283 | SEND_CLOSE_ARRAY | /api/v2/pharma/buffer/close |
10 (Pharma UZ) | OMS (Order Management System) | 283 | SEND_DROPOUT | /api/v2/pharma/dropout |
10 (Pharma UZ) | OMS (Order Management System) | 283 | SEND_IC_ORDER | /api/v2/pharma/orders |
10 (Pharma UZ) | OMS (Order Management System) | 283 | SEND_IC_RETRIEVAL | /api/v2/pharma/codes |
10 (Pharma UZ) | OMS (Order Management System) | 283 | SEND_IC_STATUS | /api/v2/pharma/buffer/status |
10 (Pharma UZ) | OMS (Order Management System) | 283 | UPLOAD_LOGS | /api/v2/pharma/logs/upload |
4.9.2 General Customizing
The transaction /STTP/CUSTGEN contains parameters to influence the 3Keys Uzbekistan OMS Add-On. The settings will require a customizing transport.
Component | Parameter key | Parameter Option | Parameter Value | Description |
SNR | CC_AUTO_CNF_COMM | 10 | X | Auto Confirm for Pharma UZ. This parameter prevents sending utilization report for specified industry and sets confirmed flag for crypto codes after BR_CRYPTO_COMM rule execution Need to be inactive at Test system Need to be active at Production system |
REP | RR_RU_OMS_PING | 10 |
| Execute ping before each OMS method call. Trigger application error if ping is not successful |
REP | RR_RU_OMS_REV | 10 | 283 | OMS revision for UZ Pharma industry |
REP | RR_RU_OMS_SAVE_RESP | 10 | X | Save response |
REP | Z3KUZ_OMS_ACTIVE |
| X | Activate 3Keys Uzbekistan OMS Add-On |
REP | Z3KUZ_AG_MAXOBJPACK |
|
| Maximum object number in aggregation report |
REP | Z3KUZ_SKIP_CC_CNFCHK | <GLN> |
| Skip crypto code confirmed check on sequence check |
REP | Z3KUZ_SKIP_OM_ONLCHK | <GLN> |
| Skip online aggregation check on sequence check This parameter is mandatory. |
REP | Z3KUZ_MAX_LOG_ROWS |
|
| Maximum errors on sequence check predecessor check for one report |
REP | Z3KUZ_OMS_PRDLINE_ID | Production line value for aggregation report sending. Can be used to send the same aggregation with changed report request body | ||
REP | Z3KUZ_OMS_LOCK_TRIES | 20 | Maximum OMS lock tries before OMS interaction operation (except aggregation report sending). After each lock attempt delay system wait for delay 2 seconds. In case parameter is not maintained default value 20 is used. This parameter is optional. | |
REP | Z3KUZ_OMS_EVT_PRDDT | 10 | Example: Z_MANUF_DATE | Event property name from commissioning event for Utilization report “Production Date” field |
REP | Z3KUZ_OMS_AG_SEND_ID | Example: X | Send Aggregation report with Application ID prefix “00”. Use value ““ (blank) to avoid prefix if necessary. In case parameter is not maintained prefix “00” is not used. This parameter is optional. | |
REP | Z3KUZ_OMS_SUBS_SC_ST | Example: SUCCESS | Substitute positive Response status to new value. Relevant in case OMS 3.0 is activated |
4.10 Customizing for Reports
...
The following values are recommended
Node | Description, Values |
Define country group | Country/Reg group:
Country/Reg group Short description:
|
Country group Country assignment | Country:
Name:
|
This country group will be used to restrict rule execution at rule customizing.
...