Second Compatibility Code used to Trigger SKU Blocking (K84)

Purpose: Use this screen to define the second compatibility code used to trigger Order Management System to send item and order information to an external system to determine whether the item/SKU is allowed on the order.

Code field: Enter the second compatibility code used to trigger Order Management System to send item and order information to an external system to determine whether the item/SKU is allowed on the order. You can define a second compatibility code for an item on the Create Item (Base Information) Screen (non-SKUed item) or Create SKU 1 of 2 (With Overrides) Screen (SKUed item).

Note: If you are not using an external system to prohibit items on an order, leave this system control value blank.

When is SKU Blocking Evaluated? The system sends item and order information to an external system to determine order eligibility during the following points.

Interactive Order Entry

• You add an item to the order whose second compatibility code matches the code defined in the Second Compatibility Code used to Trigger SKU Blocking (K84) system control value.

• During the final order accept if the second compatibility code for any of the items on the order matches the code defined in the Second Compatibility Code used to Trigger SKU Blocking (K84) system control value.

Order Maintenance

• You add or change an item whose second compatibility code matches the code defined in the Second Compatibility Code used to Trigger SKU Blocking (K84) system control value.

• You accept the order maintenance changes if the second compatibility code for any of the items on the order matches the code defined in the Second Compatibility Code used to Trigger SKU Blocking (K84) system control value.

Generic Order Interface

Order Management System receives an Inbound Order XML Message (CWORDERIN) through the Generic Order Interface (Order API) that contains an item whose second compatibility code matches the code defined in the Second Compatibility Code used to Trigger SKU Blocking (K84) system control value.

Batch Order Entry

• You add or change an item on an order whose second compatibility code matches the code defined in the Second Compatibility Code used to Trigger SKU Blocking (K84) system control value.

• You perform the batch order edit if the second compatibility code for any of the items on the order matches the code defined in the Second Compatibility Code used to Trigger SKU Blocking (K84) system control value.

Items that are not Evaluated: The system does not evaluate items that are soldout or are on order lines that are in a Closed status.

Logging: The system logs any transactional messages between Order Management System and the external system in the MQ Log at the Debug Logging Level. If Order Management System cannot connect to the external system, the system writes the following error message, where 192.168.255.255 is the IP address of the external system in the Application Log at the Error Logging Level: I/O problem for the connection to: 192.168.255.255.

If the External System Allows the Item on the Order: If the external system allows the item on the order, Order Management System continues with regular order processing.

If the External System Prohibits the Item on the Order: If the external system prohibits the item on the order, the system sends a response to Order Management System with an error reason. Order Management System matches the error reason returned with an error reason in the External Line Error Table.

Interactive Order Entry

Order Management System prevents you from adding the item to the order and displays the error message Item cannot be added followed by the text in the Description field in the External Line Error table. For example: Item cannot be added - NOT SOLD IN REQUESTED DELIVERY AREA.

If an error match cannot be found, the system displays the error message Item cannot be added - Error Code Not Found in Table.

Note: During order accept, if more than one item on the order is prohibited, the system displays the error message for the first item in error. Once you correct the error and select order accept again, the system will display the error message for the next item in error until all of the prohibited items are corrected or removed from the order.

Order Maintenance

Generic Order Interface

Order Management System places the order in an error status. The Detailed Order XML Response (CWORDEROUT) displays the error_code UU and the error_text SKU Blocked for each item that is not allowed on the order as determined by the external system. You will need to correct the error in batch order entry.

Batch Order Entry

When you add or change an eligible item, Order Management System displays the error message Item cannot be added followed by the text in the Description field in the External Line Error table. For example: Item cannot be added - NOT SOLD IN REQUESTED DELIVERY AREA. If an error match cannot be found, the system displays the error message Item cannot be added - Error Code Not Found in Table.

When you run the batch order edit, the error SKU Blocked prints for each item that is not allowed on the order as determined by the external system.

External Line Error Table

This table contains the error reasons provided by the external system for why an item is not allowed on an order.

Note: It is your responsibility to populate this table with the error reasons provided by the external system.

Order Management System delivers the record UU - Error Code Not Found in Table to use when a match cannot be found to an error reason returned by the external system.

Field

Description

ELE Code

A code that represents the reason why an item/SKU is not allowed on an order.

Alphanumeric, 2 positions; required.

ELE Description

The description of why an item/SKU is not allowed on an order.

Alphanumeric, 78 positions; required.

Interface Properties File

The WMSSKUBLOCKER_HOST and WMSSKUBLOCKER_PORT settings in Working with Customer Properties (PROP) define the IP address and port number used to connect to the external system that determines item eligibility for an order. Contact your Order Management System representative for more information about creating a unique program to transmit SKU Blocking messages between Order Management System and an external system.

IN03_02 OMSCS 19.0 December 2019 OHC