UPS
/
Warehouse Inventory Adjustment Advice
  • Specification
  • EDI Inspector
Import guide into your account
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
    View the latest version of this implementation guide as an interactive webpage
    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

    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
    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

    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
    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
    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
    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
    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
    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
    YYMMDD format

    Date of the interchange

    ISA-10
    I09
    Interchange Time
    Required
    HHMM format

    Time of the interchange

    ISA-11
    I65
    Repetition Separator
    Required
    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

    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
    Min 9Max 9

    A control number assigned by the interchange sender

    ISA-14
    I13
    Acknowledgment Requested
    Required
    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
    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
    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

    Code identifying a group of application related transaction sets

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

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

    GS-03
    124
    Application Receiver's Code
    Required
    Min 2Max 15

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

    GS-04
    373
    Date
    Required
    CCYYMMDD format

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

    GS-05
    337
    Time
    Required
    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
    Min 1Max 9

    Assigned number originated and maintained by the sender

    GS-07
    455
    Responsible Agency Code
    Required
    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

    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

    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

    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
    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

    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
    W15-01
    373
    Date
    Required
    CCYYMMDD format

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

    W15-02
    31
    Adjustment Number
    Optional
    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
    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

    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

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

    WH
    Warehouse
    N1-02
    93
    Name
    Optional
    Min 1Max 60

    Free-form name

    N1-03
    66
    Identification Code Qualifier
    Optional

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

    54
    Warehouse
    N1-04
    67
    Identification Code
    Optional
    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.
    G62
    1100

    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

    Code specifying type of date

    AB
    Warehouse Inventory Stock
    G62-02
    373
    Date
    Optional
    CCYYMMDD format

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

    G62-03
    176
    Time Qualifier
    Optional

    Code specifying the reported time

    W
    Effective Time
    G62-04
    337
    Time
    Optional
    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)

    Detail

    0300 Loop
    RequiredMax >1
    W19
    0200

    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

    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
    Min 1Max 10

    Number of supplier units credited or debited

    W19-03
    355
    Unit or Basis for Measurement Code
    Required
    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
    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
    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
    Min 1Max 48

    Identifying number for a product or service

    W19-07
    235
    Product/Service ID Qualifier
    Optional
    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
    Min 1Max 48

    Identifying number for a product or service

    N9
    0400

    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
    Min 2Max 3

    Code qualifying the Reference Identification

    N9-02
    127
    Reference Identification
    Optional
    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
    Min 1Max 45

    Free-form descriptive text

    G62
    0800

    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

    Code specifying type of date

    36
    Expiration Date
    G62-02
    373
    Date
    Optional
    CCYYMMDD format

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

    0330 Loop
    OptionalMax >1
    LX
    1500

    Transaction Set Line Number

    RequiredMax use 1

    To reference a line number in a transaction set

    Example
    LX-01
    554
    Assigned Number
    Required
    Min 1Max 6

    Number assigned for differentiation within a transaction set

    N9
    1600

    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

    Code qualifying the Reference Identification

    SE
    Serial Number
    N9-02
    127
    Reference Identification
    Optional
    Min 1Max 50

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

    SE
    2100

    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
    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
    Min 4Max 9

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

    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
    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
    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
    Min 1Max 5

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

    IEA-02
    I12
    Interchange Control Number
    Required
    Min 9Max 9

    A control number assigned by the interchange sender

    EDI Samples

    One sided Adjustment – One Transaction (cycle count)

    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

    Sample

    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

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

    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

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

    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

    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.