New: Drop-in replacement for Change Healthcare APIs

EDI 889 Promotion Announcement

Functional Group QG

X12M Supply Chain Subcommittee

This X12 Transaction Set contains the format and establishes the data contents of the Promotion Announcement Transaction Set (889) for use within the context of an Electronic Data Interchange (EDI) environment. This transaction set can be used by a broker, distributor or manufacturer and provides for customary and established business and industry practice relative to the announcement of promotion allowance amounts, dates and performance conditions that may apply; the replacement of a previously transmitted promotion in its entirety; the cancellation of a previously transmitted promotion; changes to promotion dates; or acceptance of a promotion offered by a broker or supplier. This transaction set is multidirectional between trading partners.

Heading

Position
Segment
Name
Max use
  1. To indicate the start of a transaction set and to assign a control number

  2. To identify promotion activities between trading partners

  3. To transmit identifying information as specified by the Reference Identification Qualifier

  4. To identify a person or office to whom communications should be directed

  5. To specify pertinent dates and times

  6. To transmit information in a free-form format, if necessary, for comment or special instruction

  7. To specify the geographic area in which a promotion or price is in effect

  8. To specify the terms of sale

  9. 0100 Loop Mandatory
    Repeat >1
    1. To identify a party by type of organization, name, and code

    2. To specify additional names

    3. To specify the location of the named party

    4. To specify the geographic place of the named party

    5. To specify pertinent dates and times

  10. 0200 Loop Optional
    Repeat 20
    1. To indicate the option number associated with a promotion and to specify the "AND" or "OR" condition for the option

    2. To specify the "AND" or "OR" condition for the option, or provide information related to the promotion performance conditions and allocations required, or both

Detail

Position
Segment
Name
Max use
  1. 0300 Loop Optional
    Repeat 9999
    1. To reference a line number in a transaction set

    2. To specify unit amount and method of payment for a charge/allowance for a line item

    3. To indicate quantity of free goods and under what conditions free goods are earned

      The G51 segment can be used in the 0300 loop or the 0320 loop, but not both.
    4. 0310 Loop Optional
      Repeat 20
      1. To indicate the option number associated with a promotion and to specify the "AND" or "OR" condition for the option

      2. 0311 Loop Optional
        Repeat 99
        1. To specify the "AND" or "OR" condition for the option, or provide information related to the promotion performance conditions and allocations required, or both

        2. To specify pertinent dates and times

    5. 0320 Loop Optional
      Repeat 9999
      1. To provide information for a line item

      2. To describe an item in free-form format

      3. To specify the geographic area in which a promotion or price is in effect

      4. To indicate quantity of free goods and under what conditions free goods are earned

        The G51 segment can be used in the 0300 loop or the 0320 loop, but not both.
      5. To specify the terms of sale

      6. To specify pertinent dates and times

      7. To specify pricing information

      8. To specify quantity information

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

Stedi is a registered trademark of Stedi, Inc. Stedi's EDI Reference is provided for marketing purposes and is free of charge. All names, logos, and brands of third parties listed on our site 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. Our use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.