Type = API Reference,; Topic = Multienterprise Information Network Tower (MINT),;Persona = TraceLink Administrator, User,; Orchestration = Manufacturing, Logistics, Commerce,; Function = Supply Chain, IT, Procurement,
Product activities APIs
The product activities report is routinely distributed to trading partners, suppliers, or upstream supply chain partners. The product activities report is issued either at set intervals or in response to significant deviations in inventory levels outside the normal schedule. The report's data enables trading partners to assess inventory levels and plan for replenishment needs accurately. By analyzing product activities data, trading partners can forecast necessary shipping quantities or propose optimal replenishment quantities for distribution centers, warehouses, or retail locations.
Recipients of this transaction set are responsible for maintaining inventory and product movement records specific to each trading partner. This record-keeping process facilitates informed replenishment calculations, leveraging data provided by distributors, warehouses, or retailers. Such information allows trading partners to efficiently manage stock levels and fulfill demand while avoiding stock outs or overstock situations.
A product activities report primarily tracks two factors: current inventory levels and product sales data (often from Point of Sale systems).
Product Activities (IDoc)
The product activities IDoc message sends transfer of stock and sales data information between SAP systems or none SAP systems via an IDoc basic type message.
Contact your TraceLink Services representative for more information about integrating with this message.
- Message Type: MPC_PRODUCT_ACTIVITY
- IDoc Format: PROACT.PROACT01
- Transform Names:
B2B_IDoc_PROACT_PROACT01_ProductActivity_OB_V1
Product Activities (X12)
The product activities X12 message comprises of essential data elements that provide valuable insights into product activities.
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_V1

