UPS
/
Warehouse Inventory Adjustment Advice
  • Specification
  • EDI Inspector
Stedi maintains this guide based on public documentation from UPS. Contact UPS for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
UPS logo

X12 947 Warehouse Inventory Adjustment Advice

X12 Release 5010

This X12 Transaction Set contains the format and establishes the data contents of the Warehouse Inventory Adjustment Advice Transaction Set (947) for use within the context of an Electronic Data Interchange (EDI) environment. The transaction set can be used to inform a warehouse/depositor of a quantity or status change to inventory records. This transaction set provides detail information concerning the internal adjustments which occur between a warehouse and a depositor.

Delimiters
  • ~ Segment
  • * Element
  • > Component
  • ^ Repetition
EDI samples
  • One sided Adjustment – One Transaction (cycle count)
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/ups/warehouse-inventory-adjustment-advice/01H28RNE95B2TC3XK5XFK194RA
Powered by
Build EDI implementation guides at stedi.com
Overview
ISA
-
Interchange Control Header
Max use 1
Required
GS
-
Functional Group Header
Max use 1
Required
heading
ST
0100
Transaction Set Header
Max use 1
Required
W15
0200
Warehouse Adjustment Identification
Max use 1
Required
0100 Loop
G62
1100
Date/Time
Max use 5
Optional
detail
0300 Loop
W19
0200
Warehouse Adjustment Item Detail
Max use 1
Required
N9
0400
Extended Reference Information
Max use 10
Optional
G62
0800
Date/Time
Max use 10
Optional
0330 Loop
SE
2100
Transaction Set Trailer
Max use 1
Required
GE
-
Functional Group Trailer
Max use 1
Required
IEA
-
Interchange Control Trailer
Max use 1
Required
ISA

Interchange Control Header

RequiredMax use 1

To start and identify an interchange of zero or more functional groups and interchange-related control segments

Example
ISA-01
I01
Authorization Information Qualifier
Required
Identifier (ID)

Code identifying the type of information in the Authorization Information

00
No Authorization Information Present (No Meaningful Information in I02)
ISA-02
I02
Authorization Information
Required
String (AN)
Min 10Max 10

Information used for additional identification or authorization of the interchange sender or the data in the interchange; the type of information is set by the Authorization Information Qualifier (I01)

ISA-03
I03
Security Information Qualifier
Required
Identifier (ID)

Code identifying the type of information in the Security Information

00
No Security Information Present (No Meaningful Information in I04)
ISA-04
I04
Security Information
Required
String (AN)
Min 10Max 10

This is used for identifying the security information about the interchange sender or the data in the interchange; the type of information is set by the Security Information Qualifier (I03)

ISA-05
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Code indicating the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-06
I06
Interchange Sender ID
Required
String (AN)
Min 15Max 15

Identification code published by the sender for other parties to use as the receiver ID to route data to them; the sender always codes this value in the sender ID element

ISA-07
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Code indicating the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-08
I07
Interchange Receiver ID
Required
String (AN)
Min 15Max 15

Identification code published by the receiver of the data; When sending, it is used by the sender as their sending ID, thus other parties sending to them will use this as a receiving ID to route data to them

ISA-09
I08
Interchange Date
Required
Date (DT)
YYMMDD format

Date of the interchange

ISA-10
I09
Interchange Time
Required
Time (TM)
HHMM format

Time of the interchange

ISA-11
I65
Repetition Separator
Required
String (AN)
Min 1Max 1

Type is not applicable; the repetition separator is a delimiter and not a data element; this field provides the delimiter used to separate repeated occurrences of a simple data element or a composite data structure; this value must be different than the data element separator, component element separator, and the segment terminator

^
Repetition Separator
ISA-12
I11
Interchange Control Version Number
Required
Identifier (ID)

Code specifying the version number of the interchange control segments

00501
Standards Approved for Publication by ASC X12 Procedures Review Board through October 2003
ISA-13
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

ISA-14
I13
Acknowledgment Requested
Required
Identifier (ID)
Min 1Max 1

Code indicating sender's request for an interchange acknowledgment

