Professional Documents
Culture Documents
Specification (Kroger).
Revision: V3.1k
May 13, 2020
i
Data Transfer Spec.
Table of Contents:
1. INTRODUCTION. .................................................................................................................................... 1
1.1. ITEM INCLUSION:.................................................................................................................................. 1
1.2. BACK DATA: ........................................................................................................................................ 1
1.3. REFERENTIAL INTEGRITY: .................................................................................................................... 1
1.4. CHANGES FROM V1.1: .......................................................................................................................... 1
1.5. SUBSCRIPTION LEVEL........................................................................................................................... 2
1.6. SUMMARY OF FILES.............................................................................................................................. 3
1.7. FILE FORMATTING. ............................................................................................................................... 4
1.8. MISC: ................................................................................................................................................... 4
1.9. DATA TRANSMISSION. .......................................................................................................................... 5
2. MASTER FILES........................................................................................................................................ 6
2.1. CASE MASTER. ..................................................................................................................................... 6
2.2. ITEM MASTER. ..................................................................................................................................... 7
2.3. STORE MASTER. ................................................................................................................................... 8
2.4. WAREHOUSE MASTER. ......................................................................................................................... 9
2.5. STORE PRODUCT MASTER. ..................................................................................................................10
3. STORE DATA. .........................................................................................................................................11
3.1. DAILY POS, DAILY POS RESTATEMENT, AND DAILY POS HISTORY....................................................11
3.2. EXPECTED PRICE. ................................................................................................................................12
3.3. SALES PLAN. .......................................................................................................................................13
3.4. STORE BALANCE ON HAND, SHELF. .....................................................................................................15
3.5. STORE DELIVERIES. .............................................................................................................................16
3.6. DERIVED OUT OF STOCK EVENTS (FORMERLY SHELF SCAN AUDIT) ....................................................16
3.7. WEEKLY COMPETITIVE POS SALES FILE .............................................................................................17
3.8. AD WEEKLY COMPETITIVE POS SALES FILE .......................................................................................18
3.9. DAILY STORE AUTHORIZATION AND PLANOGRAM ASSOCIATION ........................................................19
4. WAREHOUSE DATA. .............................................................................................................................19
4.1. WAREHOUSE INVENTORIES. ................................................................................................................19
4.2. WAREHOUSE ORDERS. ........................................................................................................................21
4.3. WAREHOUSE SUBSTITUTIONS. .............................................................................................................22
5. DEMANDVIEW MEASURES. ................................................................................................................23
5.1. DEMANDVIEW STORE MEASURES. ......................................................................................................23
5.2. DEMANDVIEW STORE FORECASTS.......................................................................................................25
5.3. DEMANDVIEW WAREHOUSE MEASURES. ............................................................................................27
5.4. DEMANDVIEW WAREHOUSE FORECASTS.............................................................................................27
6. CONTROL DATA. ...................................................................................................................................28
6.1. MANIFEST. ..........................................................................................................................................28
6.2. ZIP CONTAINER. ..................................................................................................................................28
ii
Data Transfer Spec.
Revision History
Revision Date Author Purpose of Revision
V1.1f 04/16/2011 Wayne Levy In spreadsheet form.
V1.2 04/28/2011 Brian Rock Converted to document form.
Various cosmetic field name changes.
Include Warehouse identifier with Local Vendor ID to ensure
validity.
Added DV_Ad_Type field to DemandView Store Measures file.
V1.2a 04/29/2011 Brian Rock Sales Plan file frequency will be daily, not weekly.
Store Master file frequency will be ‘on change’, not weekly.
Item Master file frequency will be ‘on change’, not weekly.
V1.2b 05/02/2011 Brian Rock Fixed a duplicate field name, On_Order_Qty, in DemandView Store
Forecasts file.
Renamed and clarified the meaning of Fcast_Store_Order_Qty field
in DemandView Warehouse Measures.
V1.2c 05/16/2011 Brian Rock Added section 1.8 Data Transmission.
All master files now sent with daily frequency.
Expanded Ad_Type_Code_2 definition in Sales Plan file.
Conformed DV_Ad_Type in Sales Plan file to the definitions in
DemandView Store Measures and Forecast files.
Updated the definition of all DV_Ad_Type fields.
Store Master Mgt_Zone changed to Varchar(2).
V1.2d 06/08/2011 Brian Rock Removed key field indicators from Store Deliveries file layout.
V1.2e 05/13/2020 Brian Rock
V1.2f 07/24/2013 Jim Martin Updated section 2.1 Case Master to include Consumer UPC
Updated section 3.4 Store Balance on Hand for history
Added section 3.6 Shelf Scan Audit
Added section 3.7 Weekly Competitive Sales File
Updated section 4.1 Warehouse Inventories to include Case Pack
and Store Quantities
Updated section 5.1 DemandView Store Measures to default alert
values to “0”
iii
Data Transfer Spec.
1. Introduction.
What follows is Version 1.2h of the specification for standard Data Transfer file layouts.
For DSD items, the association between Kroger Corporate Vendor Codes and items is made by individual store.
A Market6 Customer ID is, in turn, associated with a collection of Kroger Corporate Vendor Codes and this association
drives selection of the items included in a set of Data Transfer files.
Note that a Kroger Corporate Vendor Code may be associated with one or more local Kroger Warehouse Vendor ID’s, which
will likely differ across warehouses.
A Kroger Corporate Vendor Code may also be associated with one or more D&B Vendor Codes when the relevant products
are DSD.
The same may be true for POS history, which may contain items or stores that are no longer reflected in current masters.
Every effort has been made to include stores in the store master that have closed over the past two years or so, but it is
conceivable that some may have been missed.
All Master Files will be provided every day, even when the file is received from Kroger on a weekly basis, so that new
information will be forwarded as soon as available. For example, the Kroger Corporate Vendor Codes associated with a
customer may change mid-week, resulting in updated Item Master information.
Other minor changes have been listed along with file definitions.
1
Data Transfer Spec.
The following table lists each Data Transfer file type, the Subscription Level at which each file is available, along with the
frequency of each file.
2
Data Transfer Spec.
WAREHOUSE DATA
Warehouse Inventories Daily Warehouse inventories. whs_boh_DATATRANSID_yyyyMMddhhmmss.fil
Warehouse Orders Daily Orders from the Kroger Warehouse to Vendors. whs_orders_DATATRANSID_yyyyMMddhhmmss.fil
3
Data Transfer Spec.
1.8. Misc:
In the tables below that define file layouts, please note that green highlighted rows represent key fields. Deprecated fields have a red highlight, and new fields
have a blue highlight.
4
Data Transfer Spec.
1. SFTP.
Customers should obtain the 84.51° server URL, and a user ID and password from their Client Service representative. If
customers prefer to authenticate by means of a digital certificate, that can also be accommodated.
Upon login, customers will be placed in their home directory on the 84.51° server.
A new data extract file will be placed in the customer’s SFTP home directory each day. This file will be a zip compressed file
containing 19 payload files as described herein.
The zip file will have a filename in the format {DATATRANSID}.zip, where {DATATRANSID} will be a unique number.
After a successful download and integrity check, 84.51° recommends that customers delete the file from the server. Doing so
will eliminate the need for customers to maintain logic on their side to prevent downloading a file more than once.
84.51° will remove to archive any file that remains in a customer’s SFTP home directory for more than 7 days.
5
Data Transfer Spec.
2. Master Files.
Notes:
Includes only warehoused products.
Case pack from the Vendor’s perspective should be (Store_Pack * Inner_Pack_Qty), except for Peyton warehouses, but this is
not always the case in the data received from Kroger. For Peyton warehouses, no true case pack or case pack calculation is
provided by Kroger.
84.51° is working to get true Vendor-perspective case pack information and will add a corresponding field as soon as feasible. A
field with the Consumer UPC contained within the case may also be added in a future version.
6
Data Transfer Spec.
Notes:
A given Base UPC may include more than one Consumer UPC.
7
Data Transfer Spec.
8
Data Transfer Spec.
Notes:
Kroger stops sending master data when a store closes, so the data for closed stores is accurate only as of the last date for which
information was received from Kroger.
May add a Store_Name field if enough customers request it. Deprecated fields would be eliminated at the same time.
Notes:
None.
9
Data Transfer Spec.
Notes:
A given Base UPC may include more than one Consumer UPC.
Some DSD items may not be included in this file.
10
Data Transfer Spec.
3. Store Data.
3.1. Daily POS, Daily POS Restatement, and Daily POS History.
File name: daily_pos_{DATATRANSID}_{yyyyMMddhhmmss}.fil
File name: daily_pos_restate_{DATATRANSID}_{yyyyMMddhhmmss}.fil
File name: daily_pos_hist_{SEQ#}_{DATATRANSID}_{yyyyMMddhhmmss}.fil
Notes:
Restatement file includes previous days that were restated by Kroger. The number of such days is governed by a Customer-
specific parameter which defaults to 28 days.
In the history (back data) file name, {SEQ#} refers to a sequence number. This enables the data to be broken up into smaller
files, rather than a single, monolithic file that may exceed size constraints.
11
Data Transfer Spec.
Notes:
None.
12
Data Transfer Spec.
Notes:
Some ad attributes may be blank for some promotions.
13
Data Transfer Spec.
14
Data Transfer Spec.
Notes:
This file will include the latest data that 84.51° receives from Kroger, which may not include all stores on a given day. This
happens because Kroger is not always able to acquire the data from all stores in time for the daily file transmission. It is possible
that some data will therefore be missing from each daily file.
15
Data Transfer Spec.
Notes:
Currently only includes deliveries from Warehouses. DSD deliveries will be added in future.
This data is transactional in nature; therefore ‘key’ fields are not appropriate.
Notes:
This feed has been repurposed from publishing “shelf scan audit events” as Kroger has discontinued wholesale collection of this
information across all of their divisions. This feed now contains the Kroger approved Market6 derived out of stock events.
This feed includes only items for which the supplier is the brand owner. Competitive items are not available in the file.
16
Data Transfer Spec.
17
Data Transfer Spec.
18
Data Transfer Spec.
4. Warehouse Data.
19
Data Transfer Spec.
Notes:
There may be more than one inventory measurement per day in some warehouses. These are independent observations,
distinguished by the Inventory_Date_Time field, and should not be aggregated.
20
Data Transfer Spec.
Notes:
An order is overdue if Ref_Date > Order_Due_Date.
21
Data Transfer Spec.
Notes:
A value of ‘000’ in Div_No indicates that the rule applies to all Divisions when serviced by the applicable Warehouse.
22
Data Transfer Spec.
5. DemandView Measures.
23
Data Transfer Spec.
Notes:
None.
24
Data Transfer Spec.
Notes:
Measures in light blue background will not be available in release 1.2, but will be included later, along with other measures
based on customer feedback.
The flag measures will have a value of 9, until they are included.
The unit measures with have a value of 0, until they are included.
25
Data Transfer Spec.
26
Data Transfer Spec.
Notes:
None.
Notes:
None.
27
Data Transfer Spec.
6. Control Data.
6.1. Manifest.
File name: manifest_{DATATRANSID}_{yyyyMMddhhmmss}.fil
Notes:
None.
All other files will be delivered in a single, container .zip file named as above.
This file name can be customized in limited fashion to include custom text as follows:
{DATATRANSID}.{Custom Text}.zip
28