Input Element | Occurs | Length | Description | Example | |||
---|---|---|---|---|---|---|---|
ISA | - | Required. ISA interchange envelope. | - | ||||
ISA01 | 1/2 | Required. Qualifier for authorization control number in ISA02. | 00 | ||||
ISA02 | 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/2 | Required. Qualifier for security information in ISA04. | 00 | ||||
ISA04 | 1/10 | Required. Identifies security information about the interchange sender or data. | - | ||||
ISA05 | 1/2 |
Required. Interchange sender partner ID qualifier. Valid values:
|
07 | ||||
ISA06 | 1/15 |
Required. Interchange sender identification mapping to:
|
7777776067344 | ||||
ISA07 | 1/2 |
Required. Interchange receiver partner ID qualifier. Valid values:
|
01 | ||||
ISA08 | 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 | 6/6 | Required. Interchange date in 6 char YYMMDD format. | 241020 | ||||
ISA10 | 4/4 | Required. Interchange time in 4 char HHMM format | 1420 | ||||
ISA11 | 1/1 |
Required. This value is dependent on X12 version.
|
^ | ||||
ISA12 | 5/5 | Required. Interchange control version number. This could be any X12 version. | 00501 | ||||
ISA13 | 1/9 | Required. Interchange Control Number mapping to file control header. | 0000000000619827 | ||||
ISA14 | 1/1 |
Required. Interchange level acknowledgment requested. Valid values:
|
0 | ||||
ISA15 | 1/1 |
Required. Indicates whether the interchange is for production, test, or information purposes. Valid values:
|
P | ||||
ISA16 | 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. | > | ||||
GS | - | Required. GS group functional envelope. Child of ISA. Only one GS group expected per interchange. | - | ||||
GS01 | 2/2 |
Required.
GS group function code. Valid value is PD - Product Activity data X12 852
|
PD | ||||
GS02 | 2/15 | Required. Application Sender's Code. | 2222224043588 | ||||
GS03 | 2/15 | Required. Application Receiver's Code. | TRACELINK | ||||
GS04 | 8/8 | Required. Current date stamp in 8 char X12 date format YYYYMMDD. | 20241020 | ||||
GS05 | 4/8 | Required. Current time stamp in 6 char X12 time format HHMMSS. | 142000 | ||||
GS06 | 1/9 | Required. Group Control ID Number. | 619827 | ||||
GS07 | 1/2 |
Required. Responsible Agency Code. Valid values:
|
X | ||||
GS08 | 1/12 | Required. X12 message version code. This could be any X12 version. | 005010 | ||||
ST | - | Required. ST transaction set envelope. Child of GS group. Only one ST transaction expected. | - | ||||
ST01 | 3/3 | Required. Transaction set identifier code. | 852 | ||||
ST02 | 4/9 | Required. Transaction set ID number. Counter for each ST segment beginning with 1. | 0001 | ||||
XQ | - | Required. Product activity message begin segment. | - | ||||
XQ01 | 1/2 |
Required. Code identifying purpose of product activity transaction set. Valid Values:
|
G | ||||
XQ02 | 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 | 8/8 | Date. If present, this is the end date of a date range. | 20241120 | ||||
XQ04 | 0/80 | Reference Identification, a unique report identifier sent by the sender. | PA123 | ||||
XPO | - | Preassigned purchase order number. Suggested PO numbers for a VMI relationship will be sent in this segment. | - | ||||
XPO01 | 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 | 1/22 | The last purchase order number when a range of suggested purchase order numbers is sent. | 5505869950 | ||||
XPO03 | 1/2 |
Company identifier code qualifier. If XPO04 populated, then XPO03 is required. Valid values:
|
91 | ||||
XPO04 | 2/80 | Company identifier value for business partner If XPO03 populated, then XPO03 is required. | 0673452050 | ||||
N9 | - | Extended reference information segment. | - | ||||
N901 | 2/3 |
Required. Reference identification qualifier. Specifies the type of identifier recorded. Valid values:
If N9 Segment populated, then N901 is required. |
IA | ||||
N902 | 1/80 | Reference identifier as specified by the reference identification qualifier in N901. If N901 is populated then N902 is required. | 6878425871 | ||||
N1 | - | N1 name segment loop for the reporting location identifier and address information. | - | ||||
N101 | 2/3 |
Required. Entity qualifier for the reporting location identifier and address information. Valid value:
If N1 segment populated, then N101 is required. |
RL | ||||
N102 | 1/60 | Name | Contract Service Provider | ||||
N103 | 1/2 |
Identifier code qualifier. If N104 populated, then N103 is required. Valid values:
|
UL | ||||
N104 | 2/80 | Party identifier as qualified by N103 mapping to companyIdentifierValue. If N103 populated, then N104 is required. | 8568745 | ||||
N3 | - | N3: Address: Child of supplier party N1 name segment. | - | ||||
N301 | 1/55 | Required. Street address 1. | 555 Neelan Road | ||||
N302 | 1/55 | Street address 2. | Suite 123 | ||||
N4 | - | N4: Geographic Location. Child of supplier party N1 name segment. | - | ||||
N401 | 2/30 | City name. | Sacramento | ||||
N402 | 2/2 | State or province code. Code (Standard state/province) as defined by appropriate government agency.. | CA | ||||
N403 | 3/15 | Postal code. Code defining international postal zone code excluding punctuation and blanks. | 95833 | ||||
N404 | 2/3 | Country code | US | ||||
LIN | - | Required. Baseline item data for product activity report. | - | ||||
LIN01 | 1/20 | Line item number. | 000010 | ||||
LIN02 | 2/2 |
Required. Product or service identifier qualifier. ![]()
|
BP | ||||
LIN03 | 1/80 | Required. Product/service identifier value as qualifier by LIN02. | 100021 | ||||
LIN04 | 2/2 |
Product or service identifier qualifier. If LIN05 populated, then LIN04 is required. ![]()
|
VN | ||||
LIN05 | 1/80 | Product/service identifier value as qualifier by LIN04. If LIN04 populated, then LIN05 is required. | 1000818 | ||||
LIN06 | 2/2 |
Product or service identifier qualifier. If LIN07 populated, then LIN06 is required. ![]()
|
UK | ||||
LIN07 | 1/80 | Product/service identifier value as qualifier by LIN06. If LIN06 populated, then LIN07 is required. | 00002541789536 | ||||
LIN08 | 2/2 |
Product/service identifier value as qualifier by LIN09. If LIN09 populated, then LIN08 is required. ![]()
|
UP | ||||
LIN09 | 1/80 | Product/service identifier value as qualifier by LIN08. If LIN08 populated, then LIN09 is required. | 000025417895 | ||||
PO4 | - | Specifies physical qualities, packaging, weights, and dimensions relating for the product. | - | ||||
PO401 | 1/6 | The number of inner containers, or number of eaches if there are no inner containers, per outer container. | 12 | ||||
ZA | - | Required. Product activity reporting. Provides activity details for the current product being reported. | - | ||||
ZA01 | 2/2 |
Required. Code identifying activity details for the product being reported. ![]() AA - STOLEN
OQ - PLANNEDORDER
PA - DEVIATION
QF - ADJUSTEDSERVICELEVEL QH - MORGUEINVENTORY
QU - RETURNEDBYCONSUMER QW - TOTALWITHDRAWN
|
HL | ||||
ZA02 | 1/15 | Quantity of product Conditionally Required - At least one quantity must be present in either ZA02 or SDQ segment. | 25.00 | ||||
ZA03 | 2/2 |
Unit of measure used for pricing. ![]()
If ZA02 populated, then ZA03 is required. |
EA | ||||
ZA04 | 3/3 |
Date type for date recorded in product activity details. Valid values:
If ZA05 populated, then ZA04 is required. |
002 | ||||
ZA05 | 8/8 | Date recorded in product activity details. If ZA04 populated, then ZA05 is required. | 20241020 | ||||
ZA06 | 2/3 |
Referenced document identification qualifier. Mapping purchase order number. Valid value is If ZA07 populated, then ZA06 is required. |
PO | ||||
ZA07 | 1/80 |
Referenced document identifier value. Purchase order number. If ZA06 populated, then ZA07 is required. |
7065172002 | ||||
SDQ | - |
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 | 2/2 |
Required. Unit of measure for SDQ segment quantity. If SDQ segment populated, then SDQ01 is required. ![]()
|
EA | ||||
SDQ02 | 1/2 |
Location identification code qualifer. If SDQ Segment populated, the SDQ02 is required. Valid values:
|
92 | ||||
SDQ03 | 2/80 | Required. Location identification code value. If SDQ Segment populated, the SDQ03 is required. | 000258745 | ||||
SDQ04 | 1/15 | Required. Quantity if SDQ segment populated, then SDQ05 is required. | 1000 | ||||
SDQ05 | 2/80 | Location identification code value. | 000258746 | ||||
SDQ06 | 1/15 | Quantity. | 500 | ||||
SDQ07 | 2/80 | Location identification code value. | 000258747 | ||||
SDQ08 | 1/15 | Quantity. | 750 | ||||
SDQ09 | 2/80 | Location identification code value. | 000258748 | ||||
SDQ10 | 1/15 | Quantity . | 800 | ||||
SDQ11 | 2/80 | Location identification code value. | 000258749 | ||||
SDQ12 | 1/15 | Quantity | 690 | ||||
SDQ13 | 2/80 | Location identification code value. | 000258750 | ||||
SDQ14 | 1/15 | Quantity. | 450 | ||||
SDQ15 | 2/80 | Location identification code value. | 000258751 | ||||
SDQ16 | 1/15 | Quantity. | 825 | ||||
SDQ17 | 2/80 | Location identification code value. | 000258752 | ||||
SDQ18 | 1/15 | Quantity. | 825 | ||||
SDQ19 | 2/80 | Location identification code value. | 000258753 | ||||
SDQ20 | 1/15 | Quantity. | 675 | ||||
SDQ21 | 2/80 | Location identification code value. | 000258754 | ||||
SDQ22 | 1/15 | Quantity. | 380 | ||||
CTT | - | Required. Transaction totals segment. | - | ||||
CTT01 | 1/6 | Required. Total number of line items. Count of LIN segments. | 12 | ||||
SE | - | Required. ST … SE transaction set trailer envelope. Child of GS group. Only one ST transaction expected. | - | ||||
SE01 | 1/10 | Required. Total count of segments in ST … SE transaction set including ST and SE segments. | 10 | ||||
SE02 | 4/9 | Required. Transaction set control number. | 0001 | ||||
GE | - | Required. GS … GE functional group trailer envelope. Child of ISA interchange. Only one GS group expected. | - | ||||
GE01 | 1/6 | Required. Number of transaction sets in functional group. | 5 | ||||
GE02 | 1/9 | Required. Functional group control number. | 619827 | ||||
IEA | - | Required. ISA … IEA interchange control trailer envelope. Only one interchange expected per transmission. | - | ||||
IEA01 | 1/5 | Required. Number of functional groups in interchange. | 1 | ||||
IEA02 | 9/9 | Required. Interchange control number. | 0000000000619827 |

ISA*00* *00* *07*7777776067344
*01*888888404358877*240821*1709*^*00501*000619827*0*P*:~
GS*PD*2222224043588*TRACELINK*20240821*120546*619827*X*005010~
ST*852*0001~
XQ*G*20240820*20250820*ProdAct123~
XPO*5505869746*5505869950*1*0673452050~
N9*IA*6878425871~
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*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*BP*100021*VC*100022*VN*100023*UJ*100024~
PO4*100~
ZA*AA*25.00*EA*002*20240820*PO*7065172002~
SDQ*CA*1*000258745*1000*000258746*500*000258747*600*000258748*700*000258749*800*
000258750*900*000258751*400*000258752*300*000258753*200*000258754*100~
CTT*4~
SE*75*s131~
GE*132*133~
IEA*134*135111111~
Tag end