0
No Interchange Acknowledgment Requested
1
Interchange Acknowledgment Requested (TA1)
ISA-15
I14
Interchange Usage Indicator
Required
Identifier (ID)
Min 1Max 1

Code indicating whether data enclosed by this interchange envelope is test, production or information

I
Information
P
Production Data
T
Test Data
ISA-16
I15
Component Element Separator
Required
String (AN)
Min 1Max 1

Type is not applicable; the component element separator is a delimiter and not a data element; this field provides the delimiter used to separate component data elements within a composite data structure; this value must be different than the data element separator and the segment terminator

>
Component Element Separator

Functional Group Header

RequiredMax use 1

To indicate the beginning of a functional group and to provide control information

Example
GS-01
479
Functional Identifier Code
Required
Identifier (ID)

Code identifying a group of application related transaction sets

AW
Warehouse Inventory Adjustment Advice (947)
GS-02
142
Application Sender's Code
Required
String (AN)
Min 2Max 15

Code identifying party sending transmission; codes agreed to by trading partners

GS-03
124
Application Receiver's Code
Required
String (AN)
Min 2Max 15

Code identifying party receiving transmission; codes agreed to by trading partners

Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year

Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

Time expressed in 24-hour clock time as follows: HHMM, or HHMMSS, or HHMMSSD, or HHMMSSDD, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59) and DD = decimal seconds; decimal seconds are expressed as follows: D = tenths (0-9) and DD = hundredths (00-99)

GS-06
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

GS-07
455
Responsible Agency Code
Required
Identifier (ID)
Min 1Max 2

Code identifying the issuer of the standard; this code is used in conjunction with Data Element 480

T
Transportation Data Coordinating Committee (TDCC)
X
Accredited Standards Committee X12
GS-08
480
Version / Release / Industry Identifier Code
Required
String (AN)

Code indicating the version, release, subrelease, and industry identifier of the EDI standard being used, including the GS and GE segments; if code in DE455 in GS segment is X, then in DE 480 positions 1-3 are the version number; positions 4-6 are the release and subrelease, level of the version; and positions 7-12 are the industry or trade association identifiers (optionally assigned by user); if code in DE455 in GS segment is T, then other formats are allowed

005010
Standards Approved for Publication by ASC X12 Procedures Review Board through October 2003

Heading

ST
0100
Heading > ST

Transaction Set Header

RequiredMax use 1

To indicate the start of a transaction set and to assign a control number

Example
ST-01
143
Transaction Set Identifier Code
Required
Identifier (ID)

Code uniquely identifying a Transaction Set

  • The transaction set identifier (ST01) is used by the translation routines of the interchange partners to select the appropriate transaction set definition (e.g., 810 selects the Invoice Transaction Set).
947
Warehouse Inventory Adjustment Advice
ST-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

W15
0200
Heading > W15

Warehouse Adjustment Identification

RequiredMax use 1

To provide identifying numbers and dates and other basic data for this transaction set

Example
At least one of Adjustment Number (W15-02) or Adjustment Number (W15-03) is required
Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year

W15-02
31
Adjustment Number
Optional
String (AN)
Min 1Max 22

Identification assigned to an inventory level or status adjustment

  • W1502 is the identification assigned to an inventory level or status adjustment by the warehouse.
W15-03
31
Adjustment Number
Optional
String (AN)
Min 1Max 22

Identification assigned to an inventory level or status adjustment

  • W1503 is the identification assigned to an inventory level or status adjustment by the depositor.
0100 Loop
RequiredMax >1
N1
0400
Heading > 0100 Loop > N1

Party Identification

RequiredMax use 1

To identify a party by type of organization, name, and code

Example
At least one of Name (N1-02) or Identification Code Qualifier (N1-03) is required
If either Identification Code Qualifier (N1-03) or Identification Code (N1-04) is present, then the other is required
N1-01
98
Entity Identifier Code
Required
Identifier (ID)

Code identifying an organizational entity, a physical location, property or an individual

WH
Warehouse
Optional
String (AN)
Min 1Max 60

Free-form name

N1-03
66
Identification Code Qualifier
Optional
Identifier (ID)

Code designating the system/method of code structure used for Identification Code (67)

