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 | 01-Aug-2023 |
3.0 | Release RN_2023_04 | 17-Oct-2023 |
| 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
...
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 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 |
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.
...