  

 

Tracelink University

 ## Breadcrumb

1. [Home](/)
2. [Resources](/resources/resource-center)
3. [TraceLink University](/resources/tracelink-university)
 
  

 

 

# Product activities (X12)

 

 

 

 

 

 

 

 

- [Download PDF](/node/626151/pdf)
- [Share](#)
    - [ LinkedIn ](https://www.linkedin.com/shareArticle?mini=true&url=https://www.tracelink.com/resources/tracelink-university/product-activities-x12&title=Product activities (X12)&summary=The product activities X12 message comprises of essential data elements that provide valuable insights into product activities. &source=TraceLink "LinkedIn")
    - [ Facebook ](https://www.facebook.com/share.php?u=https://www.tracelink.com/resources/tracelink-university/product-activities-x12&t=Product activities (X12) "Facebook")
    - [ Mail ](mailto:?subject=Product activities (X12)+|+TraceLink&body=https://www.tracelink.com/resources/tracelink-university/product-activities-x12 "Mail")
    - [ Twitter ](https://twitter.com/intent/tweet?text=Product activities (X12) https://www.tracelink.com/resources/tracelink-university/product-activities-x12&via=TraceLink "Twitter")
 
 

 

 

 

 

#### Table of contents

 

 

 

The product activities X12 message comprises of essential data elements that provide valuable insights into product activities.

 ![](/sites/default/files/tech_comms/mpl/Content/Resources/Images/global_images/note_tip_24x24.png) Contact your TraceLink Services representative for more information about integrating with this message.

 

- **Message Type**: MPC\_PRODUCT\_ACTIVITY
- **X12 Format**: 852
- **Transform Names**:
    - B2B\_EDI\_X12\_852\_ProductActivity\_IB\_V5
    - B2B\_EDI\_X12\_852\_ProductActivity\_OB\_V4
 
[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Guidelines](#)              Input Element   Occurs   Length   Description   Example       ISA  \[1…1\]  
  -   **Required.**  ISA interchange envelope.   -      ISA01 \[1…1\]  
  1/2   **Required.**  Qualifier for authorization control number in ISA02.   00       ISA02  \[1…1\]  
  1/10   **Required.**  Information used for additional identification or authorization of the interchange sender or the data in the interchange/ 10 spaces a valid entry.   -       ISA03  \[1…1\]  
  1/2   **Required.**  Qualifier for security information in ISA04.   00       ISA04  \[1…1\]  
  1/10   **Required.**  Identifies security information about the interchange sender or data.   -       ISA05  \[1…1\]  
  1/2   **Required.**  Interchange sender partner ID qualifier.

   07       ISA06  \[1…1\]  
  1/15   **Required.**  Interchange sender identification mapping to:

- fileSenderNumber with party type defined in ISA05
- linkidentifier
- x12InterchangeControlEnvelope for sender in X12 control file header
 
   7777776067344       ISA07  \[1…1\]  
  1/2   **Required.**  Interchange receiver partner ID qualifier.

   01       ISA08  \[1…1\]  
  1/15   **Required.**  EDI receiver ID mapping to file control header and to ServiceLinkId.

Interchange receiver identification mapping to ediInterchangePartyValue for receiver in X12 control file header.

   888888404358877       ISA09  \[1…1\]  
  6/6   **Required.**  Interchange date in 6 char YYMMDD format.   241020       ISA10  \[1…1\]  
  4/4   **Required.**  Interchange time in 4 char HHMM format   1420       ISA11  \[1…1\]  
  1/1   **Required.**  This value is dependent on X12 version.

- `Version 4012 and earlier`, this is the interchange control standards identifier. The valid value is `U`.
- `Version 4020 and later`, this is the repetition separator, a delimiter that separates repeated occurrences of a data element or composite data structure, which must be different than the data element separator, component separator, and segment terminator.
 
   ^       ISA12  \[1…1\]  
  5/5   **Required.**  Interchange control version number. This could be any X12 version.   00501       ISA13  \[1…1\]  
  1/9   **Required.**  Interchange Control Number mapping to file control header.   0000000000619827       ISA14  \[1…1\]  
  1/1   **Required.**  Interchange level acknowledgment requested.

Valid values:

- `0` - No acknowledgment requested
- `1` - Interchange level acknowledgment requested
 
   0       ISA15  \[1…1\]  
  1/1   **Required.**  Indicates whether the interchange is for production, test, or information purposes.

Valid values:

- `I` - Information
- `P` - Production data
- `T` - Test data
 
   P      ISA16  \[1…1\]  
  1/1   **Required.**  Component element separator. Delimiter that separates data elements within a composite data structure. Must be different than the data element separator and segment terminator.   &gt;     GS  \[1…1\]  
  -   **Required.**  GS group functional envelope. Child of ISA. Only one GS group expected per interchange.   -       GS01  \[1…1\]  
  2/2   **Required.**  GS group function code. Valid value is `PD` - Product Activity data X12 852   PD       GS02  \[1…1\]  
  2/15   **Required.**  Application Sender's Code.   2222224043588       GS03  \[1…1\]  
  2/15   **Required.**  Application Receiver's Code.   TRACELINK       GS04  \[1…1\]  
  8/8   **Required.**  Current date stamp in 8 char X12 date format YYYYMMDD.   20241020       GS05  \[1…1\]  
  4/8   **Required.**  Current time stamp in 6 char X12 time format HHMMSS.   142000       GS06  \[1…1\]  
  1/9   **Required.**  Group Control ID Number.   619827       GS07  \[1…1\]  
  1/2   **Required.**  Responsible Agency Code.

Valid values:

- `T` - Transportation Data Coordinating Committee (TDCC)
- `X` - Accredited Standards Committee X12
 
   X      GS08  \[1…1\]  
  1/12   **Required.**  X12 message version code. This could be any X12 version.   005010    ST  \[1…1\]  
  -   **Required.**  ST transaction set envelope. Child of GS group. Only one ST transaction expected.   -       ST01  \[1…1\]  
  3/3   **Required.**  Transaction set identifier code.   852       ST02  \[1…1\]  
  4/9   **Required.**  Transaction set ID number. Counter for each ST segment beginning with 1.   0001       XQ  \[1…1\]  
  -   **Required.**  Product activity message begin segment.   -         XQ01  \[1…1\]  
  1/2   **Required.**  Code identifying purpose of product activity transaction set.

Valid Values:

- `G` - Plan orders and ship product
- `H` - Notification only
- `F` - Suggested purchase order numbers
 
   G         XQ02  \[1…1\]  
  8/8   **Required.**  Date. If the product activity transaction includes only one date at the header level, this represents the report date. If there is a date range the fromDate represents the start date of the date range.   20241020         XQ03  \[0…1\]  
  8/8   Date. If present, this is the end date of a date range.   20241120         XQ04  \[0…1\]  
  0/80   Reference Identification, a unique report identifier sent by the sender.   PA123       XPO  \[0…\*\]  
  -   Preassigned purchase order number. Suggested PO numbers for a VMI relationship will be sent in this segment.   -         XPO01  \[1…1\]  
  1/22   **Required.**  Suggested purchase order number. If a range of suggested PO numbers is sent, this attribute would store the first number in the range. If XPO segment present, XPO01 is required.   5505869746         XPO02  \[0…1\]  
  1/22   The last purchase order number when a range of suggested purchase order numbers is sent.   5505869950         XPO03  \[0…1\]  
  1/2   Company identifier code qualifier.

Valid values:

- `01` – DUNS
- `09` – DUNS+4
- `11` – Drug Enforcement Agency registration number
- `21` – Health Industry Number
- `91` – Company identifier
- `92` – Company location identifier
- `UL` – Global Location Number
 
   91         XPO04  \[0…1\]  
  2/80   Company identifier value for business partner If XPO03 populated, then XPO03 is required.   0673452050       N9  \[0…\*\]  
  -   Extended reference information segment.   -         N901  \[1…1\]  
  2/3   **Required.**  Reference identification qualifier. Specifies the type of identifier recorded.

 Valid values:

- `IA` - Internal vendor identifier
- `LT` - Lot number
- `VR`- Vendor identifier
 
   IA         N902  \[0…1\]  
  1/80   Reference identifier as specified by the reference identification qualifier in N901. Currently only the internal vendor and vendor identifier are supported.   6878425871       N1  \[0…\*\]  
  -   N1 name segment loop for the reporting location identifier and address information.   -         N101  \[1…1\]  
  2/3   **Required.**  Entity qualifier for the reporting location identifier and address information.

Valid value:

- `RL` - Reporting location
- `SU` - Supplier party
- `VN` - Vendor
- `SF` - Ship from party
- `BY` - Buyer party
- `ST` - Ship to party
- `DB` - Distributor branch party
- `DS` - Distributor party
 
   RL         N102  \[0…1\]  
  1/60   Name   Contract Service Provider         N103  \[0…1\]  
  1/2   Identifier code qualifier.

Valid values:

- `01` – DUNS
- `09` – DUNS+4
- `11` – Drug Enforcement Agency registration number
- `21` – Health Industry Number
- `91` – Company identifier
- `92` – Company location identifier
- `UL` – Global Location Number
 
   UL         N104  \[0…1\]  
  2/80   Party identifier as qualified by N103 mapping to companyIdentifierValue. If N103 populated, then N104 is required.   8568745        N3 \[0…2\]  
  -   N3: Address: Child of supplier party N1 name segment.   -           N301  \[1…1\]  
  1/55   **Required.**  Street address 1.   555 Neelan Road           N302  \[0…1\]  
  1/55   Street address 2.   Suite 123         N4  \[0…1\]  
  -   N4: Geographic Location. Child of supplier party N1 name segment.   -           N401  \[0…1\]  
  2/30   City name.   Sacramento           N402  \[0…1\]  
  2/2   State or province code. Code (Standard state/province) as defined by appropriate government agency..   CA           N403  \[0…1\]  
  3/15   Postal code. Code defining international postal zone code excluding punctuation and blanks.   95833           N404  \[0…1\]  
  2/3   Country code   US       LIN  \[1…\*\]  
  -   **Required.**  Baseline item data for product activity report.   -         LIN01  \[0…1\]  
  1/20   Line item number.   000010         LIN02  \[1…1\]  
  2/2   **Required.**  Product or service identifier qualifier.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `BP` – Customer's material number
- `CB` – Buyer Catalog
- `EN` – EAN 2-5-5-1
- `FV` – Canada product number
- `IN` – Customer's(Buyer's) product item number
- `MF` – Manufacturer's product number
- `MG` – Manufacturer's part number
- `N1` – US National-Drug-Code-NDC442-with-hyphen-separators
- `N2` – US National-Drug-Code-NDC532-with-hyphen-separators
- `N3` – US National-Drug-Code-NDC541-with-hyphen-separators
- `N4` – US-National-Drug-Code-NDC542-with-hyphen-separators
- `N5` – US National Health Related Item Code with hypen separator with 5 and characters
- `N6` – US National Health Related Item Code with hypen separators with 6 and 4 characters
- `ND` – US-National-Drug-Code
- `NH` – US National Health Related Item Code
- `PI` – Customer's material number
- `SK` – Stock keeping unit
- `UA` – UPC Case Code (2-5-5)
- `UJ` - PackageUPC
- `UI` – UPC Consumer Package Code (1-5-5)
- `UK` – GTIN14 identifier
- `UP` – EAN/UPC Universal Item Number/GTIN12
- `UX` – Universal product number
- `VC` – Vendor (Supplier) material number
- `VN` – Supplier material number.
 
 

 

   BP         LIN03  \[1…1\]  
  1/80   **Required.**  Product/service identifier value as qualifier by LIN02.   100021         LIN04  \[0…1\]  
  2/2   Product or service identifier qualifier. If LIN05 populated, then LIN04 is required.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `BP` – Customer's material number
- `CB` – Buyer Catalog
- `EN` – EAN 2-5-5-1
- `FV` – Canada product number
- `IN` – Customer's(Buyer's) product item number
- `MF` – Manufacturer's product number
- `MG` – Manufacturer's part number
- `N1` – US National-Drug-Code-NDC442-with-hyphen-separators
- `N2` – US National-Drug-Code-NDC532-with-hyphen-separators
- `N3` – US National-Drug-Code-NDC541-with-hyphen-separators
- `N4` – US-National-Drug-Code-NDC542-with-hyphen-separators
- `N5` – US National Health Related Item Code with hypen separator with 5 and characters
- `N6` – US National Health Related Item Code with hypen separators with 6 and 4 characters
- `ND` – US-National-Drug-Code
- `NH` – US National Health Related Item Code
- `PI` – Customer's material number
- `SK` – Stock keeping unit
- `UA` – UPC Case Code (2-5-5)
- `UJ` - PackageUPC
- `UI` – UPC Consumer Package Code (1-5-5)
- `UK` – GTIN14 identifier
- `UP` – EAN/UPC Universal Item Number/GTIN12
- `UX` – Universal product number
- `VC` – Vendor (Supplier) material number
- `VN` – Supplier material number.
 
 

 

   VN         LIN05  \[0…1\]  
  1/80   Product/service identifier value as qualifier by LIN04. If LIN04 populated, then LIN05 is required.   1000818         LIN06  \[0…1\]  
  2/2   Product or service identifier qualifier. If LIN07 populated, then LIN06 is required.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `BP` – Customer's material number
- `CB` – Buyer Catalog
- `EN` – EAN 2-5-5-1
- `FV` – Canada product number
- `IN` – Customer's(Buyer's) product item number
- `MF` – Manufacturer's product number
- `MG` – Manufacturer's part number
- `N1` – US National-Drug-Code-NDC442-with-hyphen-separators
- `N2` – US National-Drug-Code-NDC532-with-hyphen-separators
- `N3` – US National-Drug-Code-NDC541-with-hyphen-separators
- `N4` – US-National-Drug-Code-NDC542-with-hyphen-separators
- `N5` – US National Health Related Item Code with hypen separator with 5 and characters
- `N6` – US National Health Related Item Code with hypen separators with 6 and 4 characters
- `ND` – US-National-Drug-Code
- `NH` – US National Health Related Item Code
- `PI` – Customer's material number
- `SK` – Stock keeping unit
- `UA` – UPC Case Code (2-5-5)
- `UJ` - PackageUPC
- `UI` – UPC Consumer Package Code (1-5-5)
- `UK` – GTIN14 identifier
- `UP` – EAN/UPC Universal Item Number/GTIN12
- `UX` – Universal product number
- `VC` – Vendor (Supplier) material number
- `VN` – Supplier material number.
 
 

 

   UK         LIN07  \[0…1\]  
  1/80   Product/service identifier value as qualifier by LIN06. If LIN06 populated, then LIN07 is required.   00002541789536         LIN08  \[0…1\]  
  2/2   Product/service identifier value as qualifier by LIN09. If LIN09 populated, then LIN08 is required.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `BP` – Customer's material number
- `CB` – Buyer Catalog
- `EN` – EAN 2-5-5-1
- `FV` – Canada product number
- `IN` – Customer's(Buyer's) product item number
- `MF` – Manufacturer's product number
- `MG` – Manufacturer's part number
- `N1` – US National-Drug-Code-NDC442-with-hyphen-separators
- `N2` – US National-Drug-Code-NDC532-with-hyphen-separators
- `N3` – US National-Drug-Code-NDC541-with-hyphen-separators
- `N4` – US-National-Drug-Code-NDC542-with-hyphen-separators
- `N5` – US National Health Related Item Code with hypen separator with 5 and characters
- `N6` – US National Health Related Item Code with hypen separators with 6 and 4 characters
- `ND` – US-National-Drug-Code
- `NH` – US National Health Related Item Code
- `PI` – Customer's material number
- `SK` – Stock keeping unit
- `UA` – UPC Case Code (2-5-5)
- `UJ` - PackageUPC
- `UI` – UPC Consumer Package Code (1-5-5)
- `UK` – GTIN14 identifier
- `UP` – EAN/UPC Universal Item Number/GTIN12
- `UX` – Universal product number
- `VC` – Vendor (Supplier) material number
- `VN` – Supplier material number.
 
 

 

   UP         LIN09  \[0…1\]  
  1/80   Product/service identifier value as qualifier by LIN08.   000025417895        CTP 0…25  - Pricing information segment in LIN-CTP, optional Pricing information for product. -         CTP01 0...1 2/2 Class of Trade Code.  DI         CTP02 0...1 3/3 Pricing type for Price Authorization catalog.

(missing or bad snippet)           CTP03 0...1 1/17 Price per unit of product or service. 21.20         CTP04 0...1 1/15 Pricing type quantity in numeric. 12         CTP05 0...1 - - -           CTP05.1 1...1 2/2 Unit of measure used for pricing at the price conditions line item details level.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif).Valid values ](#)- `02` – Statute Mile
- `4G` – Microliter
- `AM` – Ampoule
- `AV` – Capsule
- `BD` – Bundle
- `BG` – Bag
- `BO` – Bottle
- `BX` – Box
- `C3` – Centiliter
- `CA` – Case
- `CC` – Cubic Centimeter
- `CF` – Cubic Feet
- `CG` – Card, Blister
- `CI` – Cubic Inches
- `CL` – Cylinder
- `CM` – Centimeter
- `CN` – Can
- `CP` – Crate
- `CQ` – Cartridge
- `CR` – Cubic Meters
- `CT` – Carton
- `DA` – Day
- `DI` – Dispenser
- `DK` – Kilometers
- `DL` – Deciliter
- `DM` – Decimeter
- `DR` – Drum
- `DS` – Display
- `DZ` – Dozen
- `EA` – Each
- `FO` – Fluid Ounce
- `FT` – Foot
- `GA` – Gallon
- `GL` – Gram/liter
- `GR` – Gram
- `GS` – Gross
- `H4` – Hectoliter
- `HF` – Hundred Feet
- `HR` – Hours
- `IN` – Inch
- `K6` – Kiloliters
- `KG` – Kilogram
- `KT` – Kit
- `LB` – Pounds
- `LF` – Linear Foot
- `LO` – Lot (unit of procurement)
- `LT` – Liter
- `LY` – Linear Yard
- `MC` – Microgram
- `ME` – Milligram
- `ML` – Milliliter
- `MM` – Millimeter
- `MO` – Months
- `MR` – Meter
- `OZ` – Ounces
- `PC` – Piece
- `PF` – Pallet
- `PK` – Package
- `PR` – Pair
- `PT` – Pint
- `QT` – Quart
- `RL` – Roll
- `SC` – Square Centimeter
- `SF` – Square Foot
- `SH` – Sheet
- `SI` – Square Inch
- `SM` – Square Meter
- `ST` – Set
- `SY` – Square Yard
- `T3` – Thousand Pieces
- `TB` – Tube
- `TH` – Thousand
- `TY` – Tray
- `U2` – Tablet
- `UM` – Million
- `UN` – Unit
- `V2` – Pouch
- `VI` – Vial
- `WK` – Week
- `YD` – Yard
- `YR` – Years
 
 

 

  UN       AMT 0...10 - Monetary amount.           AMT01 1...1 1/3 Qualifier code defining amount for.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `1` - LINEITEMTOTAL
- `8`- TOTALDISCOUNT
- `A` - ADJUSTEDCHARGEBACK
- `AD` - ADJUSTMENT
- `BAP` - TOTALDUE
- `CC` - CHARGEBACKCLAIM
- `CE` - SUMMARY
- `CH` - CHANGE
- `CM` - CLAIMANTREQUESTEDTOTAL
- `CQ` - NETCLAIM
- `F7` - SALESTAX
- `NA` - NETADJUSTMENT
- `PB` - TOTAL
- `S` - SUBMITTEDCHARGEBACK
- `T` - TAX
- `TK` - CONTRACT
- `TP` - TOTALPAYMENT
- `TS` - TOTALSALES
- `TT` - TOTALTRANSACTION
- `Z3` - ITEMDISCREPANCYUNITCOST
 
 

 

            AMT02 1...1 1/18 Monetary amount.           AMT03 0...1 1/1 Credit or debit flag code indicating whether the amount is a credit or debit.

Valid values:

- `C` - Credit
- `D` - Debit
 
          N9 0...\* - Extended reference information segment.           N901 1...1 2/3 Reference identification qualifier. Specifies the type of identifier recorded.

 Valid values:

- `IA` - Internal vendor identifier
- `LT` - Lot number
- `VR`- Vendor identifier
 
            N902 0...1 1/80 Reference identifier as specified by the reference identification qualifier in N901. Currently only the internal vendor and vendor identifier are supported.          PO4  \[0…1\]  
  -   Specifies physical qualities, packaging, weights, and dimensions relating for the product.   -         PO401 \[0…1\]  
  1/6   The number of inner containers, or number of eaches if there are no inner containers, per outer container.   12       ZA  \[1…\*\]  
  -   **Required.**  Product activity reporting. Provides activity details for the current product being reported.   -           ZA01  \[1…1\]  
  2/2   **Required.**  Code identifying activity details for the product being reported.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values: ](#)1. `AA` - STOLEN
2. `AB` - SHIPPED
3. `BS` - BAILMENTSALE
4. `BT` - SEASONAL
5. `DG` - DAMAGED
6. `HL` - ONHOLD
7. `LS`- UNFULFILLEDSALES
8. `MS` - MILITARYSALES
9. `OF` - OFFPREMISES
10. `OH` - RETURNEDTOMANUFACTURER
11. `OP` - ONPREMISESSALES
12. `OQ` - PLANNEDORDER
13. `PA` - PRODUCTIONADJUSTMENT
14. `PO` - REORDERPOINT
15. `Q1` - NETSOLD
16. `Q2` - RETURNEDTODISTRIBUTOR
17. `Q3` - DEFECTIVERETURNS
18. `Q4` - ORDERED
19. `QA`- UNRESTRICTED
20. `QB` - BEGINNINGBALANCE
21. `QC` - COMMITTED
22. `QD` - ADDITIONALDEMAND
23. `QE` - ENDINGBALANCE
24. `QF` - INBOND
25. `QH` - MORGUEINVENTORY
26. `QI` - INTRANSIT
27. `QK` - NOTLISTED
28. `QL` - MINIMUMINVENTORY
29. `QM` - MAXIMUMINVENTORY
30. `QN` - PLANNEDINVENTORY
31. `QO` - OUTOFSTOCK
32. `QP` - ONORDERNOTRECEIVED
33. `QR` - RECEIVED
34. `QS` - TOTALSOLD
35. `QT` - ADJUSTMENT
36. `QU` - RETURNEDBYCONSUMER
37. `QW` - TOTALWITHDRAWN
38. `QX` - REPLENISHMENTOVERRIDE
39. `QZ` - TRANSFERRED
40. `RE` - RETAILSALES
41. `RQ` - TOTALRETURNED
42. `TS` - TOTALSALES
43. `WQ` - WHOLESALE
 

 

   HL           ZA02  \[0…1\]  
  1/15   Quantity of product Conditionally Required - At least one quantity must be present in either ZA02 or SDQ segment.   25.00           ZA03  \[0…1\]  
  2/2   Unit of measure used for pricing.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `02` – Statute Mile
- `4G` – Microliter
- `AM` – Ampoule
- `AV` – Capsule
- `BD` – Bundle
- `BG` – Bag
- `BO` – Bottle
- `BX` – Box
- `C3` – Centiliter
- `C8` – Cubic decimeters
- `CA` – Case
- `CC` – Cubic Centimeter
- `CF` – Cubic Feet
- `CG` – Card Blister
- `CH` – Container
- `CI` – Cubic Inches
- `CL` – Cylinder
- `CM` – Centimeter
- `CN` – Can
- `CP` – Crate
- `CQ` – Cartridge
- `CR` – Cubic Meters
- `CT` – Carton
- `DA` – Day
- `DI` – Dispenser
- `DK` – Kilometers
- `DL` – Deciliter
- `DM` – Decimeter
- `DR` – Drum
- `DS` – Display
- `DZ` – Dozen
- `EA` – Each
- `FO` – US Fluid Ounce
- `FT` – Foot
- `GA` – US Gallon
- `GL` – Gram/Liter
- `GR` – Gram
- `GS` – Gross
- `H4` – Hectoliter
- `HF` – Hundred Feet
- `HR` – Hours
- `IN` – Inch
- `K6` – Kiloliters
- `KG` – Kilogram
- `KT` – Kit
- `LB` – US Pound
- `LF` – Linear Foot
- `LO` – Lot (unit of procurement)
- `LT` – Liter
- `LY` – Linear Yard
- `MC` – Microgram
- `ME` – Milligram
- `ML` – Milliliter
- `MM` – Millimeter
- `MO` – Months
- `MQ` – Cubic millimeter
- `MR` – Meter
- `OZ` – Ounce
- `P1` – Percent
- `PC` – Piece
- `PF` – Pallet
- `PK` – Pack (Only supported Outbound)
- `PK` – Package
- `PR` – Pair
- `PT` – Pint
- `QT` – Quart
- `RL` – Roll
- `SC` – Square Centimeter
- `SF` – Square Foot
- `SH` – Sheet
- `SI` – Square Inch
- `SM` – Square Meter
- `SP` – Self Package
- `ST` – Set
- `SY` – Square Yard
- `SZ` – Syringe
- `T3` – Thousand Pieces
- `TB` – Tube
- `TH` – Thousands
- `TN` – Tonne
- `TS` – Thousands
- `TY` – Tray
- `U2` – Tablet
- `UM` – Million
- `UN` – Unit
- `US` – Dosage Form
- `V2` – Pouch
- `VI` – Vial
- `WK` – Week
- `YD` – Yard
- `YR` – Years
 
 

 

If ZA02 populated, then ZA03 is required.

   EA           ZA04  \[0…1\]  
  3/3   Date type for date recorded in product activity details.

Valid values:

- `002` - DELIVERYREQUESTED
- `006` - EFFECTIVE
- `007` - SOLD
 
If ZA05 populated, then ZA04 is required.

   002           ZA05  \[0…1\]  
  8/8   Date recorded in product activity details. If ZA04 populated, then ZA05 is required.   20241020           ZA06  \[0…1\]  
  2/3   Referenced document identification qualifier. Mapping purchase order number. Valid value is `PO` - PURCHASEORDER

If ZA07 populated, then ZA06 is required.

   PO           ZA07  \[0…1\]  
  1/80   Referenced document identifier value.

Purchase order number. If ZA06 populated, then ZA07 is required.

   7065172002        CTP 0…25  - Pricing information segment in LIN-ZA-CTP, optional

Pricing information for product.

            CTP01 0...1 2/2 Class of Trade Code.           CTP02 0...1 3/3 Pricing type for price authorization catalog.

(missing or bad snippet)           CTP03 0...1 1/17 Price per unit of product or service.           CTP04 0...1 1/15 Pricing type quantity in numeric.           CTP05 0...1 - - -           CTP05.1 1...1 2/2 Unit of measure used for pricing at the price conditions line item details level.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif).Valid values ](#)- `02` – Statute Mile
- `4G` – Microliter
- `AM` – Ampoule
- `AV` – Capsule
- `BD` – Bundle
- `BG` – Bag
- `BO` – Bottle
- `BX` – Box
- `C3` – Centiliter
- `CA` – Case
- `CC` – Cubic Centimeter
- `CF` – Cubic Feet
- `CG` – Card, Blister
- `CI` – Cubic Inches
- `CL` – Cylinder
- `CM` – Centimeter
- `CN` – Can
- `CP` – Crate
- `CQ` – Cartridge
- `CR` – Cubic Meters
- `CT` – Carton
- `DA` – Day
- `DI` – Dispenser
- `DK` – Kilometers
- `DL` – Deciliter
- `DM` – Decimeter
- `DR` – Drum
- `DS` – Display
- `DZ` – Dozen
- `EA` – Each
- `FO` – Fluid Ounce
- `FT` – Foot
- `GA` – Gallon
- `GL` – Gram/liter
- `GR` – Gram
- `GS` – Gross
- `H4` – Hectoliter
- `HF` – Hundred Feet
- `HR` – Hours
- `IN` – Inch
- `K6` – Kiloliters
- `KG` – Kilogram
- `KT` – Kit
- `LB` – Pounds
- `LF` – Linear Foot
- `LO` – Lot (unit of procurement)
- `LT` – Liter
- `LY` – Linear Yard
- `MC` – Microgram
- `ME` – Milligram
- `ML` – Milliliter
- `MM` – Millimeter
- `MO` – Months
- `MR` – Meter
- `OZ` – Ounces
- `PC` – Piece
- `PF` – Pallet
- `PK` – Package
- `PR` – Pair
- `PT` – Pint
- `QT` – Quart
- `RL` – Roll
- `SC` – Square Centimeter
- `SF` – Square Foot
- `SH` – Sheet
- `SI` – Square Inch
- `SM` – Square Meter
- `ST` – Set
- `SY` – Square Yard
- `T3` – Thousand Pieces
- `TB` – Tube
- `TH` – Thousand
- `TY` – Tray
- `U2` – Tablet
- `UM` – Million
- `UN` – Unit
- `V2` – Pouch
- `VI` – Vial
- `WK` – Week
- `YD` – Yard
- `YR` – Years
 
 

 

  UN       SDQ  \[0…\*\]  
  -   SDQ: Destination quantity segment.

Specifies location destination for product and quantity to be shipped to that location. Conditionally Required - At least one quantity must be present in either ZA02 or SDQ segment.

   -           SDQ01  \[1…1\]  
  2/2   **Required.**  Unit of measure for SDQ segment quantity. If SDQ segment populated, then SDQ01 is required.

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values](#)- `02` – Statute Mile
- `4G` – Microliter
- `AM` – Ampoule
- `AV` – Capsule
- `BD` – Bundle
- `BG` – Bag
- `BO` – Bottle
- `BX` – Box
- `C3` – Centiliter
- `C8` – Cubic decimeters
- `CA` – Case
- `CC` – Cubic Centimeter
- `CF` – Cubic Feet
- `CG` – Card Blister
- `CH` – Container
- `CI` – Cubic Inches
- `CL` – Cylinder
- `CM` – Centimeter
- `CN` – Can
- `CP` – Crate
- `CQ` – Cartridge
- `CR` – Cubic Meters
- `CT` – Carton
- `DA` – Day
- `DI` – Dispenser
- `DK` – Kilometers
- `DL` – Deciliter
- `DM` – Decimeter
- `DR` – Drum
- `DS` – Display
- `DZ` – Dozen
- `EA` – Each
- `FO` – US Fluid Ounce
- `FT` – Foot
- `GA` – US Gallon
- `GL` – Gram/Liter
- `GR` – Gram
- `GS` – Gross
- `H4` – Hectoliter
- `HF` – Hundred Feet
- `HR` – Hours
- `IN` – Inch
- `K6` – Kiloliters
- `KG` – Kilogram
- `KT` – Kit
- `LB` – US Pound
- `LF` – Linear Foot
- `LO` – Lot (unit of procurement)
- `LT` – Liter
- `LY` – Linear Yard
- `MC` – Microgram
- `ME` – Milligram
- `ML` – Milliliter
- `MM` – Millimeter
- `MO` – Months
- `MQ` – Cubic millimeter
- `MR` – Meter
- `OZ` – Ounce
- `P1` – Percent
- `PC` – Piece
- `PF` – Pallet
- `PK` – Pack (Only supported Outbound)
- `PK` – Package
- `PR` – Pair
- `PT` – Pint
- `QT` – Quart
- `RL` – Roll
- `SC` – Square Centimeter
- `SF` – Square Foot
- `SH` – Sheet
- `SI` – Square Inch
- `SM` – Square Meter
- `SP` – Self Package
- `ST` – Set
- `SY` – Square Yard
- `SZ` – Syringe
- `T3` – Thousand Pieces
- `TB` – Tube
- `TH` – Thousands
- `TN` – Tonne
- `TS` – Thousands
- `TY` – Tray
- `U2` – Tablet
- `UM` – Million
- `UN` – Unit
- `US` – Dosage Form
- `V2` – Pouch
- `VI` – Vial
- `WK` – Week
- `YD` – Yard
- `YR` – Years
 
 

 

   EA           SDQ02  \[0…1\]  
  1/2   Location identification code qualifer. If SDQ Segment populated, the SDQ02 is required.

Valid values:

- `1` - DUNS
- `2` - SCAC
- `9` - DUNS+4
- `11` - Drug Enforcement Agency registration number
- `21` - Health Industry Number
- `91` - Company identifier
- `92` - Company location identifier
- `UL` - Global Location Number
- `PI` - US\_340B\_ID
- `PP` - Pharmacy\_Processor\_Number
 
   92           SDQ03  \[1…1\]  
  2/80   **Required.**  Location identification code value. If SDQ Segment populated, the SDQ03 is required.   000258745           SDQ04  \[1…1\]  
  1/15   **Required.**  Quantity if SDQ segment populated, then SDQ05 is required.   1000           SDQ05  \[0…1\]  
  2/80   Location identification code value.   000258746           SDQ06  \[0…1\]  
  1/15   Quantity.   500           SDQ07  \[0…1\]  
  2/80   Location identification code value.   000258747           SDQ08  \[0…1\]  
  1/15   Quantity.   750           SDQ09  \[0…1\]  
  2/80   Location identification code value.   000258748           SDQ10  \[0…1\]  
  1/15   Quantity .   800           SDQ11  \[0…1\]  
  2/80   Location identification code value.   000258749           SDQ12  \[0…1\]  
  1/15   Quantity   690           SDQ13  \[0…1\]  
  2/80   Location identification code value.   000258750           SDQ14  \[0…1\]  
  1/15   Quantity.   450           SDQ15  \[0…1\]  
  2/80   Location identification code value.   000258751           SDQ16  \[0…1\]  
  1/15   Quantity.   825           SDQ17  \[0…1\]  
  2/80   Location identification code value.   000258752           SDQ18  \[0…1\]  
  1/15   Quantity.   825           SDQ19  \[0…1\]  
  2/80   Location identification code value.   000258753           SDQ20  \[0…1\]  
  1/15   Quantity.   675           SDQ21  \[0…1\]  
  2/80   Location identification code value.   000258754           SDQ22  \[0…1\]  
  1/15   Quantity.   380       CTT  \[1…1\]  
  -   **Required.**  Transaction totals segment.   -        CTT01 \[1…1\]  
  1/6   **Required.**  Total number of line items. Count of LIN segments.   12     SE  \[1…1\]  
  -   **Required.**  ST … SE transaction set trailer envelope. Child of GS group. Only one ST transaction expected.   -       SE01  \[1…1\]  
  1/10   **Required.**  Total count of segments in ST … SE transaction set including ST and SE segments.   10       SE02  \[1…1\]  
  4/9   **Required.**  Transaction set control number.   0001     GE  \[1…1\]  
  -   **Required.**  GS … GE functional group trailer envelope. Child of ISA interchange. Only one GS group expected.   -       GE01  \[1…1\]  
  1/6   **Required.**  Number of transaction sets in functional group.   5       GE02  \[1…1\]  
  1/9   **Required.**  Functional group control number.   619827     IEA  \[1…1\]  
  -   **Required.**  ISA … IEA interchange control trailer envelope. Only one interchange expected per transmission.   -       IEA01  \[1…1\]  
  1/5   **Required.**  Number of functional groups in interchange.   1       IEA02  \[1…1\]  
  9/9   **Required.**  Interchange control number.   0000000000619827     

 

[![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Example](#)```xml
ISA*00*          *00*          *07*7777776067344  *01*888888404358877*250828*1542*^*00501*000619827*0*P*:~
GS*PD*2222224043588*TRACELINK*20240821*120546*619827*X*005010~
ST*852*0001~
XQ*G*20240820*20250820*ProdAct12121~
XPO*5505869746*5505869950*1*0673452050~
XPO*5505869756*5505869951*9*0673452050~
XPO*5505869766*5505869952*11*0673452050~
XPO*5505869776*5505869953*21*0673452050~
XPO*5505869786*5505869954*91*0673452050~
XPO*5505869796*5505869955*92*0673452050~
XPO*5505869706*5505869956*UL*0673452050~
N9*IA*6878425871~
N9*VR*6878425872~
N1*RL*Reporting_BusinessName*1*8568745~
N3*RL_address1*RL_address2~
N4*RL_City*CA*RL_Postal*US~
N1*SU*Supplier_BusinessName*9*8568745~
N3*SU_address1*SU_address2~
N4*SU_City*CA*SU_Postal*US~
N1*VN*Supplier_BusinessName*9*8568745~
N3*VN_address1*VN_address2~
N4*VN_City*CA*VN_Postal*US~
N1*SF*ShipFrom_BusinessName*11*8568745~
N3*SF_address1*SF_address2~
N4*SF_City*CA*SF_Postal*US~
N1*BY*Buyer_BusinessName*21*8568745~
N3*BY_address1*BY_address2~
N4*BY_City*CA*BY_Postal*US~
N1*ST*ShipTo_BusinessName*91*8568745~
N3*ST_address1*ST_address2~
N4*ST_City*CA*ST_Postal*US~
N1*DB*DistBranch_BusinessName*92*8568745~
N3*DB_address1*DB_address2~
N4*DB_City*CA*DB_Postal*US~
N1*DS*DistBuss_BusinessName*UL*8568745~
N3*DS_address1*DS_address2~
N4*DS_City*CA*DS_Postal*US~
LIN*000010*PI*100021*BP*100022*EN*100023*FV*100024~
CTP*DI*CON*21.20*12*UN~
CTP*DI*SPC*31.20*10*EA~
PO4*100~
N9*LT*Lot1**20251112~
N9*VR*1111**20241112~
AMT*1*275.36*C~
AMT*NA*375.36*D~
ZA*BS*25.00*CS*002*20240820*PO*7065172002~
CTP*DI*CON*21.20*12*UN~
CTP*DI*UCP*20*10*EA~
SDQ*CA*1*000258745*1000*000258746*500*000258747*600*000258748*700*000258749*800*000258750*900*000258751*400*000258752*300*000258753*200*000258754*100~
SDQ*TY*9*000258755*1000*000258766*500*000258777*600*000258788*700*000258799~
ZA*AA*25.00*BO*007*20240822*ZZ*123344~
CTP*DI*CON*21.20*12*UN~
CTP*DI*UCP*20*10*EA~
SDQ*CA*1*000258745*1000*000258746*500*000258747*600*000258748*700*000258749*800*000258750*900*000258751*400*000258752*300*000258753*200*000258754*100~
SDQ*TY*9*000258755*1000*000258766*500*000258777*600*000258788*700*000258799~
ZA*AB*35.00*BX*006*20240820*ZZ*7065172003~
SDQ*PK*11*000258745*1000*000258746*500*000258747*600*000258748*700*000258749*800*000258750*900*000258751*400*000258752*300*000258753*200*000258754*100~
SDQ*DZ*21*000258755*1000*000258766*500*000258777*600*000258788*700*000258799~
ZA*BS*45.00*UN*007*20240820*PO*7065172004~
SDQ*CA*91*000258745*1000*000258746*500*000258747*600*000258748*700*000258749*800*000258750*900*000258751*400*000258752*300*000258753*200*000258754*100~
SDQ*PC*92*000258755*1000*000258766*500*000258777*600*000258788*700*000258799~
LIN*000020*IN*100031*SK*100032*VC*100033*UP*100034~
CTP*DI*SPC*31.20*10*EA~
PO4*200~
N9*LT*Lot1~
N9*VR*1111~
AMT*1*275.36*C~
AMT*NA*375.36*D~
ZA*BT*25.00*CS*002*20240820*ZZ*7065172102~
CTP*DI*CON*21.20*12*UN~
SDQ*CA*1*000258745*1000*000258746*500*000258747*600*000258748*700*000258749*800*000258750*900*000258751*400*000258752*300*000258753*200*000258754*100~
SDQ*CP*9*000258755*1000*000258766*500*000258777*600*000258788*700*000258799~
ZA*DG*35.00*C3*006*20240820*PO*7065172103~
SDQ*PK*11*000258745*1000*000258746*500*000258747*600*000258748*700*000258749*800*000258750*900*000258751*400*000258752*300*000258753*200*000258754*100~
SDQ*T3*21*000258755*1000*000258766*500*000258777*600*000258788*700*000258799~
ZA*HL*45.00*CA*007*20240820*PO*7065172104~
SDQ*EA*91*000258745*1000*000258746*500*000258747*600*000258748*700*000258749*800*000258750*900*000258751*400*000258752*300*000258753*200*000258754*100~
SDQ*DS*92*000258755*1000*000258766*500*000258777*600*000258788*700*000258799~
LIN*000030*UK*100041*MG*100042*MF*100043*N4*100044~
CTP*DI*SPC*31.20*10*EA~
CTP*DI*CON*21.20*12*UN~
PO4*300~
ZA*LS*25.00*GR*002*20240820*PO*7065172202~
CTP*DI*CON*21.20*12*UN~
SDQ*PK*UL*000258745*1000*000258746*500*000258747*600*000258748*700*000258749*800*000258750*900*000258751*400*000258752*300*000258753*200*000258754*100~
SDQ*TY*1*000258755*1000*000258766*500*000258777*600*000258788*700*000258799~
ZA*MS*35.00*GS*006*20240820*PO*7065172003~
SDQ*PK*1*000258745*1000*000258746*500*000258747*600*000258748*700*000258749*800*000258750*900*000258751*400*000258752*300*000258753*200*000258754*100~
SDQ*EA*9*000258755*1000*000258766*500*000258777*600*000258788*700*000258799~
LIN*000040*N5*100051*N6*100052*NH*100053~
CTP*DI*SPC*31.20*10*EA~
PO4*400~
ZA*OF*25.00*PF*002*20240820*PO*7065172302~
CTP*DI*CON*21.20*12*UN~
SDQ*UN*11*000258745*1000*000258746*500*000258747*600*000258748*700*000258749*800*000258750*900*000258751*400*000258752*300*000258753*200*000258754*100~
SDQ*CT*UL*000258755*1000*000258766*500*000258777*600*000258788*700*000258799~
CTT*4~
SE*75*s131~
GE*132*133~
IEA*134*135111111~
```

 

 

 

 

 ![](/sites/default/files/tech_comms/mpl/Content/Resources/Images/global_images/note_tip_24x24.png) Review TraceLink's [API: Terms of Use](https://www.tracelink.com/legal-and-trust/api-terms-of-use)



 

 

 

 

#### Table of contents

 

 

 

 

 

 



 

##### Related Content

 

 [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-idoc) 

#####  Forecast plan (IDoc) 

 Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record. 

 

 [View More](/resources/tracelink-university/forecast-plan-idoc) 

 

 [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-x12) 

#####  Forecast plan (X12) 

 Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record. 

 

 [View More](/resources/tracelink-university/forecast-plan-x12) 

 

 [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-response-idoc) 

#####  Forecast plan response (IDoc) 

 Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with downstream supply chain Partners without giving these Partners access to their serialization system of record. 

 

 [View More](/resources/tracelink-university/forecast-plan-response-idoc)