DATA SERVICES | FTP

Inventory Specification

Implementation Guide
Version 2, Release 13

June 14, 2021

Copyright© Ingram Data Services Inc. All rights reserved.

 Table of Contents
Overview ......................................................................................................................................................... 3
StockV2 Implementation ............................................................................................................................... 4
Maintaining the Data ....................................................................................................................................................................... 4
Data Filtering................................................................................................................................................................................... 5
StockV2 File Specification Overview ........................................................................................................... 6
Stockv2 File Specification ........................................................................................................................... 11
Inventory Supplemental Files ..................................................................................................................... 15
Inventory Country Exclusion file .................................................................................................................................................. 15
Inventory Estimated Time of Arrival (ETA) File .......................................................................................................................... 16
Inventory International Price File .................................................................................................................................................. 17
Inventory Removal File ................................................................................................................................................................. 18
Proposition 65 Warnings File ........................................................................................................................................................ 19
Publisher Sales Rights ................................................................................................................................................................... 20
Frequently Asked Questions ...................................................................................................................... 23
Glossary ........................................................................................................................................................ 24
Document History ........................................................................................................................................ 25
Contacts ........................................................................................................................................................ 25
Overview
The purpose of the inventory files is to supply Ingram Content Group customers with the necessary data fields to
update title availability electronically. Bibliographic and classification data, such as title, author, subject, binding
and additional data elements like images, title descriptions, desirability, contributor biographical information, etc.
are also available for subscription. Please contact IDS Sales for more information.

This document includes file descriptions and a layout specification for the StockV2 and supplemental files, as well
as file and field usage tips.

• The StockV2 files provide inventory availability for all Ingram titles that are available to sell. The
inventory files can be very large (average 4GB), are available in a fixed-width text file format, and are
downloaded from the Ingram FTP server. We have created all files in a single format for ease of
development with a database or similar application. The inventory files provide a snapshot of available
inventory and therefore, do not guarantee that the title will be available during order processing.

o The StockV2 file is offered in several options – please see the File Description Table for more
information on the available files.
o The file layout specification can be found in StockV2 File Specification section of this document.

• The supplemental files, also available for download from the Ingram FTP server, contain additional
inventory information. Please click on the links below to learn more about each of these files.

o Inventory Country Exclusion file - country excluded for sale of the title

o Inventory Estimated Time of Arrival (ETA) file - predicted estimated time of arrival of title in an
Ingram Distribution Center

o International Price file - publishers international suggested retail price

o Inventory Removal File – titles no longer stocked by Ingram

o Proposition 65 File – titles with California Prop 65 information for hazardous materials

o Publisher Sales Rights – multiple files – identify if a title can be sold in a country or territory

Document Version and Change Management

There are two levels of version control used in our documentation, version X release X, where X represents the
number of the sequential version or release of the document. We use "version" to describe a milestones that we have
achieved in our effort to provide more services to our customers. A particular version either identifies a major
change in the file specification or new functionality. We use "release" to communicate the levels of revision to the
current file specification and or functionality.
• A major release will contain significant upgrades in functionality, which will require changes to our
existing file specifications, e.g., expanded record length. This release will be identified by a change in the
version numbering sequence, e.g., version 1 release 0 changing to version 2 release 0. In this case, the
previous version is no longer supported. Therefore, you are required to make changes to your system even
if you do not wish to take advantage of the new features.
• A revised release refers to a minimal change, e.g., additional fields that do not affect the overall record
length, or the addition of new files. A revised release will be identified in the release numbering sequence,
e.g., release version 2release 0 changing to version 2 release 1. Please evaluate each release to determine if
your business model requires implementation of the changes.
All changes are reported in the Document History section of this guide. We will notify your technical contact, via
email, when new functionality and versions are available. Please contact the IDS integration team to review or
update your technical contact information.

Data Services | FTP, Inventory Implementation Guide 3

StockV2 Implementation
In this section, you will find information about integration; maintaining data accuracy, a sample file ingestion
process strategy, and filtering of the data found in the inventory files. The average integration time varies per
customer: speed of integration is contingent on your resources.

We recommend that you begin development as soon as you have reviewed the implementation guide, determined a
plan to maintain the accuracy of the data, and have identified any data filtering that is required for your business
needs.

Maintaining the Data

It is critical to maintain the accuracy of the data, because out-of-date and inaccurate data can lead to poor customer
experiences and a potentially lengthy update process. Once you have a plan, we recommend that you develop an
automated processing schedule, with error alerts, to complete updates in a timely manner to prevent inaccurate data.
Getting Started
1. Determine how you will maintain the accuracy of the data. See the table below for some suggestions and the
processing schedule sample for examples.
2. Please see the data file description table for more information about the different files that are available. Please
review options carefully to select the best choice for your business needs.
3. Download selected files and code translation files. Samples files are available upon request.
4. Create tables based on the file specifications. Sample SQL create table and import scripts are available upon
request.
5. Import data into a database or similar application.
6. Create links to other data using the primary key.
7. The remaining steps will vary based on your systems.

Here are some suggestions for maintaining the accuracy of the data:
# Desired Result Suggestion
1 Maintain up-to-date inventory levels on all titles with Download the Full and Delta files up to six times daily. This will maintain
faster processing. up-to-date inventory. The Delta files report deleted or discontinued titles,
once. These records, called "zero" records, and contain zeros ("0"), spaces /
blanks, and no's ("N") in all fields. You must process all Delta files so that
you will not miss any of these records.
2 Maintain up-to-date inventory levels with faster Download the first Full file one time only and all sequential Delta files.
processing.
3 Update only titles that have been added, changed, or Same as # 2.
have been deleted since the last inventory file.
4 Update inventory levels once daily. Download the Full file once and the daily Delta file.
5 Refresh active titles, which will remove Ingram as the If an title is not found in a Full file or if you receive a Delta "zero record,
supplier for titles no longer carried. the title is no longer available from Ingram.
6 Maintain up-to-date inventory levels on the Slice We provide a Data Slice Full file once weekly. We recommend that you use
inventory. the daily Delta files to maintain the inventory availability.
7 Miss some delta files? Use one of the stockv2remove* files. See page X for more information.

