Professional Documents
Culture Documents
Merchandising Replenishment 19.0 White Paper
Merchandising Replenishment 19.0 White Paper
Custom Templates
Similar to the functionality added for items and purchase orders, replenishment attribute management via the spreadsheet
method supports configurable templates. The default ‘base’ template provided with the solution will be discussed in detail in
this paper and includes all the attributes that are available to be updated, but it is equally important to understand that there
is a built in capability to create your own templates that can be used for specific purposes and help tailor this capability to
your business.
For example, you may choose to have different templates for activating items on replenishment versus updating existing
replenishment attributes; or different templates based on the replenishment method. Creating one or more custom
templates allows you to create a spreadsheet template showing only those attributes that you want users to update, and also
supports a defaulting feature to default certain attributes that are set commonly across items and locations for that
particular template.
For more details on this configuration process, see the Spreadsheet Template Management White Paper.
Once you have the required data queried into the search results, you can click on the Download button to initiate the export.
The pop up displayed will allow you to select the template into which the data will be extracted. The Process Description field
will default to a value based on the timestamp, but it can be updated by the user for tracking the download process in case
of any issues.
Manual Upload
Once the data has been updated into the spreadsheet, the next step will be to upload this into Merchandising. This is done
by selecting the Upload Replenishment Attributes option in the Merchandising task list. To do this, you will have to select the
template that you used for creating the spreadsheet and then select the location where your file has been saved. Finally, a
process name is given to allow tracking of the progress of the upload based on the activity timestamp after it is submitted;
but this can be edited, if required.
Validations
The key validations that will be performed while uploading replenishment data are given below. Prior to performing a
detailed level validation, the file format is validated to ensure that all the expected data elements are included. The basic
validation is as follows:
1. The upload file/message should contain data that is in-line with the data type requirements of the target tables.
2. In case of duplicate records even with different actions, in the same file, the duplicate records will not be processed and
an error will be logged.
3. The data in each record sent has all the mandatory data included based on the action type indicated in the file or
message.
4. The data in each record is valid.
If this validation fails, then the entire upload is rejected. Otherwise it will move on to data level validation. For any data level
validation failure, the corresponding error is logged against the failed record and the processing moves on to the next
record.
The sections below explain the data validations that will occur based on the different action types.
Replenishment This field, if provided, will be ignored when creating new records, since it will be generated by the
Update ID system.
Schedule This field is optional. If not specified, one of the following auto generated descriptions will be used
Description based on the scenario:
Scheduled Replenishment for <item> at <location>
Scheduled Replenishment for <item | diff> at <location>
Scheduled Replenishment for <Dept | Class | Subclass> at <location>
Effective Date Optional; the effective date needs to be greater than or equal to the current date. This date indicates
when the updates will be applied to the item/locations. If no value is specified, then the date will be
defaulted to the current date.
Item Optional; if specified, this can be a transaction level item or a parent level item for which the attributes
are being activated, deactivated, or updated. One field out of an item, department, class, or subclass
must be specified for all create actions.
Diff 1-4 Optional; if a parent level item is specified as the item, then differentiator IDs can also be specified to
further narrow the items that will have their attributes updated. Validation will be done to ensure that
the differentiator IDs are valid and match those that apply for the parent item.
1 All other attributes that are available in the template, but are not listed here are required or optional depending on the
replenishment method specified and details on that can be found in the RMS Replenishment Overview white paper. If the
create action is Deactivate, then the attributes not listed here are not applicable; if the create action is Update, then the not
listed attributes are optional, unless another attribute being updated also requires the value to be specified. For example, if
changing the season, then the phase would also need to be updated.
6 Replenishment Attribute Update Overview] Release 19.0.x
Copyright © 2020, Oracle and/or its affiliates
FIELD1 REPLENISHMENT ACTION VALIDATION
Department Optional; this field needs to be specified if the update will be made at the department, class, or subclass
level. The specified value needs to be a valid department ID in Merchandising. One field out of an item,
department, class, or subclass must be specified for all create actions.
Class Optional; this field needs to be specified if the update will be made at the class or subclass level. The
value needs to be a valid class ID for the specified department in Merchandising. One field out of an
item, department, class, or subclass must be specified for all create actions.
Subclass Optional; this field needs to be specified if the replenishment is to be set up at the subclass level. The
value needs to be a valid subclass ID for the specified department and class in Merchandising. One field
out of an item, department, class, or subclass must be specified for all create actions.
Location Optional; only used if S or W are selected as the location type. In those cases, this field is required. The
specified value needs to be a valid store or warehouse number, depending on the location type
specified.
Location Type Required field; valid values are: S (Store), W (Warehouse), AS (All Stores), AW (All Warehouses).
Activate Date Required; this date must be equal n/a Optional, if not specified then when the update
to or greater than the current is applied, the activate date won’t be updated.
date and less than the deactivate
date, if specified.
Deactivate Date Optional; but if specified, needs n/a Optional, if not specified then when the update
to be at least one day greater is applied, the deactivate date won’t be updated.
than the current date and later
than the activate date.
Presentation Required; will be defaulted to n/a Optional, if not specified then when the update
Stock zero if not specified. is applied, the presentation stock won’t be
updated.
Demo Stock Required; will be defaulted to n/a Optional, if not specified then when the update
zero if not specified. is applied, the demo stock won’t be updated.
Stock Category Required; valid values are (code n/a Optional, if not specified then when the update
type SCST): is applied, the stock category won’t be updated.
Cross-Docked (C)
Direct to Store (D)
Order Control Required; valid values are (code n/a Optional, if not specified then when the update
type ROCT): is applied, the order control won’t be updated.
Automatic (A)
Buyer Worksheet (B)
Manual (M)
Semi-Automatic (S)
Source Required for stock categories n/a Optional, if not specified then when the update
Warehouse cross-docked, WH/cross link, and is applied, the source warehouse won’t be
warehouse stocked for store updated.
location types. Must be a valid
virtual warehouse ID in
Merchandising.
Supplier Required for stock categories n/a Optional, if not specified then when the update
cross-docked, direct to store, or is applied, the supplier site won’t be updated.
WH/cross link, for store location
types, as well as warehouse
stocked for warehouse location
types. This value must be a valid
supplier site ID in Merchandising.
Origin Country Required for stock categories n/a Optional, if not specified then when the update
cross-docked, direct to store, or is applied, the origin country won’t be updated.
WH/cross link, for store location
types, as well as warehouse
stocked for warehouse location
types. This value must be a valid
country code in Merchandising.
Pickup Lead Time Required for stock categories n/a Optional, if not specified then when the update
cross-docked, direct to store, or is applied, the pickup lead time won’t be
WH/cross link, for store location updated.
types, as well as warehouse
stocked for warehouse location
types.
Warehouse Lead Required for stock categories n/a Optional, if not specified then when the update
Time cross-docked, WH/cross link, and is applied, the warehouse lead time won’t be
warehouse stocked for store updated.
location types.
Replenishment Required; valid values are (code n/a Optional; if not specified, then when the update
Method type RM): is applied, the replenishment method will not be
updated. If it is specified and the Update
Constant (C)
Replenishment Method flag is Y, then the
Dynamic (D)
replenishment method will be updated to the
Dynamic – Issues (DI)
specified value for all item/location
Dynamic – Seasonal (S)
combinations. If the Update Replenishment
Floating Point (F)
Method flag is N, then the replenishment
Min/Max (M)
method will not be updated for any
Store Orders (SO)
item/location combinations, but will be used as
Time Supply (T)
an additional filter to determine which records
Time Supply – Issues (TI)
should be updated.
Time Supply – Seasonal (E)
Review Cycle Required; valid values are (code n/a Optional; if not specified then the review cycle
type RPRC): will not be updated.
Every Week (0)
Every Day (1)
Every 2 Weeks (2)
Every 3 Weeks (3)
Every 4 Weeks (4)
Every 5 Weeks (5)
Every 6 Weeks (6)
Every 7 Weeks (7)
Every 8 Weeks (8)
Every 9 Weeks (9)
Every 10 Weeks (10)
Every 11 Weeks (11)
Every 12 Weeks (12)
Every 13 Weeks (13)
Every 14 Weeks (14)
Update Review n/a n/a If this is set to a value of Y, then the values for
Days? the days of the week will be considered when
updating. Otherwise, they will be ignored.
Monday-Sunday One or more days of the week n/a Optional; if the Update Review Days field is not
must be selected for all review Y, then no updates will be applied, regardless of
cycle settings except Every Day whether or not values are set for the days of the
(1). In that case all days of the week.
week will be defaulted to Y. If no
values have been selected for
any day of the week for other
review cycle options, then an
error will be raised. Valid values Y
or N (default).
Primary Optional; if specified, indicates n/a Optional; if not specified then the primary pack
Replenishment the pack that should be ordered will not be updated.
Pack as part of replenishment instead
of the component item. Valid
values are approved simple packs
containing the specified item.
Default Primary Optional; if this is Y, then the n/a Optional; if not specified then the primary cost
Cost Pack pack that has been defined as the pack will not be used to update the primary
primary cost pack for the item replenishment pack.
will be defaulted to the
replenishment pack. Valid values
are Y and N (default).
Remove Pack n/a n/a Optional; indicates whether or not the primary
pack should be removed for the item/location
combinations; valid values are Y or N (default).
Update Master n/a n/a Optional; indicates whether or not the updates
Attributes being applied should also update the master
replenishment attributes for the item/location
combinations. Valid values are Y or N (default).
Validations on Update
If you select an action type of Update in the upload, then this indicates you are updating a previously created scheduled
replenishment attribute update that has not yet been executed. This could be an update that was intended to activate new
item/location combinations on replenishment, to deactivate item/location combinations, or to update existing item/location
replenishment attributes.
The key field level validations that occur when updating a scheduled replenishment update are similar to those that occur
when creating the schedule (see above), and vary based on the replenishment action: Activate, Deactivate, or Update.
However, the following are a few additional points to keep in mind when updating scheduled replenishment updates:
If field in the template is left null, the system will assume that you are intending to update the attribute to null. If it is a
required field for the replenishment method selected, this will raise an error on upload.
If a column is not present in the template, then it will not be updated.
When updating existing scheduled replenishment updates using the spreadsheet method, it is recommended that you
first download the existing scheduled updates from Merchandising, as described above, and then make your updates to
the data. This will help to minimize errors due to missing data as well as help in understanding the current settings.
When processing an update to an existing scheduled change, the Schedule ID must be included in the upload in order to
correctly process the update.
Error Resolution
If there are any issues faced while uploading the data via spreadsheet, then the status of the process is set to Processed with
Errors or Processed with Warnings in the Data Loading Status screen. Visibility to the details of the errors can be viewed in
the Replenishment Issues screen for each upload with an error. Once the errors have been corrected, the updated file may
be re-uploaded as a fresh upload request.
Errors in download processing are typically due to the inability to access the data or insufficient privileges to create and write
to the specified location. These errors can be resolved by removing any constraints that might have placed a lock on the
data or ensuring that any constraints on creation of the spreadsheet are relaxed.
Errors in upload request processing are typically data related and likely require data correction. The users can use the error
details in the Replenishment Issues screen as a guide to make corrections to the originally uploaded document or download
a new version through the Data Loading Status screen.
If using this method, a worksheet that contains a list of errors associated with the data set will be included as a separate tab
in the downloaded spreadsheet to serve as an offline reference for carrying out the corrections.
The screen shown below is an example of how the information is displayed for the worksheet that had the error, which row
in the worksheet is in error, and a short description of the issue. Once the errors have been corrected, the data can be re-
uploaded into Merchandising as needed, using the corrected file.
While using the bulk upload, this will not have notifications in the case of errors in the upload, but the status of the process
will be available on Data Loading Status screen, similar to the spreadsheet upload. To see the details of the errors externally,
the process status table SVC_PROCESS_TRACKER and the replenishment upload error table CORESVC_REPL_ERR will be
exposed to the retailers by replicating them in the Data Access Schema (DAS).
In the case of the web service option, the processing of these messages will happen synchronously. If there are any
validation errors, the details will be returned to the calling system.
Note: If there are data validation errors in web service upload, these errors will also be visible
in the Data Loading Status screens.
Action Yes For this scenario, the option would be Create. Other options include
Update and Delete.
Schedule ID No Will be generated by the system and ignored, if specified for Create.
Schedule Description No If not specified, the following auto generated description will be used:
'Scheduled Replenishment for <item> at <location>’
Effective Date No When creating a new scheduled update, this needs to be a value equal
to or greater than the current date.
Will be defaulted to the current date, if not specified.
Scheduled Action Yes For this use case, we are activating this item/location on
replenishment, so the Schedule Action will be A = Activate
Location Type Yes Valid values are All Stores, All Warehouses, Store, or Warehouse. For
this example, assume that Store is selected.
Location Yes Should be a valid store, since that was the entered location type
Auto Range Indicator Yes This determines whether or not to create the item/location
relationship in Merchandising when the attributes are uploaded, if it
doesn’t already exist. It will be assumed to be N if not specified.
Deactivate Date No Assume that this is not entered for activation, but it can be if desired.
If specified, it must be greater than the activate date and also greater
than the current business date + 1.
Replenishment Method Yes In this example, Min/Max will be used. Otherwise, other
replenishment options can be selected from the drop down.
Stock Category Yes Valid Values here are: Cross-docked, Direct to Store, PO Cross-link, or
Warehouse Stocked. For this example, let’s assume that Warehouse
Stocked is selected.
Order Control Yes Valid values here are: Automatic, Semi-Automatic, Buyer Worksheet,
or Manual
Source Warehouse Yes Must be a valid virtual warehouse for the item. In this case, it’s
assumed that the item is already ranged to this warehouse. Auto-
ranging does not apply.
Lead Time - WH to Receiving Yes Number of days it takes for the item to be shipped from the source
warehouse to the store.
Review Cycle Yes Options include Every Day, Every Week, or Every X Weeks, where x
can be 2-14. If Every Week or Every X Weeks is selected, then select
one or more of the days of the week when the review should occur on
the reviewed week. For Every Day, all the days of the week should be
Yes.
Update Master Attributes Yes Set this to ‘Yes’ if you want these attributes to be considered the
“master” for this item/location. This can be used to “reset” the
item/location at a future date, if temporary updates are made.
It will be defaulted to ‘No’ for the ‘Create’ if not specified.
Action Yes In this case, we are creating a new schedule update that will Update
replenishment attributes. So, this should be “Create”.
Schedule ID Yes Will be generated by the system and ignored, if specified for Create.
Effective Date No Needs to be a value equal to or greater than the current date.
Will be defaulted to the current date, if not specified.
Class Yes Must be a valid class for the specified department in Merchandising.
Update Replenishment Method Yes Because in this example we are not changing the replenishment
method, we will set this to No, so that the method is used just for
determining which items to update.
Update Master Attributes Yes Could be Yes or No for this example, depending on whether this is going
to become the new “master” setting or if it is a temporary change.
Update From Master Attributes Yes In this scenario, this would be No, as it is making a specific update, not
resetting all the attributes from the master.
Maximum Chunk Size This specifies the maximum number of replenishment records that can be
processed in one chunk.
Maximum Threads This is the maximum number of threads that should be spawned for the
replenishment induction package.
Wait Between Threads This is the number of milliseconds between the submissions of two threads.
Maximum Records for Download This is the maximum number of replenishment orders that can be
downloaded using a spreadsheet. If the criteria selected for downloading
results in a larger number of records than this value being downloaded, an
error will be raised.
Maximum Records for Synchronous This is the maximum number of replenishment records that can be
Download downloaded using a spreadsheet in a synchronous fashion. Beyond this
threshold, the process is submitted as an asynchronous process.
Maximum Records for Upload2 This is the maximum number of replenishment orders that can be
uploaded using a spreadsheet or bulk load. If the file exceeds this many
records, then it will be rejected.
Maximum Records for Synchronous Upload This is the maximum number of replenishment records that can be
uploaded using a spreadsheet in a synchronous fashion. Beyond this
threshold, the process is submitted as an asynchronous process.
2It is recommended that file sizes be kept to less than .75GB for best performance. This equates to 800,000,000 records in
the upload.
16 Replenishment Attribute Update Overview] Release 19.0.x
Copyright © 2020, Oracle and/or its affiliates
CONNECT WITH US
Call +1.800.Oracle1 or visit oracle.com
Outside North America, find your local office at oracle.com/contact
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC
International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The
Open Group. 0120