54
Warehouse
N1-04
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

  • This segment, used alone, provides the most efficient method of providing organizational identification. To obtain this efficiency the "ID Code" (N104) must provide a key to the table maintained by the transaction processing party.
0100 Loop end
G62
1100
Heading > G62

Date/Time

OptionalMax use 5

To specify pertinent dates and times

Example
If either Date Qualifier (G62-01) or Date (G62-02) is present, then the other is required
At least one of Date Qualifier (G62-01) or Time Qualifier (G62-03) is required
If either Time Qualifier (G62-03) or Time (G62-04) is present, then the other is required
G62-01
432
Date Qualifier
Optional
Identifier (ID)

Code specifying type of date

AB
Warehouse Inventory Stock
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year

G62-03
176
Time Qualifier
Optional
Identifier (ID)

Code specifying the reported time

W
Effective Time
Optional
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

Time expressed in 24-hour clock time as follows: HHMM, or HHMMSS, or HHMMSSD, or HHMMSSDD, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59) and DD = decimal seconds; decimal seconds are expressed as follows: D = tenths (0-9) and DD = hundredths (00-99)

Heading end

Detail

0300 Loop
RequiredMax >1
W19
0200
Detail > 0300 Loop > W19

Warehouse Adjustment Item Detail

RequiredMax use 1

To designate those items that were adjusted

Example
At least one of U.P.C. Case Code (W19-04) or Product/Service ID Qualifier (W19-05) is required
If either Product/Service ID Qualifier (W19-05) or Product/Service ID (W19-06) is present, then the other is required
If either Product/Service ID Qualifier (W19-07) or Product/Service ID (W19-08) is present, then the other is required
W19-01
181
Quantity or Status Adjustment Reason Code
Required
Identifier (ID)

Code indicating reason for change in level or status of inventory

06
Book Adjustment Decrease
56
Book Adjustment Increase
AC
Condition Change

An adjustment to inventory is required due to a change in the condition classification of the material.

W19-02
477
Credit/Debit Quantity
Required
Decimal number (R)
Min 1Max 10

Number of supplier units credited or debited

W19-03
355
Unit or Basis for Measurement Code
Required
Identifier (ID)
Min 2Max 2

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

W19-04
438
U.P.C. Case Code
Optional
String (AN)
Min 12Max 12

Code (Universal Product Code - U.P.C.) including two high order digits identifying the "system" (U.S. Grocery = 00, 06 or 07; U.S. Drug = 03); using the U.S. Grocery system, the next ten digits are: Manufacturer (5) Case Code (5)

W19-05
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

W19-06
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

W19-07
235
Product/Service ID Qualifier
Optional
Identifier (ID)
Min 2Max 2

Code identifying the type/source of the descriptive number used in Product/Service ID (234)

W19-08
234
Product/Service ID
Optional
String (AN)
Min 1Max 48

Identifying number for a product or service

N9
0400
Detail > 0300 Loop > N9

Extended Reference Information

OptionalMax use 10

To transmit identifying information as specified by the Reference Identification Qualifier

Example
At least one of Reference Identification (N9-02) or Free-form Description (N9-03) is required
N9-01
128
Reference Identification Qualifier
Required
Identifier (ID)
Min 2Max 3

Code qualifying the Reference Identification

N9-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

N9-03
369
Free-form Description
Optional
String (AN)
Min 1Max 45

Free-form descriptive text

G62
0800
Detail > 0300 Loop > G62

Date/Time

OptionalMax use 10

To specify pertinent dates and times

Example
If either Date Qualifier (G62-01) or Date (G62-02) is present, then the other is required
G62-01
432
Date Qualifier
Optional
Identifier (ID)

Code specifying type of date

36
Expiration Date
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year

0330 Loop
OptionalMax >1
LX
1500
Detail > 0300 Loop > 0330 Loop > LX

Transaction Set Line Number

RequiredMax use 1

To reference a line number in a transaction set

Example
LX-01
554
Assigned Number
Required
Numeric (N0)
Min 1Max 6

Number assigned for differentiation within a transaction set

N9
1600
Detail > 0300 Loop > 0330 Loop > N9

Extended Reference Information

OptionalMax use >1

To transmit identifying information as specified by the Reference Identification Qualifier