Data Services | FTP, Inventory Implementation Guide 4

Data Filtering
In this section, you will find information about filtering data, which is useful if you want to limit the titles that will
be made available to your customers or have limitations based on your data license.

Some benefits for filtering:

• Decreased time to perform table updates.
• Easier to maintain data integrity.
• Improved system performance and customer response time.
• Reduced disc consumption.

Data filtering can be accomplished in a variety of ways. Based on the ever-growing number of titles provided by
Ingram, we recommend the following:
• All data can be filtered prior to or at the time it is loaded into your tables.
• Filtering can and should be applied to all files, except for reference files.

Here are some common data filters (sorted - in no particular order):

# Desired Result Example Filter
1
1 Only show titles that are currently available to sell (or La Vergne, TN On-Hand Quantity > "00000000" and (On Sale Date
in stock). =< "current date" or = "00010101") and the title is not restricted.
2 Only show titles currently carried in one of the four DC's. Stocked in the La Vergne DC - La Vergne, TN Stock Flag = "Y"
3 Show titles that are temporarily out of stock (OS) and can La Vergne, TN On-Hand Quantity = "0000000", La Vergne, TN On-
be backordered in the La Vergne DC. Order Quantity > "0000000" and La Vergne, TN Stock Flag = "Y"
4 Show titles that can be pre-ordered or that have not yet La Vergne, TN On-Hand Quantity >= "00000000" and
published / released (NYP / NYR). (Publication Date > "current month" or the On Sale Date > "current
date")

For title with an On Sale Date – Ingram can receive On-Hand

quantities up to 14 days prior to the On Sale date. It is important that
you do not show these titles as "available" until the On Sale date has
passed, regardless if the On-Hand quantity is greater than "0000000".
5 Show titles that are carried in the La Vergne DC that La Vergne, TN On-Hand Quantity > "00000000"
have an On-Hand quantity greater than "0".
6 Show titles that are available in the Roseburg DC that Roseburg, OR Stock Flag = "Y", Roseburg, OR
have a Price less than $20.00. On-Hand Quantity > "0" and Price < "0002000"
7 Locate titles where a backorder is required. Backorder Only Indicator <> ("N")
8 Show only titles that are returnable. Returnable Indicator = "Y" and Return Date > "current date".

The Return Date is the date on which the title must be returned to
Ingram. Please allow plenty of time for shipment and receipt at an
Ingram DC.
9 Determine if a title is not returnable. Return Date = "00010101" or > "current date" and Returnable
Indicator = "N"
10 How do I filter titles that are restricted to sell? You are responsible for excluding restricted titles for sale in your
system. The Ingram ordering systems will block the title from order
fulfillment.

Please use the Restricted Code and the Country Exclusions files to
determine which titles are restricted for sale. Each title restriction
depends on the Publisher. You can use the Country Exclusion file to
determine which countries are excluded from purchasing/selling
specific titles.

1
Filtering for On-Hand Qty titles only to build your title offering may lead to an unsatisfactory customer experience – as your offering will change frequently. It is
recommend that you show all titles carried regardless of the inventory level and add a message to your customer regarding availability (e.g., "Available to ship", "Title
is temporarily out of stock", "Pre-Orders are now being taken" or "Reserve your copy today"). You can use the Product Availability Code (position 272-273) in
addition to the On Hand Qty (positions 039-094) and On Sale Date (position 197-204) fields to assist with assigning the proper status.

Data Services | FTP, Inventory Implementation Guide 5

StockV2 File Specification Overview
In this section of the document, you will find detailed information regarding the StockV2 file; file delivery method,
file descriptions and update frequency, sample processing schedule for maintaining data integrity and the file layout
specification.

File Delivery
The inventory files can be downloaded from the Ingram FTP server.

FTP Folder
• \Inventory
• \Inventory_Top_Titles (International Only)
• \Slice – file is available in the data slice folder.

FTP Server Availability and Notification

The FTP server is available 24 hours, seven days a week, with a twice-weekly scheduled maintenance windows. If
the server will be unavailable for any reason other than the scheduled maintenance windows listed below -
notification will be sent via email to the technical contact listed on your account profile.
FTP Maintenance Schedule
Day Duration
Saturday - Sunday 11:00 p.m. – 05:00 a.m. CDT
Friday 06:00 a.m. – 06:30 a.m. CDT

File Description Table File Name Column Key

• Slice *- in the file name column denotes the three character slice prefix of a pre-defined data slice, e.g., Top
250k Slice = [email protected]

• x - in the file name column signifies the sequential daily run – "a" indicates the 1st file generated, "b" (2nd
file) and so on, up to "f". e.g., [email protected]

• YYMMDD or YYYYMMDD - in the file name column represents the date the file was created, e.g.,
[email protected] or dly_stkv2delta20120630.zip

File Description Table Full/Delta and File Type Key

• Full/Full – this file contains all available to sell titles.
• Full/Part – indicates that the file contains a subset of titles that are available to sell. Please see the data file
name or description for more information.
• Delta/Full – this file contains incremental changes of a Full file.
• Delta/Part – this file contains incremental changes of a Part file.

*
Only available for data slice subscriptions, please contact IDS Sales for more information

Data Services | FTP, Inventory Implementation Guide 6

 File Availability Grid
Data File Description File Name Avg Full / File
Size Delta Type
1 StockV2 Full This is the "master" file, which contains all active [email protected] 4GB full full
Ingram titles that are available to sell and is generated
six times per day. The file name is overwritten, but the
"date modified" will change.

You are responsible for the additional filtering of titles

that are not available to sell based on the publishers
request or in a particular country. Please see the
Restricted Code and County Exclusion file for
assistance with identifying restrictions.

As of June 2012, the size of this file is over 4GB and is

expected to grow significantly over the next year.
Therefore, this file requires adequate resources for
processing.
2 StockV2 Full This Full file contains books, bibles, and gift & game [email protected] 6MB full part
- Spring titles for the Christian Market (Spring Arbor).
Arbor
3 StockV2 This Delta file contains all incremental updates for titles [email protected] delta full
Delta where select fields have changed, a record has been
added, or deleted since the previous file was created.

This file is created by comparing the current and

previous master files (StockV2 Full). A unique file
name is used for each new file.
4 StockV2 This Delta file contains incremental updates for titles dly_stkv2deltayYYYYMMDD.zip delta part
Daily Delta where any field may have changed, a record has been
added, or deleted since the previous file was created. A
unique file name is used for each new file.
5 StockV2 This Delta file contains incremental updates for titles wkly _stkv2deltaYYYYMMDD.zip delta part
Weekly Delta where any field may have changed, a record has been
added, or deleted since the previous file was created. A
unique file name is used for each new file.
6 StockV2 Part This Full file contains a subset of books, bibles, and gift [email protected] 1GB full part
One Full & game titles. Please see the other "part files" for public
domain reproduction, compilation, digital, media, or
music titles. The file name is overwritten, but the "date
modified" will change.
7 StockV2 Part This Delta file contains incremental updates for books, [email protected] delta part
One Delta bibles, and gift & game titles. A unique file name is
used for each new file.
8 StockV2 Part This once daily Delta file contains incremental updates dly_stkv2pt1YYYYMMDD.zip delta part
One Daily for books, bibles, and gift & game titles. A unique file
Delta name is used for each new file.
9 StockV2 Part This once weekly Delta file contains incremental wkly _stkv2pt1YYYYMMDD.zip delta part
One Weekly updates for books, bibles, and gift & game titles. A
Delta unique file name is used for each new file.
10 StockV2 Part This Full file contains all public domain reproduction or stkv2pt2_fileXofX.zip 400M full part
Two Full compilation titles and is available in five separate files B
for faster downloads, each file size is approximately
400MB. The file name is overwritten, but the "date
modified" will change.
11 StockV2 Part This Delta file contains incremental updates for all [email protected] delta part
Two Delta public domain reproduction or compilation titles. A
unique file name is used for each new file.
12 StockV2 Part This once daily Delta file contains incremental updates dly_stkv2pt2YYYYMMDD.zip delta part
Two Daily for public domain reproduction or compilation titles. A
Delta unique file name is used for each new file.

Data Services | FTP, Inventory Implementation Guide 7

 Data File Description File Name Avg Full / File
Size Delta Type
13 StockV2 Part This once weekly Delta file contains incremental wkly _stkv2pt2YYYYMMDD.zip delta part
Two Weekly updates for public domain reproduction or compilation
Delta titles. A unique file name is used for each new file.
14 StockV2 This Full file contains inventory data for library market [email protected] 100M full part
Digital Full digital titles, restricted use. The file name is overwritten, B
but the "date modified" will change.
15 StockV2 This Delta file contains incremental updates for titles [email protected] delta part
Digital Delta where any field may have changed, or a record has been
added, or deleted, for digital titles. A unique file name is
used for each new file.
16 StockV2 This once daily Delta file contains incremental updates dly_stkv2digYYYYMMDD.zip delta part
Digital Daily for digital titles. A unique file name is used for each
Delta new file.
17 StockV2 This once weekly Delta file contains incremental wkly_stkv2digYYYYMMDD.zip delta part
Digital updates for digital titles. A unique file name is used for
Weekly Delta each new file.
18 StockV2 This Full file contains inventory data for media titles [email protected] full part
Media Full (video, video games and software related titles) which
includes product type "K"=Video and "S"=Software.
The file name is overwritten, but the "date modified"
will change.
19 StockV2 This Delta file contains incremental updates for titles [email protected] delta part
Media Delta where any field may have changed, or a record has been p
added or deleted, media titles. A unique file name is
used for each new file.
20 StockV2 This once daily Delta file contains incremental updates dly_stkv2mdaYYYYMMDD.zip delta part
Media Daily for media titles. A unique file name is used for each new
Delta file.
21 StockV2 This once weekly Delta file contains incremental wkly _stkv2mdaYYYYMMDD.zip delta part
Media updates for media titles, includes product type "X" =
Weekly Delta Music. A unique file name is used for each new file.
22 StockV2 This Full file contains inventory data for music titles. [email protected] 120M full part
Music Full The file name is overwritten, but the "date modified" B
will change.
23 StockV2 This Delta file contains incremental updates for titles [email protected] delta part
Music Delta where any field may have changed, or a record has been p
added, or deleted music titles. A unique file name is
used for each new file.
24 StockV2 This once daily Delta file contains incremental updates dly_stkv2musYYYYMMDD.zip delta part
Music Daily for music titles. A unique file name is used for each new
Delta file.
25 StockV2 This once weekly Delta file contains incremental wkly _stkv2musYYYYMMDD.zip delta part
Music Weekly updates for music titles. A unique file name is used for
Delta each new file.
26 StockV2 Slice This Full file contains inventory data for all titles in a [email protected] varies full part
Full specific data slice. The file name is overwritten, but the
"date modified" will change.

Data Services | FTP, Inventory Implementation Guide 8

File Availability Grid

Monday Tue sday We dne sday Thursday Friday Saturday Sunday

a.m. p.m. a.m. p.m. a.m. p.m. a.m. p.m. a.m. p.m. a.m. p.m. a.m. p.m.
Data File 1 5 9 1 5 9 1 5 9 1 5 9 1 5 9 1 5 9 1 5 9 1 5 9 1 5 9 1 5 9 1 5 9 1 5 9 1 5 9 1 5 9
1 StockV2 Full x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x
2 StockV2 Spring Arbor Full x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x
3 StockV2 Delta x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x
4 StockV2 Daily Delta x x x x x x x
5 StockV2 Weekly Delta x
6 StockV2 Part One Full x x x x x x x
7 StockV2 Part One Delta x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x
8 StockV2 Part One Daily Delta x x x x x x x
9 StockV2 Part One Weekly Delta x
10 StockV2 Part T wo Full x x x x x x x
11 StockV2 Part T wo Delta x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x
12 StockV2 Part T wo Daily Delta x x x x x x x
13 StockV2 Part T wo Weekly Delta x
14 StockV2 Digital Full x x x x x x x
15 StockV2 Digital Delta x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x
16 StockV2 Digital Daily Delta x x x x x x x
17 StockV2 Digital Weekly Delta x
18 StockV2 Media Full x x x x x x x
19 StockV2 Media Delta x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x
20 StockV2 Media Daily Delta x x x x x x x
21 StockV2 Media Weekly Delta x
22 StockV2 Music Full x x x x x x x
23 StockV2 Music Delta x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x
24 StockV2 Music Daily Delta x x x x x x x
25 StockV2 Music Weekly Delta x
26 StockV2 Slice Full x

Please note: All times are central time (CT) and are subject to change without notice. If a file is not available at the time specified, please check back at 15-minute intervals – as it may have been delayed due to
unforeseen circumstances.

Data Services | FTP, Inventory Implementation Guide 9

Inventory File Sample Processing Schedules
There are many different options for using the inventory files. Here are a few examples.

One full daily with all full delta files *

Monday Tuesday Wednesday Thursday Friday Saturday Sunday

Files represented: [email protected] [email protected]

Part One and Part Two full files once weekly with daily delta files
Monday Tuesday Wednesday Thursday Friday Saturday Sunday

Files represented: [email protected] stkv2pt2_fileXofX.zip dly_stkv2deltaYYMMDD.zip

One full weekly with once daily delta files

Monday Tuesday Wednesday Thursday Friday Saturday Sunday

Files represented: [email protected] dly_stkv2deltaYYMMDD.zip

One full monthly with once weekly delta files

File Key
Mon Tue Wed Thu Fri Sat Sun
Full files
April 30 May 1 2 3 4 5 6 [email protected]
[email protected]
stkv2pt2_fileXofX.zip
7 8 9 10 11 12 13
Delta files
[email protected]
dly_stkv2deltaYYMMDD.zip
14 15 16 17 18 19 20
wkly_stkv2deltaYYMMDD.zip

21 22 23 24 25 26 27
* The Delta files report titles that are no longer carried by sending a zero record, once.
These records that contain all zeros ("0"), spaces / blanks, and no's ("N") in all fields. You
28 29 30 31 June 1 2 3 must process all Delta files so that you will not miss any of these records.

Files represented: [email protected] wkly_stkv2deltaYYMMDD.zip

Data Services | FTP, Inventory Implementation Guide 10

Stockv2 File Specification
This file specification adheres to the following:

• File Format: fixed-width text file

• Record Length: 301 characters
• Text Qualifier: none
• Line Terminator: carriage return line feed
• Numeric Fields: right justified and zero filled
• Decimal: two decimals implied for all Price and Weight fields
• Date/Time Format: YYYYMMDD
• Field Format Key:
o A, N – Alpha Numeric (Text / String)
o DT – Date / Time
o N – Numeric

Position Length Format Field Name Description

1 1 A, N GTIN Prefix This is the Global Trade Item Number Prefix

(GTIN). A "0" represents a single unit and is
currently the only prefix defined for the book
industry. Add the GTIN Prefix to the EAN to
convert EAN to GTIN-14, no recalculation of the
check digit required.

2 – 14 13 A, N EAN EAN or ISBN – 13. The Bookland International

Article Number is the Ingram Primary Item
Identifier, will be present on ALL titles, and can be
used to link to other Ingram data files.

Please note: For titles that are not assigned an

EAN, Ingram will use the UPC with a leading zero.

15 – 28 14 A, N UPC Universal Product Code, item identifier, which has

been converted to the GTIN-14 form – prefixed
with two zeros. No recalculation of check digit is
required.

29 – 38 10 A, N ISBN-10 International Standard Book Number (ISBN-10), a

10-digit item identifier, used for books published
before 2007.

39 – 45 7 N La Vergne, TN On-Hand Quantity available to sell in the Distribution Center

Quantity (DC) specified in the "field name" column.

46 – 52 7 N Roseburg, OR On-Hand Quantity See description above.

53 – 59 7 N Ft. Wayne, IN On-Hand Quantity See description above.

60 – 66 7 N Chambersburg, PA On-Hand See description above.

Quantity

67 – 73 7 N Allentown, PA On-Hand Quantity See description above.

74 – 80 7 N Fresno, CA On-Hand Quantity See description above.

81 – 87 7 N DC On-Hand Quantity See description above.

88 – 94 7 N DC On-Hand Quantity Reserved for future use.

95 – 101 7 N La Vergne, TN On-Order Quantity On-Order with the supplier in the DC

Quantity specified in the "field name" column.

102 – 108 7 N Roseburg, OR On-Order Quantity See description above.

109 – 115 7 N Ft. Wayne, IN On-Order Quantity See description above.

Data Services | FTP, Inventory Implementation Guide 11

 Position Length Format Field Name Description

116 – 122 7 N Chambersburg, PA On-Order See description above.

Quantity

123 – 129 7 N Allentown, PA On-Order See description above.

Quantity

130 – 136 7 N Fresno, CA On-Order Quantity See description above.

137 – 143 7 N DC On-Order Quantity See description above.

144 – 150 7 N DC On-Order Quantity Reserved for future use.

151 – 157 7 N Price This is the U.S. Suggested Retail Price (SRP) and
is the highest list price in any active Distribution
Center (DC). This is the Price that Ingram uses for
account billing purposes and is most widely used
as the MSRP. Two decimals are implied. Format:
"0001495" = $14.95

158 – 164 7 N Publisher Price The U.S. Publisher Supplied Price.

Please note: Ingram is NOT responsible for the

accuracy of the data in this field.

165 1 A, N, Blank Filler 1

166 – 168 3 A, N Discount Level Discount percent (e.g., "NET", " 5%", "35%") or
standard discount represented by the codes "REG"
or "LOW" (please contact Customer Care to obtain
your account level discounts for these values). The
data in this field is left justified and space filled,
e.g., five percent = " 5%"

169 – 178 10 A, N, Blank Filler 2

179 – 180 2 A, N Publisher Status Code This data is supplied by the publisher and
represents the current state of the title in the
publishing life cycle. Please see Product
Availability Code (position 272 – 273) for the
supplier status information. See reference file,
inventory\ pubstatus.txt for complete list of
values.

181 1 A, N La Vergne, TN Stock Flag "Y" – title is Active and carried/stocked in the
specific DC, the title can be ordered or
backordered based on the on-hand quantity.
"N" – title is no longer carried/stocked, backorders
are no longer accepted. Please note: For sell down
titles - please see the on-hand quantity fields
(positions 039 – 094) for available inventory.

182 1 A, N Roseburg, OR Stock Flag See description above.

183 1 A, N Ft. Wayne, IN Stock Flag See description above.

184 1 A, N Chambersburg, PA Stock Flag See description above.

185 1 A,N Allentown, PA Stock Flag See description above.

186 1 A,N Fresno, CA Stock Flag See description above.

187 1 A,N DC Stock Flag See description above.

188 1 Blank DC Stock Flag Reserved for future use.

Data Services | FTP, Inventory Implementation Guide 12

 Position Length Format Field Name Description

189 – 196 8 DT Publication Date Date in which the title was or is due to be
published.
Please note: If the publisher only supplies a month
and year as the Publication Date - Ingram will
populate DD (=Day) with the first day of the
month or the date specified in the On Sale Date
(position 197-204).

197 – 204 8 DT On Sale Date The on sale date, also known as "Street Date", is
the date that the publisher will allow the item to be
sold to the public. Please note:
Date = "000000" – indicates that an On Sale Date
has not been set and the item can be sold upon
receipt.

205 1 A, N Returnable Indicator "Y" – Title is returnable.

"N" – Title is NOT returnable.

Please note: Please see Return Date (position 206-

213) for allotted time frame for return.

206 – 213 8 DT Return Date This represents the last date the title can be
returned to Ingram. Please allow plenty of time for
shipment and receipt at an Ingram DC.
Please note:
Date = "00010101" – the title is NOT Returnable.
Date = "99991231" – a Return Date has not been
set.

214 – 218 5 A, N, Blank Filler 3

219 1 A, N Backorder Only Indicator This indicator is used to flag titles which will be
ordered only when a backorder is placed for the
title. Backorders may be placed in any "Y" flagged
DC (see DC Stock Flag, positions 181 – 188).

Valid Codes:
"Y" – a backorder is required for ordering.
"N" – Backorder is not required.
"1" – approximate one day backorder, (e.g., title
transfer between DC's).
"2" – approximate two day backorder.

220 1 A, N Media Mail Indicator "Y" – Title is eligible to ship via the USPS Media
Mail.
"N" – Title is NOT eligible.

Please note: The USPS defines the rules for the

use of Media Mail – please visit their web site for
more information, www.usps.gov.

221 1 A, N Product Type Title classification assigned by Ingram. See

reference file, inventory\prodtp.txt for complete
list of values.

222 1 A, N Imprintable Indicator "Y" – Title is eligible to for a personal imprinting

preformed by Ingram.
"N" – title is NOT eligible for imprinting.

223 1 A, N Indexable Indicator "Y" – Title is eligible to for indexing preformed by

Ingram.
"N" – Title is NOT eligible for indexing.

224 – 238 15 A, N, Blank Filler 4

239 – 244 6 N Weight Title weight in pounds. Two decimals implied.

E.g., "000025" = .25 pounds.

245 – 255 11 A, N, Blank Filler 5

Data Services | FTP, Inventory Implementation Guide 13

 Position Length Format Field Name Description

256 – 259 4 A, N Ingram Publisher Number An Ingram assigned code representing the
publisher imprint. See reference file,
inventory\ipspubnum.txt for a complete list of
values for our IPS partners.

260 – 264 5 A, N, Blank Filler 6

265 1 A, N, Blank Restricted Code The code indicates if an title has imposed
restrictions limiting the sale to certain geographical
areas or market types. If more than one restriction
applies to any one title, the higher priority code is
supplied. If blank a restriction does not exists for
the title. Please see reference file,
inventory\restrictcodes.txt for complete list of
values.

Please note: The Country Exclusion file can be

used to determine which titles are Restricted for
Sale to a specific country.

266 – 270 5 A, N Discount Category Code This is the Ingram Publisher Services (IPS)
discount code that is assigned by the publisher and
can be used in conjunction with the Ingram
Publisher Number (position 256 – 259) to translate
the discount on IPS titles.

271 1 A, N, Blank Filler 7

272 – 273 2 A, N Product Availability Code This code indicates the stock availability status of
the title within Ingram systems. This status relates
to the Ingram system only and may not match the
Publisher Status Code (position 179 – 180). See
reference file, inventory\prodstat.txt for complete
list of values.

274 – 282 9 A, N Ingram Title Code This is an alternative Ingram assigned item
identifier and can be used when ordering from
Ingram.

283 – 284 2 A, N Product Classification Type This field will provide the ability to include or
exclude public domain reproduction and
compilation titles on your site or designate them
with the additional classification.

Possible values include:

"PR" – reproductions, previously published titles
that are now in the public domain.
"PC" – compilations, collections of public
information often gathered from internet Web sites.

285 – 301 17 A, N, Blank Filler 8

Data Services | FTP, Inventory Implementation Guide 14

Inventory Supplemental Files
Inventory Country Exclusion file
Certain export destinations are subject to trade sanctions, embargoes and other restrictions under United States law
and these restrictions may apply to both U.S. and International shipments. The Restricted by Country file contains
an EAN and a three-digit Alpha Country Code which signifies that the title in restricted for sale to the country that
will receive the titles.

File Location
\inventory

File Name
ctry_excl_titles.txt

Availability
• Download from FTP server
• Monday by 1:00am CST
• Updated weekly
•
Reference File
country.txt

File Usage Suggestions

You can use this file with the Restricted Code field in the StockV2 file to exclude titles from showing as supplied by
Ingram for any shipments to a specific country. Use the Country Exclusion file to determine the specific countries.

File Format
This file specification adheres to the following:

• File Format: comma-delimited

• Record Length: 21 characters
• Text Qualifier: double quote
• Line Terminator: carriage return line feed
• Field Format Key
o A, N – Alpha Numeric (Text / String)
o DT – Date / Time
o N – Numeric

Column Length Format Field Name Description

1 13 A, N EAN EAN or ISBN-13. The Bookland International Article Number is
the Ingram Primary Item Identifier, will be present on ALL titles,
and can be used to link to other Ingram data files.
Please note: For titles that are not assigned an EAN, Ingram will
use the Universal Product Code (UPC) with a leading zero.
2 3 A, N Country Code Contains a three-digit alpha Country code. See reference file,
inventory\country.txt for complete list of values.

Data Services | FTP, Inventory Implementation Guide 15

Inventory Supplemental Files (continued)
Inventory Estimated Time of Arrival (ETA) File
This file provides an estimate time of arrival (ETA) for titles that are temporarily out of stock and On-Order with the
publisher. Ingram uses a historical publisher fulfillment performance to calculate the ETA for each of the Ingram
Distribution Centers (DC).

File Location
\inventory

File Name
[email protected]

Availability
• Download from FTP server
• Available by 8:00am CST
• updated daily

File Format
This file specification adheres to the following:

• File Format: comma-delimited

• Record Length: 80 characters
• Text Qualifier: none
• Line Terminator: carriage return line feed
• Numeric Fields: right justified and zero filled
• Decimal: Implied two decimals for all Price fields
• Date/Time Format: YYYYMMDD
• Field Format Key
o A, N – Alpha Numeric (Text / String)
o DT – Date / Time
o N – Numeric

Column Length Format Field Name Description

1 13 A, N EAN EAN or ISBN-13. The Bookland International Article Number is the
Ingram Primary Item Identifier, will be present on ALL titles, and can
be used to link to other Ingram data files.
Please note: For titles that are not assigned an EAN, Ingram will use
the Universal Product Code (UPC) with a leading zero.
2 2 A, N Ingram Distribution “BB” = Allentown, PA
Center Code "CI" = Chambersburg, PA
"DD" = Ft Wayne, IN
"EE" = Roseburg, OR
“JJ” = Fresno, CA
"NV" = La Vergne, TN
3 8 DT Estimated Time of Date that the title is predicted to be received in the DC.
Arrival
4 55 A, N, Blank Filler 1

Data Services | FTP, Inventory Implementation Guide 16

Inventory Supplemental Files (continued)
Inventory International Price File
This file supplies Ingram customers with the publisher supplied price for International currencies. Ingram currently
captures the Suggested Retail (SRP) and the Publisher Supplied Price in United States and Canadian dollars. Please
see the StockV2 file for the U.S. Suggested Retail Price and the U.S. Publisher Supplied Price.

File Location
\inventory

File Name
[email protected]

Availability
• Download from FTP server
• Available by 8:00am CST
• updated daily

File Format
This file specification adheres to the following:

• File Format: comma-delimited

• Record Length: 80 characters
• Text Qualifier: None
• Line Terminator: carriage return line feed
• Numeric Fields: right justified and zero filled
• Decimal: Implied two decimals for all Price fields
• Date/Time Format: YYYYMMDD
• Field Format Key
o A, N – Alpha Numeric (Text / String)
o DT – Date / Time
o N – Numeric

Column Length Format Field Name Description

1 13 A, N EAN EAN or ISBN-13. The Bookland International Article Number is the
Ingram Primary Item Identifier, will be present on ALL titles, and can
be used to link to other Ingram data files.
Please note: For titles that are not assigned an EAN, Ingram will use
the Universal Product Code (UPC) with a leading zero.
2 3 A, N Currency Code International Organization for Standardization (ISO) Currency Code
e.g., "CAD" = Canada
3 7 N Publisher Supplied Price This is the Publisher Supplied Price. e.g., "0001799" = $17.99

Please note: Ingram is NOT responsible for the accuracy of the data in
this field.
4 54 A, N, Blank Filler 1

Data Services | FTP, Inventory Implementation Guide 17

Inventory Supplemental Files (continued)

Inventory Removal File

This file provides a list of titles that are no longer stocked by Ingram. This file would be used if you miss delta
Stockv2 files and are unable to process the full stock file to refresh your system. Then you would use the list to
remove item from your system just as you would the Stockv2 file. Items in this file will have a Product Availability
code of “40” – “Not Available from Ingram” in positions 272-273.

There are 4 files options, depending on the time frame you would like to process the file:
• 2 days
• 15 days
• 30 days
• 180 days

File Location
\inventory

File Name
• stockv2remove2days.zip
• stockv2remove15days.zip
• stockv2remove30days.zip
• stockv2remove180days.zip

Availability
• Download from FTP server
• See Stockv2 Full File Availability on page 9.

File Format
• File Format: see page 11 for the Stockv2 File Specification

Data Services | FTP, Inventory Implementation Guide 18

Inventory Supplemental Files (continued)
Proposition 65 Warnings File
This file provides a list of product warnings provided by the publisher to meet the State of California’s Proposition
65 warnings that are required by law to be displayed on websites/in store to California Customers.
Proposition 65 requires businesses to provide warnings to Californians about significant exposures
to chemicals that cause cancer, birth defects or other reproductive harm. These chemicals can be
in the products that Californians purchase, in their homes or workplaces, or that are released into
the environment.

File Locations
\inventory
\Inventory_Reference_Files

File Name
Prop65_Warnings.txt

Availability
• Download from FTP server
• Available by 8:00am CDT
• Weekly on Sunday

File Format
This file specification adheres to the following:

• File Format: pipe-delimited

• Record length: variable
• Field terminator: |
• Record terminator: carriage return line feed
• Field format key
o A, N – alpha numeric (text / string)

Column Format Field Name Description

1 A, N EAN EAN or ISBN-13. The Bookland International Article Number is the Ingram
Primary Item Identifier, will be present on ALL titles, and can be used to link to
other Ingram data files.
Please note: For titles that are not assigned an EAN, Ingram will use the Universal
Product Code (UPC) with a leading zero.
2 A, N Warning Narrative Displays the appropriate warning supplied by the Publisher to meet the Proposition
65 requirements as set by the state of California.

Data Services | FTP, Inventory Implementation Guide 19

Inventory Supplemental Files (continued)
Publisher Sales Rights
These files provide a Sales Rights by Country, Territory, or Rest of World provided by the publisher where products
can be sold.

There are 3 files to determine Sales Rights with 3 translation code files, specifications for each are listed below.

You will want to check for the Country and Territory Sales Rights Restriction or Inclusion by knowing the Sale
Right Type Code and also reviewing the Rest of World (ROW) file.

File Locations
\inventory\SalesRights

File Name
SalesRights_Country.txt
SalesRights_ROW.txt
SalesRights_Territory.txt
Country_ONIX.txt (translation file)
SalesRightsTypeCd.txt (translation file)
Territory_ONIX.txt (translation file)

Availability
• Download from FTP server
• Available by 8:00am CDT
• Weekly on Monday

File Format - SalesRights_Country.txt

This file specification adheres to the following:

• File Format: pipe-delimited

• Record length: variable
• Field terminator: |
• Record terminator: carriage return line feed
• Field format key
o A, N – alpha numeric (text / string)

Column Format Field Name Description

1 A, N EAN EAN or ISBN-13. The Bookland International Article Number is the Ingram
Primary Item Identifier, will be present on ALL titles, and can be used to link to
other data files.
Please note: For titles that are not assigned an EAN, we will use the Universal
Product Code (UPC) with a leading zero.
2 A, N Sales Right Type Code ONIX Sales Rights Type Code. Use the SalesRightsTypeCd.txt for translation
3 A, N Country Codes Country code(s), space separated. This field can contain multiple country codes.
Use the Country_ONIX.txt for translation

Data Services | FTP, Inventory Implementation Guide 20

File Format - SalesRights_ROW.txt

This file specification adheres to the following:

• File Format: pipe-delimited

• Record length: variable
• Field terminator: |
• Record terminator: carriage return line feed
• Field format key
o A, N – alpha numeric (text / string)

Column Format Field Name Description

1 A, N EAN EAN or ISBN-13. The Bookland International Article Number is the Ingram
Primary Item Identifier, will be present on ALL titles, and can be used to link to
other data files.
Please note: For titles that are not assigned an EAN, we will use the Universal
Product Code (UPC) with a leading zero.
2 A, N Sales Right Type Code ONIX Sales Rights Type Code. Use the SalesRightsTypeCd.txt for translation

File Format - SalesRights_Territory.txt

This file specification adheres to the following:

• File Format: pipe-delimited

• Record length: variable
• Field terminator: |
• Record terminator: carriage return line feed
• Field format key
o A, N – alpha numeric (text / string)

Column Format Field Name Description

1 A, N EAN EAN or ISBN-13. The Bookland International Article Number is the Ingram
Primary Item Identifier, will be present on ALL titles, and can be used to link to
other data files.
Please note: For titles that are not assigned an EAN, we will use the Universal
Product Code (UPC) with a leading zero.
2 A, N Sales Right Type Code ONIX Sales Rights Type Code. Use the SalesRightsTypeCd.txt for translation
3 A, N Territory Codes Territory code(s), space separated. This field can contain multiple country codes.
Use the Territory_ONIX.txt for translation

File Format – Country_ONIX.txt

This file specification adheres to the following:

• File Format: comma-delimited

• Record length: variable
• Field terminator: comma (,)
• Record terminator: carriage return line feed
• Field format key
o A, N – alpha numeric (text / string)

Column Format Field Name Description

1 A, N Country Code ONIX Country Code – 2 characters
2 A, N Country Description ONIX Country Description

Data Services | FTP, Inventory Implementation Guide 21

File Format – SalesRightsTypeCd.txt

This file specification adheres to the following:

• File Format: comma-delimited

• Record length: variable
• Field terminator: comma (,)
• Record terminator: carriage return line feed
• Field format key
o A, N – alpha numeric (text / string)

Column Format Field Name Description

1 A, N Sales Rights Type Code ONIX Sales Rights Type Code – 2 characters
2 A, N Sales Rights Type Description ONIX Sales Rights Type Description

File Format – Territory_ONIX.txt

This file specification adheres to the following:

• File Format: comma-delimited

• Record length: variable
• Field terminator: comma (,)
• Record terminator: carriage return line feed
• Field format key
o A, N – alpha numeric (text / string)

Column Format Field Name Description

1 A, N Territory Code ONIX Territory Code
2 A, N Territory Description ONIX Territory Description

Data Services | FTP, Inventory Implementation Guide 22

Frequently Asked Questions
This is a list of the common questions regarding the data and data files.

Question Answer
How do I calculate my cost? Your cost is the Price minus (Price multiplied by the Discount Level). Price-
(Price*Discount Level) = Cost

Example:
Price: $9.95
Discount Level: 40%
9.95-(9.95*0.4) = $5.97
How do I identify titles that are restricted for sale? Please use the Restricted Code (position 265) and the Country Exclusions file to
identify titles that are restricted for sale in the Inventory file. Or you may use
the Publisher Sales Rights files.
Is there anything in the full or delta files that There is not a flag in the inventory file that denotes that a record is new or has
identifies or flags "what" field has been changed? been changed. However, there is a Delta file.
What are your product types for DVD's? Ingram Product Type (position 221) = "K", Video

Where can I find the "Country of Origin" for a title? This data can be found in the logistics file. Please contact IDS Sales for
information about this or other files.
What code will Backorder Only titles have in the A Backorder Only title will have a "Y", "1", or "2" in the Backorder Only
inventory file? Indicator field or a "22" in the Product Availability Code field.
If an order is placed for a Backorder Only title Since you do not allow backorders, we would recommend that you filter the
without a cancellation date, the order will reject – backorder only titles from your offering. Here is the filter options:
since we’re managing our own backorders, we don’t Backorder Only Indicator <> "N" or Product Availability Code = "22" - "To
send you a cancellation date and theoretically, if these order - Available from us as a non-stock title, by special order".
titles have zero stock, we would never send at
all…..how do we do this?
How many Backorder Only titles exist? This amount varies by data license.

Does the reference file, ipspubnum.txt, contain all of This file contains all possible publisher numbers for publishers that are currently
are available publishers from Ingram Publisher distributed by IPS. The file, ipspubnum.txt, is a reference file for the code found
Services (IPS)? in the Ingram Publisher Number field and the file is updated as needed.

Data Services | FTP, Inventory Implementation Guide 23

Glossary
Term Definition
Adds Adds are titles that have been added to the inventory file and are available to sell.
Available To Sell This refers to titles that are available to sell; however, some restrictions may apply. You are responsible for filtering
titles that are not available to sell; please see the Restricted Code and County Exclusion file for assistance with
identifying the title restrictions.
CDT Central Daylight Time (GMT - 5) is observed during the summer months.
Change Changes may have occurred in the following fields: On-Hand or On-Order Quantity, Discount Level, Price, Return
Indicator, Return Date, On Sale Date, Publisher Status, Weight or Restricted Code. For the daily and weekly Delta
files, changes can occur to any field in the file.
CT Central Time (Greenwich mean time, GMT - 6) and central daylight time (GMT - 5) is observed during the summer
months.
Current Date Current Date specifies a date that is based on a reading the time-of-day.
Data Slice Data Slices were developed for booksellers that focus on niche markets or that require a subset or pre-defined
portion of the titles available from Ingram, e.g., Self-Help, Top 250,000, Spanish Language, Fiction, Children's
titles, etc. A subscription is required to access the Slice inventory files.
Delete When a title has been discontinued and is no longer available to purchase from Ingram, the inventory record will no
longer appear in the Full inventory files. A delete or zero record is reported once in the Delta files.
Delta The Delta will contain incremental updates for titles, where select or all fields have changed, a record has been
added, or deleted. The Delta is created when comparing the current Full file with the previously created Full file or,
in the case of the daily and weekly Delta files; a change has been made to the inventory record since the last file
was generated.

The Delta files report deleted or discontinued titles, called zero records, once. You must process all Delta files so
that you will not miss any of these records.

A unique file name is used for each new file, e.g., [email protected].
Full This is the "master" file, which contains all titles that are available to sell (some restrictions may apply) and is
generated six times per day. You are responsible for the additional filtering of titles that are not available to sell
based on the publishers request or in a particular country. Please see the Restricted Code and County Exclusion file
for assistance with identifying restrictions.

This file tends to be very large (as of July 2012, it is over 4GB) and is expected to grow significantly over the next
year. Therefore, this file requires adequate resources for processing.

Discontinued or deleted titles will drop off the Full file; please see the Delta files for delete records.

The file name is overwritten, but the "date modified" will change, e.g., [email protected]
Primary Item The EAN is the Primary Item Identifier or Primary Key which is used to uniquely identify a record in a file or table.
Identifier No two distinct rows in a table can have the same value (or combination of values). This key can be used to link
data from other files or tables.
Primary Key See Primary Item Identifier.
Slice See Data Slice.
Zero Record The Delta files report deleted or discontinued titles, once. These records, called zero records, contain zeros ("0"),
spaces / blanks, and no's ("N") in all fields and a Product Availability Status = "40".

Data Services | FTP, Inventory Implementation Guide 24

Document History
This section describes the changes since the previously published release of this guide, including the change history
from the previous version. (Sorted descending by Version, Date, alphabetical by Activity, then by Field Name)

The version and release are represented in the abbreviated format for version. Release, X.X, in this table.
Current Version Change History

Version Date Activity Section/Field Name Notes

2.13 6/08/2021 Add Inventory Supplemental Files / New files to determine the Publisher’s right
Publisher Sales Rights Files to sell items in certain countries or territories.

Contacts
Company Email Business Hours
Setup and Login Instructions, [email protected] Normal
Development, Testing and
Production
Data Sales, and Administration [email protected] Normal

Business hours (all times CT and excluding Ingram recognized holidays)

• Normal: Monday – Friday, 8:00 a.m. to 5:00 p.m.

Policy
Copyright © 2021 Ingram Content Group, Inc. or its affiliates. All rights reserved.
Every effort has been made to ensure accuracy of the information provided. If you should find errors in this document, please notify the
IDS Integration Team via email, [email protected].

Data Services | FTP, Inventory Implementation Guide 25