Example
N9-01
128
Reference Identification Qualifier
Required
Identifier (ID)

Code qualifying the Reference Identification

SE
Serial Number
N9-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier

0330 Loop end
0300 Loop end
SE
2100
Detail > SE

Transaction Set Trailer

RequiredMax use 1

To indicate the end of the transaction set and provide the count of the transmitted segments (including the beginning (ST) and ending (SE) segments)

Example
SE-01
96
Number of Included Segments
Required
Numeric (N0)
Min 1Max 10

Total number of segments included in a transaction set including ST and SE segments

SE-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

Detail end

Functional Group Trailer

RequiredMax use 1

To indicate the end of a functional group and to provide control information

Example
GE-01
97
Number of Transaction Sets Included
Required
Numeric (N0)
Min 1Max 6

Total number of transaction sets included in the functional group or interchange (transmission) group terminated by the trailer containing this data element

GE-02
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

Interchange Control Trailer

RequiredMax use 1

To define the end of an interchange of zero or more functional groups and interchange-related control segments

Example
IEA-01
I16
Number of Included Functional Groups
Required
Numeric (N0)
Min 1Max 5

A count of the number of functional groups included in an interchange

IEA-02
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

EDI Samples

One sided Adjustment – One Transaction (cycle count)

ISA*00* *00* *ZZ*SENDER *ZZ*RECEIVER *231101*0211*^*00501*000000001*0*T*>
GS*AW*SENDERGS*RECEIVERGS*20231101*021155*000000001*X*005010
ST*947*0001
W15*20170719*7453395*7453395
N1*WH*001*54*1001
G62*AB*20170719*W*020741
W19*56*1*EA**VN*113301
N9*LT*MYLOT1
N9*TD*ZZ
N9*ACC*GD
G62*36*20190909
SE*10*0001
GE*1*000000001
IEA*1*000000001

Sample

ISA*00* *00* *ZZ*SENDER *ZZ*RECEIVER *231101*0212*^*00501*000000001*0*T*>
GS*AW*SENDERGS*RECEIVERGS*20231101*021232*000000001*X*005010
ST*947*0001
W15*20170824*1*1
N1*WH*001*54*1001
G62*AB*20170824*W*110851
W19*AC*600*UN**VN*WS2TESTSKUPS0021*UP*627061817004
N9*LT*PS2BT2*PS2BT2
N9*L2*CUS1*CUS1
N9*4B*CN*CN
N9*TD*DM
N9*ACC*BL*BL
G62*36*20160822
SE*12*0001
GE*1*000000001
IEA*1*000000001

Two-Sided Adjustment — One transaction (Release from QU hold)

ISA*00* *00* *ZZ*SENDER *ZZ*RECEIVER *231101*0213*^*00501*000000001*0*T*>
GS*AW*SENDERGS*RECEIVERGS*20231101*021300*000000001*X*005010
ST*947*0001
W15*20170824*1*1
N1*WH*001*54*1001
G62*AB*20170824*W*100806
W19*AC*10*UN**VN*WS2TESTSKUPS003*UP*627061817004
N9*LT*BT10193*BT10193
N9*L2*HOLD*HOLD
N9*TD*03
N9*ACC*BL*GD
G62*36*20141213
SE*11*0001
GE*1*000000001
IEA*1*000000001

Two-Sided Adjustment — One transaction (to correct lot number data entry)

ISA*00* *00* *ZZ*SENDER *ZZ*RECEIVER *231101*0213*^*00501*000000001*0*T*>
GS*AW*SENDERGS*RECEIVERGS*20231101*021330*000000001*X*005010
ST*947*0001
W15*20170822*1*1
N1*WH*001*54*1001
G62*AB*20170822*W*020811
W19*AC*300*UN**VN*WS2TESTSKUPS003*UP*627061817004
N9*LT*PS3BT3*PS5BT5
N9*L2*CUS1*CUS1
N9*TD*FI
N9*ACC*GD*GD
G62*36*20141210
SE*11*0001
GE*1*000000001
IEA*1*000000001

Stedi is a registered trademark of Stedi, Inc. All names, logos, and brands of third parties listed on this page are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.